---
title: Setting Up a Scoped Canvas Data 2 Key for Atomic Search
description: Beginning November 9, 2026, new Canvas Data 2 keys are limited to the tables you choose. Existing keys keep working until December 31, 2027, so create a scoped key for Atomic Search before then.
---

[Skip to content](https://support.atomicjolt.com/knowledgebase/setting-up-a-scoped-canvas-data-2-key-for-atomic-search#main-content)

English

Show submenu for translations

[File a Support Ticket](https://support.atomicjolt.com/knowledgebase/kb-tickets/new?hsLang=en) [Customer Portal](https://support.atomicjolt.com/tickets-view?hsLang=en)

![Atomic Jolt Logo Horiz Small](https://support.atomicjolt.com/hs-fs/hubfs/Atomic%20Jolt%20Logo%20Horiz%20Small.png?width=260&height=95&name=Atomic%20Jolt%20Logo%20Horiz%20Small.png)

- [Release Notes Sign Up](https://share.hsforms.com/1iZCRfUF5QHeWYwcLC3bwEAdk6gc)

Open main navigation

Close main navigation

- [Release Notes Sign Up](https://share.hsforms.com/1iZCRfUF5QHeWYwcLC3bwEAdk6gc)
- English
  
  Show submenu for translations
- [File a Support Ticket](https://support.atomicjolt.com/knowledgebase/kb-tickets/new)
- [Customer Portal](https://support.atomicjolt.com/tickets-view)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [Atomic Jolt Knowledge Base](https://support.atomicjolt.com/knowledgebase?hsLang=en)
2. [Atomic Search](https://support.atomicjolt.com/knowledgebase/atomic-search?hsLang=en)
3. [Canvas Support](https://support.atomicjolt.com/knowledgebase/atomic-search?hsLang=en#canvas-support)

# Setting Up a Scoped Canvas Data 2 Key for Atomic Search

## Beginning November 9, 2026, new Canvas Data 2 keys are limited to the tables you choose. Existing keys keep working until December 31, 2027, so create a scoped key for Atomic Search before then.

A scoped Canvas Data 2 (CD2) key lets Atomic Search read only the Canvas tables you choose. Atomic Search needs 16 course content tables. It does not need any user, enrollment, or grade tables.

### **Before you begin**

- You need admin access to the Instructure Identity portal (identity.instructure.com) and to Atomic Search.
- Scoped keys are available starting November 9, 2026.
- If Atomic Search already uses a Canvas Data 2 key, that key keeps working until December 31, 2027. Replace it with a scoped key before then.
- You can't add tables to a key after you create it. Select all 16 tables, even for features you don't use yet.
- Each Canvas instance needs its own key.

### **Tables to select**

Copy this list. You'll paste it in step 4 below.

canvas.courses, canvas.enrollment\_terms, canvas.accounts, canvas.context\_modules, canvas.content\_tags, canvas.rubric\_associations, canvas.rubrics, canvas.wiki\_pages, canvas.assignments, canvas.discussion\_topics, canvas.quizzes, canvas.quiz\_questions, canvas.attachments, canvas.discussion\_entries, new\_quizzes.quizzes, new\_quizzes.quiz\_questions

### **Step 1: Create the key in the Identity portal**

1. Go to the Instructure Identity portal at identity.instructure.com and sign in.
2. Select **Add New Key**.
3. Enter a key name, such as Atomic Search. Set the expiry date as far out as allowed, up to 3 years. Set **Key Type** to **Institutional Use**.
4. On the Add tables page, set **Add method** to **Copy and paste**. Paste the table list from above.
5. Select **Review**. Check that 14 canvas tables and 2 new\_quizzes tables are listed, then select **Create**.
6. Copy the information provided including the Client ID, the Secret, and the secret's expiration date. The secret is **shown only once**, so save it somewhere secure before you leave the page.

### **Step 2: Add the key to Atomic Search**

1. Open Atomic Search from Canvas Admin, not from inside a course.
2. Go to **Canvas Integration**, then the **Indexing preferences** tab.
3. Under **Canvas Data 2 Credentials**, select **Add credentials**.
4. Paste the Client ID into **Key** and the secret into **Secret**. Enter the secret's expiration date.
5. Select **Save credentials**. The section now shows Secret: Saved and today's date under Last updated.

To replace a key later, follow the same steps and select **Update credentials**. Atomic Search keeps using the old key until you save the new one.

### **Troubleshooting**

| **Problem** | **Fix** |
| --- | --- |
| I don't see Canvas Integration or Canvas Data 2 Credentials | Open Atomic Search from Canvas Admin as an admin. These settings don't show when you open Atomic Search from a course. |
| Save credentials is greyed out | Fill in both Key and Secret. The expiration date must be after today and within 3 years. |
| Error: Atomic Search couldn't reach its indexing service | Wait a few minutes and select Save credentials again. Contact support if it keeps happening. |
| An error mentions the Key, Secret, or expiration date | Copy the value again from the Identity portal and check for extra spaces. |
| I left out a table or lost the secret | Create a new key with all 16 tables, then select Update credentials in Atomic Search. |
| My key is about to expire | Create a new key before it expires, then select Update credentials in Atomic Search. |

- [Atomic Jolt Customer FAQs](https://support.atomicjolt.com/knowledgebase/atomic-jolt-customer-faqs?hsLang=en)
- [Atomic Assessments](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#main-content)

    - [Release Notes](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#release-notes)
    - [Authoring Assessments](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#authoring-assessments)
    - [For Nursing](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#for-nursing)
    - [Content Management](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#content-management)
    - [Question Types](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#question-types)
    - [Grading & Feedback](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#grading-feedback)
    - [Reports](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#reports)
    - [Import and Export](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#import-and-export)
    - [Advanced Features](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#advanced-features)
    - [Proctoring](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#proctoring)
    - [Installation Guides](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#installation-guides)
    - [FAQ for Atomic Assessments](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#faq-for-atomic-assessments)
    - [Adaptive Assessments](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#adaptive-assessments)
    - [Learning Standards](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#learning-standards)
    - [Brightspace](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#brightspace)
    - [Canvas](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#canvas)
    - [Publishers](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#publishers)
    - [Admin Features](https://support.atomicjolt.com/knowledgebase/atomic-assessments?hsLang=en#admin-features)
- [Atomic Search](https://support.atomicjolt.com/knowledgebase/atomic-search?hsLang=en#main-content)

    - [FAQs](https://support.atomicjolt.com/knowledgebase/atomic-search?hsLang=en#faqs)
    - [Using Search](https://support.atomicjolt.com/knowledgebase/atomic-search?hsLang=en#using-search)
    - [Admin Features](https://support.atomicjolt.com/knowledgebase/atomic-search?hsLang=en#admin-features)
    - [Content Indexing](https://support.atomicjolt.com/knowledgebase/atomic-search?hsLang=en#content-indexing)
    - [Reports & Analytics](https://support.atomicjolt.com/knowledgebase/atomic-search?hsLang=en#reports-analytics)
    - [Brightspace Support](https://support.atomicjolt.com/knowledgebase/atomic-search?hsLang=en#brightspace-support)
    - [Canvas Support](https://support.atomicjolt.com/knowledgebase/atomic-search?hsLang=en#canvas-support)
- [Atomic Journals](https://support.atomicjolt.com/knowledgebase/atomic-journals?hsLang=en#main-content)

    - [Course Authors](https://support.atomicjolt.com/knowledgebase/atomic-journals?hsLang=en#course-authors)
    - [Student Experience](https://support.atomicjolt.com/knowledgebase/atomic-journals?hsLang=en#student-experience)
- [Atomic Polls](https://support.atomicjolt.com/knowledgebase/atomic-polls?hsLang=en#main-content)

    - [Course Authors](https://support.atomicjolt.com/knowledgebase/atomic-polls?hsLang=en#course-authors)
    - [Student Experience](https://support.atomicjolt.com/knowledgebase/atomic-polls?hsLang=en#student-experience)
    - [Course Copy](https://support.atomicjolt.com/knowledgebase/atomic-polls?hsLang=en#course-copy)
- [Atomic Discussions](https://support.atomicjolt.com/knowledgebase/atomic-discussions?hsLang=en#main-content)

    - [Course Authors](https://support.atomicjolt.com/knowledgebase/atomic-discussions?hsLang=en#course-authors)
    - [Student Experience](https://support.atomicjolt.com/knowledgebase/atomic-discussions?hsLang=en#student-experience)
- [Atomic Author](https://support.atomicjolt.com/knowledgebase/atomic-author?hsLang=en)
- [Atomic Socialize](https://support.atomicjolt.com/knowledgebase/atomic-socialize?hsLang=en#main-content)

    - [Release Notes](https://support.atomicjolt.com/knowledgebase/atomic-socialize?hsLang=en#release-notes)
- [Atomic Curriculum Analysis Tool](https://support.atomicjolt.com/knowledgebase/atomic-curriculum-analysis-tool?hsLang=en)

[![Atomic Jolt Logo Horiz Small](https://support.atomicjolt.com/hs-fs/hubfs/Atomic%20Jolt%20Logo%20Horiz%20Small.png?width=164&height=60&name=Atomic%20Jolt%20Logo%20Horiz%20Small.png "Atomic Jolt Logo Horiz Small")](https://www.atomicjolt.com)

Copyright © 2025, Atomic Jolt