Canvas Integration Guide

exclamation-circle-solid.svg Before getting started

NOTE: Student licenses must be purchased to use the external tool.

Please share these system requirements with your Technology department:

Please consider:

  • Multiple internet filters and firewalls.
  • Different settings for wired and wireless technology devices.
  • Software on technology devices that act as an internet filter or firewall.

Things to consider before using the integration

  • Students are automatically registered through the integration.
    • Do not register students through
  • Grades will be visible in both and the Canvas gradebook.
    • The “Highest” scored grade will be passed back to the Canvas gradebook

How to use iCEV in Canvas by Hyperlinking

Hyperlinking does not allow for grades to appear in the Canvas gradebook.

  1. Login to
  2. Click the green “View” button on the course that will be hyperlinked
  3. Copy the URL from the address bar
  4. Go into Canvas
  5. Go into Modules
  6. Click the + symbol
  7. Select External URL
  8. Paste the URL into the “URL” field
  9. Type a name in the “Page Name” field
  10. Click the “Add Item” button


NOTE: This process should be completed by your Canvas Administrator.

  1. Login to Canvas with an Administrator account
  2. Click Settings
  3. Click Apps
  4. Click View App Configurations
  5. Click +App.
  6. The Add/Edit App window will appear.
    1. Configuration Type: Manual Entry
    2. Name: iCEV
    3. Consumer Key: {please contact us for this information}
    4. Shared Secret: {please contact us for this information}
    5. Launch URL:
    6. Domain:
    7. Privacy: Name Only
    8. Custom Fields:

Adding an Administrative Access Token

NOTE: This process must be completed by your Canvas Administrator; this process is optional. The administrative access token will allow teachers to control the number of attempts a student is given; for each assignment by Canvas.

  1. Login to Canvas with an Administrator account
  2. Click Account
  3. Click Settings
  4. Click +New Access Token
  5. Purpose: iCEV API Application
  6. Expires: {Leave Blank}
  7. Click the Generate Token button
  8. Send an email to with:
    1. The token key
    2. The Canvas domain name
      1. Example:


After the external tool has been setup by the Canvas Administrator; please follow these steps.

If while in you do not see the “Export Common Cartridge” button; please use this resource:

If while in you see the “Export Common Cartridge” button; use the steps directly below:

Step 1 – Export a lesson from

  1. Go into the lesson
  2. Make certain that the lessons that need to be exported are set to be “Visible to Students” 
  3. Make certain that the assets (assignments, assessments, and resources) that need to be exported are set to be “Visible to Students”
  4. Click Export Common Cartridge
  5. Click Export
  6. The file (common cartridge) will download

Step 2 – Import a lesson into Canvas

Note: This step assumes that the Canvas Administrator has setup the external tool (integration) in Canvas. If they have not, please send the Administrators Section to the Canvas Administrator.

  1. Go to the Canvas Sandbox Course
    1. The term Sandbox may be different in your organization:
      1. It is an empty course that is unpublished
      2. It has no students enrolled in it
    2. Do not import directly into a Published Course; data loss can occur
      1. Data recovery typically is not possible; this must be done by the Canvas Administrator
  2. Click Home
  3. Click Import Existing Content
  4. Content Type: Select – Common Cartridge 1.x Package
  5. Click Choose File
    1. Select the recently downloaded common cartridge file
  6. Content: Click – All content
    1. Unless you know that you need something specific
  7. Click Import
  8. Wait for Canvas to complete processing the file
  9. Click Modules

Step 3 – Copy the lesson into the course

  1. Click the three dots to the right of the Module Header
  2. Click Copy To…
  3. Select the Course
  4. Click Copy
  5. Click Close
  6. Click Courses
  7. Go to the Course


Student Feedback Options

Attempt Threshold Options


Lesson Visibility Settings

Assignment Visibility Settings



iCEV & Canvas

Canvas is acting strangely what can I do?

Please review this resource to see how Canvas / Instructure is running worldwide:

Please review this resource to see how your specific host is running:

What does “Error Couldn't retrieve LMS Data.” mean?

This error message appears if the internet or network is running slowly or is unstable.

Step 1
If the student refreshes the browser a few times the error message should go away.

Step 2
If the error message is very persistent; please have the student clear their internet history and cache.

If using an Apple device
Please use this resource to disable “Prevent cross-site tracking” in the Safari browser:

Step 3
If after refreshing and clearing the internet history; the message still appears please verify that third-party cookies are not being blocked.

Some or all student grades are missing, what can be done?

1.    Have the student go back to the assignment that is missing the grade.

2.    Have the student click the text that says “Summary”.

All student grades are zero (0), what can be done?

1.    Go to the Course

2.    Go to Module

3.    Look at the assignment that is reflecting all zeros (0)

Double-check the point value for the Canvas external tool assignment and that the value is something other than zero (0). If it is set to zero (0), set the point value to something different and have the students re-submit the assignment. Have the students follow the directions in “Some student grades are missing what can be done?”

Grades are not showing under the correct assignment in the Canvas Gradebook.

Most likely this scenario has happened:

1. The student opens Assignment “A” and tries a few questions.

2. The student then opens Assignment “B” in a new tab or window on the same browser.

3. The student moves back to Assignment “A” and sends the assignment.

In this scenario, scores will appear under Assignment “B” rather than Assignment “A” because scores are sent back for the last opened assignment (Assignment “B” in this case) on the browser as the session is updated.

How can I see when grades were received by the Canvas Gradebook?

1. Go into the Course

2. Click Grades

3. Wait for the gradebook to appear

4. Click Gradebook

5. Click Gradebook History

Gradebook History shows as grades are coming in; under "Grader” anywhere “Not Available” is visible; that is Canvas receiving the grade from iCEV or any other external tools being used.

Please review this resource:

What does “Couldn’t find valid settings for this link.” mean?

The External Tool needs to be updated. Add to the Domain field.

We're Here to Help

If you have any questions or need additional support, please contact us using one of the options below: