Roster Sync
Each time you launch Perusall from Canvas, a roster sync is run in the background. Any students that have added to your LMS course will be added to your Perusall course roster (under the Students tab), and any that have unenrolled will be removed from the course.
Group Sync
If enabled by your Canvas Admin, to access Canvas group sync, navigate to your Perusall course Settings > Grouping, select Specify groups, and then click Import Groups from Canvas to trigger a pop-up window allowing you access to your Canvas group sets. Select one group set to apply to your Perusall course. If you make any changes to your grouping in Canvas, you will need to import groups from Canvas again to see those updates.
If you teach multiple sections of Canvas course, you may choose Import Sections from Canvas. Each section will act as its own Perusall group.
Grade Sync
If you would like to automatically sync the average of all Perusall assignments to a single gradebook column in Canvas, launch into Perusall, select Settings > Scoring > Grade sync to LMS > Automatically sync students' average scores to LMS, and then click Save changes.
If you would like to sync individual assignment scores to multiple columns in the Canvas gradebook, launch into Perusall, select Settings > Scoring > Grade sync to LMS > Automatically sync students' scores to LMS, and then click Save changes.
(For more info, see Grade sync in LTI 1.3.)
Troubleshooting Grade Sync
-
When a Perusall course is set to Perusall creates gradebook columns in LMS for each Perusall assignment automatically (under Settings > Scoring > LMS grade sync > LMS gradebook column management), this error generally stems from the automatically created assignments/gradebook columns being deleted in Canvas. This can usually be fixed by clicking Sync to LMS beneath the corresponding assignment in the Perusall gradebook to force Perusall to recreate the gradebook column.
Assignment link (deep link) creation
To create a deep link(assignment-specific link) to a Perusall assignment. First, navigate to Settings > Scoring > Grade Sync to LMS > LMS gradebook column management, set to Instructor creates deep links in LMS; no Perusall gradebook columns will appear in LMS until deep links have been created > Click Save Changes.
- Create a assignment in Perusall
- Navigate to the assignment creation page in Canvas and select External tool for Submission Type.
- Click Find and then click the blue magnifying glass next to Perusall.
- Perusall will present you with a list of assignments you have created in your Perusall course; select one of them to match the Canvas assignment with the corresponding Perusall assignment.
- Choose whether to import assignment instructions into LMS
- Click Link to this assignment to close the window, and click Select to close the content selection window.
- Finalize assignment settings and Save.
Open the link to verify that it leads to the proper assignment.
-
If you'd like to create deep links to your Perusall course library items or to assignment, but do not want to have a grade associated with them in your Canvas gradebook, follow these steps:
- Navigate to your Canvas Modules, and click "+" beside your desired Module.
- In the new window, select to Add External Tool, and click Perusall 1.3.*
- If you do not see Perusall 1.3, contact your Canvas admin, and ask them to ensure they've enabled Link Selection for Perusall 1.3 Developer Key Canvas Admin Setup
- Perusall will present you with a list of assignments you have created in your Perusall course, as well as your documents from your course library; select your desired item.
- Disable Import grading information into LMS.
- The URL should automatically fill with the following URL:
- The page name will be the name of your document/assignment
- Enable Load in a new tab.
- Click Add Item, and then publish it to make it accessible to your students.
After you've made deep links for your course, you can copy them to future courses.
Canvas Pages and Files
To import Canvas Pages and Files into Perusall, your LMS administrator will need to enable their Canvas API access for Perusall (if they choose to force scopes with the initial install).
- Once enabled, you can import a Page or document from Canvas by navigating to Course home > Library > Add content and then selecting Page from Canvas or Document from Canvas.
Similar to uploading documents from Google Drive and websites, Perusall imports a "snapshot" of the Canvas Page as it exists at the time of import. If you later change the Page in Canvas, that change won't be reflected in Perusall. (Similarly, you can delete the Page in Canvas without affecting the content in Perusall.)
Please whitelist messages coming from @perusall.com and @mg.perusall.com to ensure users are able to receive our emails.