This article explains different options for modifying your Qualtrics LTI configuration in the setup page, and the effects that each change can have. This includes editing existing Qualtrics domains, connecting new Qualtrics domains, changing your API token, and more.

TABLE OF CONTENTS

• Introduction
• What changes can you make to your Qualtrics LTI domain configuration?
  • 1. Connecting new Qualtrics domains [Institute Admins Only]
  • 2. Edit existing Qualtrics domains
  • 3. Change which Qualtrics domain is linked to a Canvas root/sub-accounts
  • 4. Change the API token of a Qualtrics domain
  • 5. Enable or disable personal surveys for each domain

If you have not yet set up your Qualtrics LTI account, please see this article for more information. 

Introduction

When in the domain configuration page on the root account, it should look like the image below. 

In the domain configuration page, you can see which Qualtrics domains are connected to the LTI, which of those domains are linked to the root account and various sub-accounts (if applicable), and which domains have personal surveys enabled. 

Most of the modifications you can make to your Qualtrics LTI domain configuration can have large implications for users at your institution. If you are unsure of the consequences of making any changes, feel free to reach out to our support team (support@drieam.com) for more information before making any changes. 

What changes can you make to your Qualtrics LTI domain configuration?

These are the items you can change in your domain configuration: 

1. Connecting new Qualtrics domains [Institute Admins Only]

2. Edit existing Qualtrics domains

3. Change which Qualtrics domain is linked to the Canvas root/sub-account 

4. Change the API token of a linked Qualtrics domain 

5. Enable or disable personal surveys of a Qualtrics domain 

These possible changes are described in more detail in the sections below. You can navigate to each section to learn more about what can be changed in each portion of the domain configuration page, and the impacts it can have on users at your institution. 

1. Connecting new Qualtrics domains [Institute Admins Only] 

To connect a new Qualtrics domain, click on the blue “+ Connect Qualtrics domain” button on the right-hand side of the domain configuration page. 

A pop-up screen will appear where you can enter the new domain name, data center ID, brand admin API token, and (optionally) enable personal surveys. These steps are the same for any time you wish to add a new domain. See this help article for more information about setting up your Qualtrics LTI account & domain configuration for the first time. 

Once the domain is added to the Qualtrics LTI, admins at the root and sub-account levels in Canvas can link that domain to their Canvas account. You can see an overview of which Canvas accounts are linked to a domain by clicking on the blue number in the “Linked Canvas accounts” column of the setup page. 

2. Edit existing Qualtrics domains

On the right side of the domain configuration page, there is a pencil icon for editing each Qualtrics domain, and a trash can icon for deleting a Qualtrics domain. 

Once you click on the pencil icon, a pop-up screen will appear where you can edit the domain. It is the same pop-up screen from when you first added the domain, but you can now change any information here, including the name, data center ID, and access to personal surveys (enable/disable). 

You can easily rename the domain or enable/disable personal surveys for everyone on that domain. People will see the domain name when they first log in to the Qualtrics LTI. 

It is important to note that the Oauth2 setup information (client ID, client secret, and scopes) comes from Qualtrics and is necessary for the LTI to function properly, so we do not recommend changing these items without collaboration with your Qualtrics admin. 

3. Change which Qualtrics domain is linked to a Canvas root/sub-accounts 

Before changing your linked Qualtrics domain, it is important to know that all surveys in the LTI that were added to the old domain will be archived when the new domain is linked, assuming the new domain or API token does not have access to those surveys in Qualtrics. If a survey is archived in the Qualtrics LTI, it will produce an error in existing Canvas assignments and cannot be added to new assignments. For this reason, if you would like to change the Qualtrics domain linked to your Canvas root/sub-account, please reach out to your CSM or our support team (support@drieam.com). 

If you would like to change which Qualtrics domain is linked to a Canvas root/sub-account, you can do this in the domain configuration page by going to the bottom portion of the page called “Linked Qualtrics domain” Here, click on the “Change linked domain” button on the right hand side.  

A pop-up screen will appear where you can pick a new Qualtrics domain (and API token) to link to the Canvas account. 

The Qualtrics domain and API token are used when generating the list of Qualtrics surveys that can be added to the LTI at the root and sub-account levels. This is based on which surveys the user who generated the API token has access to – either from surveys that that Qualtrics Admin user has made themselves, or surveys that have been collaborated with them. All surveys that the API token has access to will appear in the list of surveys that could be added to the Qualtrics LTI by the Canvas admin in the root account or in sub-accounts.

Please see the next section for more information about changing the API token, which will usually take place if you are changing your linked Qualtrics domain. If the API token is changed, existing surveys (which the new API token user does not have access to) are archived in the LTI. If a survey is archived, you cannot add it to a new assignment and it will not appear in the list of surveys in the root account. Additionally, if a survey in an existing Canvas assignment is archived, students will no longer be able to open and complete the survey in that Canvas assignment – they will instead receive an error message. You can view which surveys have been archived in the LTI by going to the Survey overview (main page of the LTI at the root, sub-account, or personal surveys level), clicking on the “Filters” dropdown, and setting the Status to “Archived.” Clicking into an individual survey will allow you to unarchive it, but only if the new API token has access to that survey (e.g., you can first collaborate that survey with the user who made the new API token in Qualtrics, and then unarchive the survey in the Qualtrics LTI).  

4. Change the API token of a Qualtrics domain 

It could be useful to change the API token in the following scenarios: 

• There is a new Qualtrics Admin at your institution who would like to be in charge of the connection with Qualtrics LTI

• The previous Qualtrics Admin who generated the existing API token no longer works at your institution, and their account is going to be removed or their permissions will be deleted

• You are linking a new Qualtrics domain to the Canvas root/sub-account

If you would like to change the API token of the linked Qualtrics domain, you can do this without having to select a new domain entirely. Simply click the “Change linked domain” button and change the API token in the pop up window (shown above). 

Note that the API token will determine which surveys the root/sub-account's 'Add survey' list has access to, and thus which surveys can be added to the LTI at the root/sub-account level. Make sure that the Qualtrics Admin who is supplying their API token is aware that any survey they have access to can be added to the LTI by Canvas admins. This includes both surveys that they created themselves and surveys that have been collaborated with them. 

When configuring the Qualtrics LTI in a Canvas sub-account, you have to select a domain and an API token separately from the root account. Those two things then determine which surveys that sub-account has access to. The root account’s domain configuration has no bearing on which surveys will be in a sub-account ‘Add survey’ list, because it must be configured separately. This type of configuration, where there are different domains connected to the root account and to the sub-accounts, will add a new tab in the list of surveys in the External Tool window of a Canvas assignment. This will allow users to choose whether to add an institute survey, a sub-account survey, or a personal survey to a Canvas assignment.

Once a survey has been added to the LTI, any instructor within that institution (root account) or department (sub-account) could put that survey in their courses, regardless of whether or not they have access to the survey in Qualtrics. But, only people with access to the survey in Qualtrics will be able to see the survey results so long as SpeedGrader has not been enabled for that survey in the LTI. If the Qualtrics Admin has access to surveys that they do not want to have the possibility of being added to the LTI by Canvas admins for any instructor to use, then their API token should not be used in the LTI domain configuration. 

If the API token is changed, existing surveys (which the new API token user does not have access to) are archived in the LTI. If a survey is archived, you cannot add it to a new assignment and it will not appear in the list of surveys in the root account. Additionally, if a survey in an existing Canvas assignment is archived, students will no longer be able to open and complete the survey in that Canvas assignment – they will instead receive an error message. You can view which surveys have been archived in the LTI by going to the Survey overview (main page of the LTI at the root, sub-account, or personal surveys level), clicking on the “Filters” dropdown, and setting the Status to “Archived.” Clicking into an individual survey will allow you to unarchive it (More > Unarchive), but only if the new API token has access to that survey (e.g., you can first collaborate that survey with the user who made the new API token in Qualtrics, and then unarchive the survey in the Qualtrics LTI).  

5. Enable or disable personal surveys for each domain

In the “Edit Qualtrics Domain'' pop-up screen, you can choose to turn personal surveys on or off. Personal surveys also need to be enabled or disabled in the Settings page of the root Qualtrics account, and on our end at Drieam. Because of this, if you would like to enable personal surveys for your institution, please reach out to your CSM or our support team (support@drieam.com). 

Turning on personal surveys will allow any admin or instructor to add Qualtrics surveys to their personal surveys bank in the Qualtrics LTI, and then add these surveys into Canvas assignments. It will not be necessary for these surveys to be collaborated with the root or sub-account in Qualtrics to be added to the LTI – the instructors can add the surveys they want themselves. 

Note that if your institution has a Teacher Level License, you will only be able to access Personal Surveys – not institute or department surveys – so it is not recommended to disable this setting. If you have an Enterprise License, you can use Institute, Department, and Personal surveys. However, if you want to restrict the access to the LTI to only institute or department admins in Canvas, then we recommend disabling personal surveys. 

Note that personal surveys can be used in tandem with institute and/or department surveys if you have an Enterprise license. It is not “one or the other.” 

If personal surveys were previously enabled and you would like to disable them, simply toggle the Personal surveys off in both the domain setup and the root account settings page. When you do this, all existing personal surveys in the Qualtrics LTI will be archived, disabling them in all existing Canvas assignments.

If personal surveys were previously disabled and you would like to enable them, toggle the Personal surveys on. Once you do this, you can add a support email address that users will see if they click on “Menu” > “? I need help” in the Qualtrics LTI. You will also need to enable personal surveys in the Settings page of the root Qualtrics account, and we will need to enable them on our end at Drieam. Because of this, if you would like to enable personal surveys for your institution, please reach out to your CSM or our support team (support@drieam.com). 

Most of the modifications you can make to the Qualtrics LTI domain configuration can have large implications for users at your institution. If you are unsure of the consequences of making any changes, feel free to reach out to our support team (support@drieam.com) or your CSM for more information before making any changes.