Note: Encountering issues with our new integrations? You can reach out to support via this link.
To create and sync rosters with Canvas, first ensure that the Code.org Integration has been installed in your Canvas Learning Management System. This will require administrator privileges for your Canvas instance. If you do not wish to automatically sync rosters - follow the steps under the "Turn Off Automatic Roster Syncing" heading later in this guide.
Video Walkthrough (Opens in New Tab)
Adding the LMS Integration to your Canvas Course
Once installed, add the Code.org External Tool in your Canvas course by selecting "Launch Code.org" from the list of External Tools when adding a course item.
- "Load in a new tab" must be toggled on, the integration will not work in an iFrame
- The URL must stay "https://studio.code.org/lti/v1/sync_course" to sync your rosters
Click the plus icon to add content to a module
Select "External Tool" and "Launch Code.org" from the list (values will auto-populate)
Launching and Syncing Rosters
Once the Code.org LMS Integration has been added to your Course, click "Launch Code.org" to import and sync all of the sections (e.g. your class periods) associated with your course (e.g. "Computer Science Discoveries"), along with any students & teachers who are rostered in those sections.
Please note:
- You must be rostered as a teacher in each section that you wish to sync
- Your course must be published in order for the sync to work
If this is your first time launching from Canvas, you will have the option to link to your existing account, or create a new one.
Once you have created or linked an account, you will presented with a sync confirmation screen.
If your sections, section names, or rostered students & teachers change or update - launching the LMS integration again will also update those corresponding students and sections in Code.org.
If you changed the External Tool URL in the steps above, you can still manually perform this roster sync operation by navigating to the Manage Students panel for your section and clicking "Sync students and sections"
Turn Off Automatic Roster Syncing
If you prefer to manually manage your sections, and wish to only leverage the Single Sign-On functionality of the Code.org Canvas Integration, you can turn off the Roster Sync feature. This toggle only applies to sections created from Canvas, or Schoology, and will not affect any Google Classroom or Clever sections.
There are three ways to turn off automatic Roster Syncing for Canvas:
1. Change the 'URL' of the External Tool
Ex. Change the URL from "https://studio.code.org/lti/v1/sync_course" to "https://studio.code.org"
2. When a sync operation occurs, select the "Turn off Roster Sync" button on the sync confirmation screen
3. In your Code.org account settings, you may set your Roster Sync settings preference
Frequently Asked Questions
Does the Code.org Integration for Canvas create new Code.org accounts?
You have the option to create a new account for Canvas, or link to an existing Code.org account. Your new Canvas account will not overwrite your existing Code.org account, even if they share the same email.
My sections are not syncing!
There are a few reasons your sections may not be syncing. Please ensure that:
- Your course is published
- You are rostered as a teacher in Canvas on the section you are trying to sync
- The URL of your External Tool reads "https://studio.code.org/lti/v1/sync_course"
- Roster Syncing is enabled in your Account Settings
Why am a seeing a synced section that is the same name as my course name?
Code.org will automatically import any section in which you are rostered as a teacher, with the naming convention "<Course Name> : <Section Name>". New courses in Canvas, by default, are automatically created with a section that shares the name of its parent course. If you do not update the name of this default section, it will be automatically synced to Code.org during the roster sync operation.
I'm moving districts, will my account come with me?
While your new Code.org account is tied to the LMS environment in which it was created, if you launch from a new LMS environment you can once again link to your existing Code.org account on launch. Alternatively, you can add a personal login to your account to access it in the future.
I installed the Code.org integration multiple times, which one should I use?
Please ensure that your Canvas implementation only has one Code.org integration installed. When you click "Launch Code.org" - a new account is created for you that is tied to the integration from which you launch. If you click "Launch Code.org" on a new integration - a new account will again be created. At this time, merging these two accounts is not possible. You may of course, place the same Code.org integration across your courses as many times as desired.
Can I manage my own rosters without syncing?
Absolutely! Simply turn off the Roster Syncing feature with the instructions in the above article.
Can I sync my Code.org grades to Canvas?
Unfortunately this feature is not yet available.
I'm getting an error when I try to launch Code.org
Most launch errors are from the Code.org Integration not being installed correctly at the LMS level. Please work with your administrator to ensure the steps in this article are completed.
I'm getting a failed to load error on the Code.org iFrame
iFrame placements are not currently supported. Instead, please ensure your External Tool is configured to open in a new tab.
I need more help!
If your questions are not covered in the above article, please contact us via this link.