This guide describes how to add Vocareum to a Canvas course once your organization's root-level Canvas-to-Vocareum integration is already in place. It covers the four Canvas placements where Vocareum can appear, how to map a Canvas assignment to a Vocareum assignment so grades post back to the Canvas gradebook, and how to give students Course Navigation access to Vocareum without setting up grade passback.

Use this guide when you are ready to surface Vocareum inside a specific Canvas course, whether you need per-assignment grade passback or a single Course Navigation link to all assignments in Vocareum.

Before beginning, confirm the following:

Placements determine where Vocareum appears within Canvas for users. The JSON URL install pre-configures all four placements listed below.

Only the Assignment Selection placement supports automatic grade passback to the Canvas gradebook. The other placements are best suited to ungraded Vocareum content.

Adds Vocareum as an external tool that can be selected when creating or editing a Canvas assignment. This placement is required for any assignment that needs to send grades back to Canvas, since it is the only placement that supports automatic grade passback to the Canvas gradebook. For the full mapping procedure, refer to the "Mapping assignments for grade passback" section below.

Enables Vocareum content to be added as an item within a Canvas module. To add a Vocareum lab or course to a module, open Modules in Canvas, click the + button on the module, choose External Tool from the dropdown, and select Vocareum. The lab appears as a clickable link within the module.

Adds a button to the Content Editor toolbar in Canvas, available when creating or editing pages, assignments, discussion posts, and similar content. Selecting this button opens a Vocareum window where instructors can choose and embed a Vocareum lab into the content area, either as an iframe or in a new tab.

Adds a Vocareum link to the left-hand course navigation menu in Canvas, giving students direct access to their Vocareum course from anywhere within the Canvas course. This placement pairs well with the Show All Assignments option in Vocareum's LTI Settings, described in the "Enabling Vocareum Course Navigation without grade passback" section below.

If assignments are linked correctly between Canvas and Vocareum, the Canvas gradebook is automatically populated with grades from Vocareum assignments. Each Vocareum assignment must be mapped to a corresponding Canvas assignment via the Assignment Selection placement.

Follow these steps to map a Canvas assignment to its Vocareum counterpart.

If you do not need grade passback or a one-to-one mapping between Vocareum assignments and Canvas assignments, students can navigate through assignments directly inside Vocareum from the Canvas course navigation link.

Follow these steps to configure Course Navigation without grade passback.

Students will then be able to access every assignment from the Vocareum link in Canvas's course navigation, and no grades will be passed back from Vocareum to Canvas.