Note: Encountering issues with our new integrations? You can reach out to support via this link.
To create and sync rosters with Schoology, first ensure that the CodeAI Integration has been installed in your Schoology Learning Management System. This will require administrator privileges for your Schoology instance. If you do not wish to automatically sync rosters - follow the steps under "Turn Off Automatic Roster Syncing" later in this guide.
Video Walkthrough (Opens in New Tab)
Table of Contents
- Adding the LMS Integration to your Schoology Course
- Launching and Syncing Rosters
- Turn Off Automatic Roster Syncing
- Frequently Asked Questions
Adding the LMS Integration to your Schoology Course
Once installed, there are two options for placing the CodeAI Integration for Schoology into your course. The first, and easiest, is to leverage the default sidebar placement:
The second option is to insert CodeAI as a External Tool in the "Materials" section of your course.
Select "External Tool" from the pop-up.
Pick "CodeAI" in the Tool Provider drop-down menu.
Finally, name the External Tool. We recommend something like "Launch CodeAI". You may also edit the URL to point to a specific page on CodeAI if you wish the external tool to automatically log students in to that specified URL.
Please note, however, changing the URL away from its default setting will prevent the Roster Sync operation from happening when you click on this link (details in following section).
When complete, the External Tool will look something like this:
Clicking the tool will display the same iFrame as the sidebar placement:
Launching and Syncing Rosters
Once the CodeAI LMS Integration has been added to your course, click "Continue to CodeAI" to import and sync sections (e.g. class periods) associated with your course (e.g. "Computer Science Discoveries"), along with any students & teachers who are rostered in that section.
Please note, if your course has multiple sections, you must select the section you wish to sync from the drop-down menu above the iFrame:
You must also be rostered as a teacher in each section that you wish to sync.
If this is your first time launching from Schoology, 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 CodeAI.
If you changed the External Tool URL via the installation process described previously, you can still perform this sync operation from the sidebar, or within the CodeAI Manage Students panel, you may also click the "Sync students and sections" button to manually sync sections and students between Schoology and CodeAI.
This button behaves the same as the "Launch CodeAI" button, bringing in any changes that may have happened in your Schoology course (e.g. updated sections, changed rostering) to those corresponding sections on CodeAI.
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 CodeAI Schoology 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 Schoology:
1. Change the 'URL' of the External Tool in Schoology Materials
Ex. Change the URL 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 CodeAI account settings, you may set your Roster Sync settings preference
Frequently Asked Questions
Does the CodeAI Integration for Schoology create new CodeAI accounts?
You have the option to create a new account for Schoology, or link to an existing CodeAI account. Your new Schoology account will not overwrite your existing CodeAI 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 Schoology on the section you are trying to sync
- The URL of your External Tool is left on default, or reads "https://studio.code.org/lti/v1/sync_course"
- Roster Syncing is enabled in your CodeAI Account Settings
I'm moving districts, will my account come with me?
While your new CodeAI 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 CodeAI account on launch. Alternatively, you can add a personal login to your account to access it in the future.
I installed the CodeAI integration multiple times, which one should I use?
Please ensure that your Schoology implementation only has one CodeAI integration installed. When you click "Launch CodeAI" - any new account you create is tied to that integration. You may of course, place the same CodeAI 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 CodeAI grades to Schoology?
Unfortunately this feature is not yet available.
I need more help!
If your questions are not covered in the above article, please contact us via this link.