Managing Users (Discover)
About Managing Users
Studio enables you to separately control the tasks that users can perform and the data they can access.
User Permissions
You can assign a set of permissions to each user account that determines which actions the user can perform within Studio. The range of permissions available to a user is defined by a license. For example, a user with the permission to create dashboards also needs to have access to a content provider that serves as a source of XM data so that they can add data to a dashboard.
User Data Access
At the most basic level, a registered user can view any dashboard that is shared with that user by the dashboard owner.
To create your own reports that can be shared with others on your behalf, you need to have access to data from a corresponding content provider. This is achieved by linking your user account to a content provider and granting you access to its projects.
A user with a Configuration Analyst or Report Creator license and a linked account can switch between Studio and Designer applications using a single sign-on.
For more information about managing data access, see Managing Data Access.
Power Users
In addition to System Administrators, Studio supports several types of power users who can perform a limited set of administrative functions and access additional reports on Studio usage. For more information, see Power Users.
Groups
Users in Studio may be organized into groups for more convenient dashboard sharing and permissions management. Instead of sharing a dashboard or a filter with individual users, you can share it with a group. Likewise, permissions may be granted to a group and passed on to all group members as long as they stay in that group. Groups are also the only way a user can be subscribed to alerts.
User Management Tasks
Every user in Studio can perform the following tasks:
- Adjust user preferences, including changing their password.
- Change the picture associated with their user account.
- View their login history to make sure their account is protected.
Advanced users can perform the following user management tasks:
- Register users in XM Discover via Studio.
- Edit user account properties, permissions, or data access.
- Add or remove permissions for users and groups.
- Apply a new license type to multiple users.
- Give a user access to data from a content provider.
- Request a password reset on behalf of another user.
- Remove a user from a Master Account.
Group Management Tasks
Advanced users can perform the following group management tasks:
- Create a group to easily manage multiple users.
- Add selected users to a group or cancel their group membership.
- Delete a group (not users).
For more information about managing user and group permissions and data access, see Groups (Discover).
Editing a User Account
After a user account is registered, you can change its properties, permissions, and group membership, as well as link it to content providers.
- Sign in to Studio.
- Click the profile icon.
- Select Users & Groups.
- Click the Users tab.
- Locate the user account you wish to modify. You can search for users by their first name, last name, email address, license type, last login date, groups they belong to, or the content of the custom field created by an Account Owner.
- Click the actions menu next to the user account.
- Select Edit.
- In the User Details window you can do the following:
- Modify user account properties in the Properties tab.
- Grant permissions in the Permissions tab.
- View the sum of all permissions granted to the user and the groups the user is a member of in the Derived Permissions tab.
- Define user’s data access for linked content providers in the Data Access tab.
- Modify the user’s group membership in the Groups tab.
Properties Tab Overview
In the Properties tab, you can modify the user’s name, password, location, and license, as well as link the user to content providers.
- Make edits to the user’s first name in the First Name field.
- Make edits to the user’s last name in the Last Name field.
- Select the Reset Password checkbox to reset the user’s password. For more information, see the Resetting a Password section.
- Click Change Password to change the user’s password.
- Click Clear Password Change to clear a password change.
- Select the user’s location from the Location menu. The user’s location is detected automatically based on the user’s sign-in details and can be adjusted manually.
- Link XM user accounts by entering the email address used by the user to sign in to their Engage (Qualtrics platform) brand in the XM Account ID For more information, see Linking XM User Accounts.
- Select the license type from the License Type menu. Downgrading a user who owns dashboards, filters, or metrics, to a Report Consumer license starts the transfer wizard that lets you assign new owners for these objects.
- Select the default master account from the Default Master Account menu.
- Click Link User to Content Providers to link the user to content providers.
- Click Save.
Permissions Tab
You can grant permissions to the user in the Permissions tab.
Derived Permissions Tab
In the Derived Permissions tab, you can view the sum of all permissions granted to the user and the groups the user is a member of.
Data Access Tab
You can define user’s data access for linked content providers in the Data Access tab.
For more information, see the Managing Data Access section.
Groups Tab
You can make changes to the user’s group membership in the Groups tab.
Custom Property in User Accounts
In Studio, you can add 1 custom property to standard user account properties. You can use this extra property to group users in the Users tab. For example, you may want to group users by team or by function for bulk operations.
Bulk Updating a Custom Property
- Sign in to Studio.
- Click the profile icon.
- Select Users & Groups.
- Click the Users tab.
- Select the checkbox next to each of the user accounts.
- Click the actions menus next to 1 of the selected user accounts.
- Select Update [custom property].
- Type the new value into the custom property box.
- Click Save.
Exporting Users to Microsoft Excel
You can export Studio users’ details to Microsoft Excel.
For information about exporting groups to Microsoft Excel, see Exporting Groups to Microsoft Excel.
- Sign in to Studio.
- Click the profile icon.
- Select Users & Groups.
- Click the Users tab.
- You can use the Find Users search box to filter users by:
- Name or Email (default)
- First Name
- Last Name
- Email Address
- License Type
- Last Login
- The content of the custom field created by an Account Owner.
Qtip: If no filter is applied, all users are exported.
- Click Export to XLSX.
- Click Ok in the Export XLSX window.
- Once the export is finished, the file will be emailed to you. The export file contains the following data:
- Filters: Shows search and column filters that are applied to exported users. If no filters are applied, this section is empty.
First Name: User’s first name - Last Name: User’s last name
- User Email: User’s email address
- License Type: User’s license
- Lite Admin: Shows whether the user is an Account Administrator (YES) or not (NO)
- Linked to CP: Shows whether the user is linked to a content provider (TRUE) or not (FALSE)
- Last Login Date: User’s most recent sign-in date
- Creation Date: User account’s creation date
- Custom field: Content of an optional custom field
- Location: User’s location. This can be detected automatically based on the user’s sign-in details, or adjusted manually. For more information, see the Editing a User Account section.
In addition, the Unique User Identifier (user’s ID) is shown in the export file for accounts with SAML enabled.
Resetting a Password
In Studio, you can change your password if you forget it or if you’re experiencing sign-in issues for any of the XM Discover apps. Studio Administrators can help you reset or change your password.
Resetting Your Own Password
All Studio users can reset their password on the Studio sign-in page.
- Click the Forgot Password? link on the Studio sign-in page.
- Enter your email address into the Email box.
- Click the Send Password Reset Link button.
You will get an email with instructions on resetting your password. If it doesn’t arrive, be sure to check your spam folder.
Resetting Another User’s Password
Administrators can request a password reset on behalf of other users while troubleshooting sign-in issues.
- Sign in to Studio.
- Expand the user avatar menu in the top navigation area.
- Select Users & Groups.
- Click the Users tab.
- Locate the user account you wish to modify. You can search for users by their first name, last name, email address, license type, last login date, groups they belong to, or the content of the custom field created by an Account Owner.
- Expand the actions menu next to the user account.
- To reset passwords for multiple users, select the checkbox next to each of the user accounts.
- Select Reset Password.
- Select Yes to confirm the password reset request.Studio sends out a password reset email to the user.
Changing Another User’s Password
Administrators can change another user’s password while troubleshooting sign-in issues.
- Sign in to Studio.
- Expand the user avatar menu in the top navigation area.
- Select Users & Groups.
- Click the Users tab.
- Locate the user account you wish to modify. You can search for users by their first name, last name, email address, license type, last login date, groups they belong to, or the content of the custom field created by an Account Owner.
- Expand the actions menu next to the user account.
- Select Edit.
- Click the Change Password button in the Properties tab.
- Enter the new password in the Password and Confirm Password boxes.
- Click Save.
Removing a User Account
You can remove users from your Master Account if they no longer need to access it. When removing a user who owns dashboards, books, filters, metrics, or other objects, you will be asked to either transfer these assets to new owners or delete them.
Removing a user from a Master Account does the following:
- Removes user’s access to your Master Account.
- Removes user’s access to Studio (unless they have access to another Master Account).
- Releases that user’s license seat.
- Sign in to Studio.
- Expand the user avatar menu in the top navigation area.
- Select Users & Groups.
- Click the Users tab.
- Locate the user account you wish to remove. You can search for users by their first name, last name, email address, license type, last login date, groups they belong to, or the content of the custom field created by an Account Owner.
- To remove a single user, expand the actions menu next to the user account.
- Select Remove and then select Remove from Master Account.
- To remove multiple users at once, select the checkboxes next to the user accounts you wish to remove and expand the actions menu next to 1 of the selected user accounts.
Qtip: When selecting multiple users, expand the Licensing Information section to see how many users are currently selected.
- After expanding the actions menu, select Remove from Master Account.
- If the user you are removing owns any objects (such as dashboards, books, home pages, filters, metrics, drivers, mobile app configurations, or metric alerts), you need to either transfer or delete the objects. To transfer all objects to 1 new owner, select the Manage Everything checkbox.
- Select the new owner from the menu.
- To delete all objects, make sure that the Manage Everything checkbox is selected and select DELETE.
Managing Objects Individually
- Expand the actions menu next to the user account.
- Select Remove and then Remove from Master Account.
- If the user doesn’t own any objects (such as dashboards, books, home pages, filters, metrics, drivers, mobile app configurations, or metric alerts) and there are no objects to transfer, click Disable User.
- If the user owns objects, you need to transfer the objects. To transfer all objects to 1 new owner, select the Manage Everything checkbox.
- Select the new owner from the menu.
- Click Disable User and Transfer Objects.
Qtip: All dashboard widgets owned by this user will also be transferred to the new dashboard owners. This includes widgets created by this user in dashboards owned by others. Widgets owned by other users will not be changed. When transferring dashboards, the dashboard schedules are transferred as well.Qtip: When transferring objects, keep in mind that the new owners need to meet transfer requirements.
Transferring Objects Requirements
When transferring objects, new owners need to meet these requirements:
- Dashboards and books: Dashboard and book ownership can only be transferred to users who have Edit Dashboard permission and data access to the corresponding project.
- Drivers: Driver ownership can only be transferred to users who have Create and Manage Drivers permission and data access to the corresponding project.
- Filters: Filter ownership can only be transferred to users who have Create Filter permission and data access to the corresponding project. Date filter ownership can only be transferred to users who have Manage Date Filter permission and data access to the corresponding project.
- Homepages: Home page ownership can only be transferred to users who have Manage Settings permission and data access to the corresponding project.
- Metric Alerts: Metric alert ownership can only be transferred to users who have Create and Manage Metric Alerts permission and data access to the corresponding project.
- Metrics: Metric ownership can only be transferred to users who have Create Metric permission and data access to the corresponding project.
- Mobile App Configurations: Mobile app configuration ownership can only be transferred to users who have Manage Settings permission and data access to the corresponding project.
Linking a User to a Content Provider
You can link Studio users to their content provider so they can use Designer data in their reporting widgets. Account linking is done in 2 stages:
- Link a user to the Designer account they want to report on.
- Define data access for that user.
A user with a Configuration Analyst license and a linked account can switch between the Studio and Designer applications using the same login credentials. Switching to Designer allows uploading data, setting up topics (classification models), and tuning sentiment. For more information, see Navigating XM Discover.
Account linking is based on the user’s email address:
- If a user with the same email address does not exist in the selected account of the content provider, the user will be created automatically. The access level of a user in Designer depends on the license and data access defined in Studio.
- If a user with the same email address is already registered in the content provider, the Designer user account and the Studio user account will become linked.
How to Link a User Account to a Content Provider
- Sign in to Studio.
- Expand the user avatar menu in the top navigation area.
- Select Users & Groups.
- Click the Users tab.
- Locate the user account you wish to modify. You can search for users by their first name, last name, email address, license type, last login date, groups they belong to, or the content of the custom field created by an Account Owner.
- Expand the actions menu next to the user account.
- Select Edit.
- Select a license type from the menu:
- Configuration Analyst: Users with this license type can be granted access to Designer reporting data and access to the Designer application.
- Report Creator: Users with this license type can be granted access to Designer reporting data.
- Report Consumer: Users with this license type cannot be linked to Designer.
- Click Link User To Content Providers.
- Click the name of your content provider.
- Select the checkbox next to your account to link a user to it.
- Click Save to close both windows.
You then need to define project-level data access for the user. For more information, see the Managing Data Access section below.
Managing Data Access
Data access controls enable you to determine account and project-level permissions in the Designer application for a user with a Configuration Analyst or Report Creator license who is linked to a content provider in Designer.
Updating Data Access for a Single User
- Sign in to Studio.
- Expand the user avatar menu in the top navigation area.
- Select Users & Groups.
- Click the Users tab.
- Locate the user account you wish to modify. You can search for users by their first name, last name, email address, license type, last login date, groups they belong to, or the content of the custom field created by an Account Owner.
- Click the actions menu next to the user account.
- Select Update Data Access.
- If you have access to several content providers, select the content provider to use. For information on how to select a content provider, see Linking a User to a Content Provider section.
- If you wish, you can select Grant this user full administrative rights to data. This user will be able to manage all projects and all underlying topic and sentiment models to make the user an Account Administrator.
Qtip: Account Administrators can perform all administrative functions within an account.
- Alternatively, you can select Grant this user access to select projects in your account to define project-level access for the user.
- If you wish, you can assign bulk permissions at the project level by clicking 1 of the following:
- Mark all as “Administrator” to grant Administrator access to the user for all projects.
- Mark all as “Read-only” to grant read-only access to the user for all projects.
- Mark all as “No access” to disable access to all projects for the user.
- If you don’t wish to assign bulk permissions at the project level, you can select 1 of the the following available access options for each project in the Access column to define project-level access for the user:
- Administrator (requires a Configuration Analyst license): Make the user a Project Manager. Project Managers can perform all administrative functions within a project.
- Read Only (requires a Configuration Analyst license): Make the user a Category Viewer. Category Viewers can run Designer reports, create personal filters, view classification models (but not change them), and view sentiment settings (but not change them).
- Read Only (requires a Report Creator license): Make the user a Navigator Act User. Navigator Act Users can access dashboard reports and create personal filters. Other Designer tabs are unavailable to them.
- No Access: Disable access to a project. The user will not be able to use that project in any Studio report widget or filter.
- Custom:. This option is shown if project permissions are explicitly defined in Designer and cannot be modified in Studio.
Qtip: Assigning bulk permissions using the Mark all as… links does not impact Custom access levels.Qtip: You can only grant others users access up to your own level. Having a Custom access level for a project means you can only grant No access level to others for that project.
Updating Data Access for Multiple Users
Users are only granted access rights up to what is available for their license type. If a user is not linked to a Content Provider for which you grant data access, they will be linked to it automatically. Account Administrators (users who were individually granted full administrative rights to data) are immune to bulk data access changes.
- Sign in to Studio.
- Expand the user avatar menu in the top navigation area.
- Select Users & Groups.
- Click the Users tab.
- Locate the user accounts. You can search for users by their first name, last name, email address, license type, last login date, groups they belong to, or the content of the custom field created by an Account Owner.
- Select the checkboxes next to the user accounts.
- Expand the actions menu next to 1 of the selected user accounts.
- Select Update Data Access.
Qtip: If at least 1 of the selected users has a Report Consumer license, the bulk option to update data access will be unavailable.
- If you have access to several content providers, select the content provider to use.
- For each project, select 1 of the following available options:
- Administrator: Make the user a Project Manager. Project Managers can perform all administrative functions within a project. This only applies to users with a Configuration Analyst license.
- Read Only: Depending on the user’s license, the following data access is provided:
- Configuration Analyst license: Make the user a Category Viewer. Category Viewers can run Designer reports, create personal filters, view classification models (but not change them), and view sentiment settings (but not change them).
- Report Creator license: Make the user a Navigator Act User. Navigator Act Users can access Dashboard reports and create personal filters. Other Designer tabs are unavailable to them.
- No Access: Disable access to a project. The user will not be able to use that project in any Studio report widget or filter.
- Disable access to a project: The user will not be able to use that project in any Studio report widget or filter.
- No Change (default): Make no changes to this project.
Qtip: You can only grant others users access up to your own level. Having a Custom access level for a project means you can only grant No access level to others for that project.
Designer User Roles
See User Roles and Permissions (Designer) for an overview of roles in Designer.
Bulk User Updates
You can update up to 500 users at a time. For more information on linking XM user accounts via bulk user upload, see Bulk Uploading Users.
- Sign in to Studio.
- Expand the user avatar menu in the top navigation area.
- Select Users & Groups.
- Click the down arrow icon.
- Click the Update Users button.
- If you have not already downloaded the Microsoft Excel template file in .xls or .xlsx format, click the download one link in the File Upload section to download the template.
- Up to 5000 users will be displayed in the Users sheet in the Microsoft Excel file. If you wish to update a user that is not listed in the Users sheet, paste that user’s email address in a separate cell in the Email Address column in the Updates sheet.
Attention: This is a requirement so that updates can be correctly associated with existing accounts. The email address cannot be changed.
- If necessary, you can update the following details in the Updates sheet:
- The user’s first name in a separate cell in the First Name column.
- The user’s last name in a separate cell in the Last Name column.
- If you wish, you can update the XM Account ID for each user by entering the XM identifier for each user in the XM Identifier column (optional).
- If you wish, you can disable users in bulk (optional). In the Disable User column, select Yes from the menu for each user that you wish to remove from the given Master Account.
Qtip: If it is their last Master Account, the user will also be disabled in Studio.Qtip: If you select No from the menu or leave the cell blank, this will not change the user’s access.Qtip: Users may only be disabled if their license type is Report Consumer. If a user attempts to disable a user who is not a Report Consumer, the request will be skipped in the update file and an error message will be shown in the Invalid tab.
- Save the Microsoft Excel file to your computer.
- Click Upload A File to update the Microsoft Excel file in the File Upload section.
- When you upload the Microsoft Excel file, it will be validated:
- The number of invalid entries will be displayed in the INVALID tab in the File Processing Summary section and details about each invalid entry will be displayed in the Details column.
- The number of successful entries will be displayed in the SUCCESSFUL tab.
- If there are invalid entries, return to the Microsoft Excel file, add the necessary information, and save the changes to the file. For details of possible errors that may be identified and how to fix these errors, see Error Messages.
- Click Update a File to upload the amended Microsoft Excel file in the File Update section.
- When all entries are validated correctly, you will see all entries shown in the SUCCESSFUL tab in the File Processing Summary section.
Error Messages
Errors that may be identified when you upload a Microsoft Excel file when carrying out a bulk user upload, together with ways of fixing them are listed below:
- This user already exists in Studio: Remove the user from the bulk upload template.
- The group: (group name) does not exist in Studio: Either create a missing group in Studio or remove it from the bulk upload template.
- All users must have a valid License Type populated: Select a valid license for each user.
- Users with email domain (email domain) are not allowed in this account: Either use a different email domain or add the domain you want to use to the list of allowed domains.
- Email Address must be unique for each user being uploaded: Use unique emails for each user.
- Users cannot be added to Organization Hierarchy derived groups: Remove the derived groups from the bulk upload template.
- The domain: (domain) is not allowed in this account: Provide a different email address or add the domain to the list of allowed email domains.
Errors that may be identified when you carry out a bulk user upload or a bulk user update, together with ways of fixing them are listed below:
- You do not have sufficient (license type) licenses available: Either free up some license seats in your Master Account or use a different license.
- All users must have a valid Email Address populated: Either provide a valid email for each user or remove users without emails.
- Please provide valid Email Addresses: Make sure user emails match the requirements.
- First Name must not exceed 40 characters: Trim the first name to 40 characters.
- Last Name must not exceed 40 characters: Trim the last name to 40 characters.
- (Number of users with the same Unique User Identifier) have the same Unique User Identifier: Use unique IDs for each user or remove duplicate user entries.
- (Unique User Identifier value) already exists in the system: Use unique IDs for each user.
- Unique User Identifier is a required field: Provide a unique ID for each user if your account uses SAML authentication.
- This user was re-enabled with the information provided: This means that an inactive user account was activated 1 more time.
Linking XM User Accounts
You can link a user’s Engage (Qualtrics platform) and Discover accounts, making it possible to use integrations between the platforms. Integrations that require linked accounts include:
- Embedding Studio Dashboards in Qualtrics Dashboards
- Triggering Qualtrics Workflows with Discover Events
- Creating Qualtrics Tickets Based On Discover Alerts
Keep in mind that each user you link needs to have an existing account on both Qualtrics and Discover.
This section focuses on how administrators can link users’ accounts for them. Users can also link accounts themselves; for steps, see the User Preferences page.
Manually Linking Accounts
These steps let you link one person’s accounts at a time.
- Edit the user.
- Go to Properties.
- Under XM Account ID, enter the user’s Qualtrics.com username.
Qtip: If you’re also a Qualtrics Brand Administrator, see how to find this username. It often matches the user’s email address, but can vary, especially if you have SSO.
- Click Save.
Linking Many Users’ Accounts at the Same Time (Bulk Upload)
You can link many XM users’ accounts at the same time via bulk user upload. For more information, see Bulk Uploading Users.
Viewing Studio as Another User
Account owners can view all of Studio from the point of view of another user. This functionality is also often called “proxying” or “proxy logging in” to another person’s account.
This feature only gives access to Studio and all connected functionality. Designer and Connectors are not included.
- Click your user profile icon.
- Select Users & Groups.
- Stay in the Users tab and find the user you want to view Studio as.
- Click the Actions menu next to the user.
- Select View As.
- Confirm Yes.
- You can now navigate Studio as this user. At the top, you can select Exit ‘View As’ Mode to return to your own user account.