While the Blackboard's Instructor Setup gets your initial course navigation link live, this guide walks you through the comprehensive, chronological lifecycle of managing your integration—from day-one roster syncs to deploying your grading structure.
Phase 1: Student roster setup
Ensure your student registry and course structure are correctly mirrored from Blackboard.
Roster sync
You do not need to manually invite students. Each time you launch Perusall from Blackboard, an automatic background sync occurs.
- Any student added to your Blackboard course is automatically added to your Perusall roster (found under the Students tab).
- Students who unenroll from your Blackboard course are automatically removed.
Group sync
If enabled by your admin, you can sync your Blackboard groups directly to Perusall to keep your student discussion sizes manageable. To access:
- Navigate to your Perusall course Settings > Grouping.
- Select either Fixed grouping for all course material, Assignment-based, or Library content-based grouping from the grouping methods.
- Then, scroll down to click Import Groups Import Groups from Blackboard to trigger a pop-up window allowing you access to your Blackboard group sets.
- Select one group set to apply to your Perusall course, and click Save Changes.
💡 Need help with group settings? For a comprehensive look at how discussion small-groups function, student sorting behaviors, and editing group sets, see the complete guide on How do groups work?
Phase 2: Select your grade sync options
Perusall offers three ways to pass grades back to Blackboard. We recommend choosing your approach before creating or linking assignments.
Strategy 1: Summary column sync (single column)
Best for instructors who want a clean, minimalist Blackboard gradebook. Perusall creates one single column in Blackboard that dynamically updates with the student's rolling score.
The settings:
- Navigate to Settings > Scoring > Basics, and select your summary column preference:
- Average Score: Sum of all individual assignment scores divided by the total number of assignments.
- Total Score: Cumulative sum of points across all assignments.
- Once complete, navigate to Settings > Scoring > LMS grade sync > Grade sync to LMS, select Automatically sync students' average or total scores back to the LMS, and click Save.
Strategy 2: Automatic column creation
Best for instructors who want Perusall to automatically create LMS assignment gradebook columns for every individual Perusall assignment. Any changes made to assignment deadlines or score ranges in Perusall are automatically reflected in your LMS course.
The settings:
- Navigate to Settings > Scoring > LMS grade sync.
- Under Grade sync to LMS, select Automatically sync individual assignment scores back to the LMS.
- In the new dropdown, LMS gradebook column management, select Perusall creates gradebook columns in LMS for each Perusall assignment automatically, and click Save.
Strategy 3: Deep linking (manual LMS assignment link creation)
Deep linking is the only way to create assignment-specific links in Blackboard (links that open directly to a specific Perusall assignment).
This workflow gives you precise control to embed assignments directly into Blackboard Modules. It also allows you to offer ungraded access to readings without creating unnecessary gradebook columns.
The settings:
Navigate to Settings > Scoring > LMS grade sync.
Under Grade sync to LMS, select Automatically (or manually) sync individual assignment scores back to the LMS, and click Save.
A new dropdown will appear titled LMS gradebook column management. Select Instructor creates deep links in LMS; no Perusall gradebook columns will appear in LMS until deep links have been created.
Phase 3: Assignment linking
1. Build your library
Before setting up assignments within Perusall, you must populate your course materials.
💡 Managing Materials: To learn more about uploading textbooks, multimedia resources, or organizing items into folders, see the comprehensive How do I manage my course library content? What materials can I use? documentation.
2. Setting up assignment links
Let’s get your LMS links ready for your students. Follow the quick steps below for your chosen gradebook setup.
If you chose summary column sync OR automatic column creation
The hands-off workflow: You do not need to create individual links in Blackboard.
Create your assignments inside Perusall.
-
In your blackboard course, students will click the Perusall link you created in Blackboard Instructor Set Up, and Perusall will pass their scores back to Blackboard as you release assignment scores in Perusall.
Reminder: One LMS gradebook column is auto-created for summary column sync, while automatic column creation adds a column for each Perusall assignment.
If you chose deep linking
You must create a specific "deep link" in Blackboard for every individual assignment you built in Perusall.
The graded workflow: You will manually construct individual links that map to a Blackboard gradebook column.
Blackboard Learn
- Create your assignments inside Perusall.
- In your Blackboard Learn course, navigate to a Content Area, ensure Edit mode is enabled, and click Build Content > Perusall Deep Link.
- In the next screen, select Perusall. A window will pop up that will allow you to select a Perusall assignment to link.
- Under Assignments, click on the dropdown to select an assignment.
- Ensure that Import grading information to LMS is enabled, and click Link to this assignment.
- Finally, open the assignment, and it will take you directly into the assignment.
Blackboard Ultra
- Create your assignments inside Perusall.
- In your Blackboard Ultra course, click + Add content > Content Market, and click on the Perusall link without a "+".
- In the next screen, select Perusall. A window will pop up that will allow you to select a Perusall assignment to link.
- Under Assignments, click on the dropdown to select an assignment.
- Ensure that Import grading information to LMS is enabled, and click Link to this assignment.
- Return to your Blackboard Ultra course page to open the assignment, and it will take you directly into the Perusall assignment.
The ungraded workflow: Use this pathway if you want to provide deep links directly to specific Perusall content or assignments but do not want to generate a gradebook column in Canvas.
Follow the instructions above, but at Step 3, ensure that Import grading information to LMS is disabled.
Troubleshooting & email white-listing
To ensure smooth communication and prevent missed grade sync notifications, please ensure your campus IT department whitelists the following email domains:
@perusall.com@mg.perusall.com
For technical failures regarding grade communication, please review the guide on How LTI 1.3 integration grade sync works.
Related to