Skip to main content
Loading...
Skip to article
  • Qualtrics Platform
    Qualtrics Platform
  • Customer Journey Optimizer
    Customer Journey Optimizer
  • XM Discover
    XM Discover
  • Qualtrics Social Connect
    Qualtrics Social Connect

Managing Organization Hierarchies (Studio)


Was this helpful?


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!


About Managing Organization Hierarchies

After you have defined an organization hierarchy, you can rename, edit, preview and delete it. You can also use organization hierarchy versioning and enable dashboard personalization.

Renaming an Organization Hierarchy

Qtip: This action requires a Manage Settings permission.
Qtip: Before you rename an organization hierarchy, make sure it is unpublished. For more information, see Publishing and Unpublishing an Organization Hierarchy.
  1. Sign in to Studio.
  2. Expand the user avatar menu in the top navigation area.
    Expand the user avatar menu in the top navigation area. Select Account Settings.
  3. Select Account Settings.
  4. Select the Organization tab.
    Select the Organization tab. Search for the organization hierarchy using the Name filter.
  5. Search for the organization hierarchy using the Name filter.
  6. Expand the actions menu next to the organization hierarchy.
    Expand the actions menu next to the organization hierarchy.
  7. Select Rename.
    Select Rename.
  8. Enter a new name for the organization hierarchy in the New name box.
    Enter a new name for the organization hierarchy in the New name box. Click Save.
  9. Click Save.
  10. If you plan to use this organization hierarchy as a grouping, you need to publish it.

Editing an Organization Hierarchy

Once you have an active organization hierarchy, you can edit its structure, as well as mapped filters, users, and enrichment parameters.

Qtip: When you change any component (structure, filters, users, or enrichment parameters) of an active organization hierarchy, you need to upload an Excel file with the new values, which completely replace the previous values. For this reason we recommend downloading the existing mapping and saving a separate copy for backup.

Before You Begin

Before you edit an organization hierarchy:

  • We recommend using versions to make changes to organization hierarchies that are currently in use.
  • To disable hierarchy-based groupings while keeping dashboard personalization, unpublish an organization hierarchy while keeping it active.
  • To completely disable an organization hierarchy while you modify it, deactivate it.

Download Existing Structure

Qtip: This action requires a Manage Settings permission.
  1. Sign in to Studio.
  2. Expand the user avatar menu in the top navigation area.
    Expand the user avatar menu in the top navigation area. Select Account Settings.
  3. Select Account Settings.
  4. Select the Organization tab.
  5. Search for the organization hierarchy using the Name filter.
    Select the Organization tab. Search for the organization hierarchy using the Name filter.
  6. Click the Edit link in the column corresponding to the component you wish to download.
    Click the Edit link in the column corresponding to the component you wish to download.
  7. Click the Download Existing Structure button to download the existing structure.
    Click the Download Existing Structure button to download the existing structure.
  8. Alternatively, click the Download Existing Mapping button to download the existing mapping.
    Click the Download Existing Mapping button to download the existing mapping.
  9. Make a backup copy of the Excel file.

Upload Updated Structure/Mapping

The steps that you follow when uploading the new structure or mappings are very similar to the steps that you follow when uploading the initial values:

Because an organization hierarchy’s components are connected, updating 1 of them sometimes requires you to make corresponding changes to other connected components:

  • Whenever you change the structure, you need to update filters, users, enrichments, and then republish the hierarchy.
  • Whenever you update filters, you need to republish the hierarchy.

You don’t need to make further changes when updating only user mappings or enrichment parameters.

Using Organization Hierarchy Versions

Attention: Only organization hierarchy owners can create versions of their hierarchies.

Organization hierarchy versioning gives you the ability to update an entire organization hierarchy in 1 action, ensuring that your organization hierarchy users never see partial changes, only finished versions. To update a hierarchy using a version, you need to do the following:

  1. Create Organization Hierarchy Version: Create an editable version of an organization hierarchy to duplicate the hierarchy properties and settings. For more information, please see the Creating an Editable Version of an Organization Hierarchy subsection below.
  2. Edit Organization Hierarchy Version: Update the hierarchy settings to reflect organizational changes. For more information, please see the Editing an Organization Hierarchy Version subsection below.
  3. Replace References to Original Hierarchy: Replace all references to the original hierarchy with the new version. For more information, please see the Replacing an Original Organization Hierarchy subsection below.
  4. Delete Original Organization Hierarchy Version: Delete the original hierarchy or save it for record-keeping. For more information, please see the Deleting an Original Organization Hierarchy Version subsection below.

Creating an Editable Version of an Organization Hierarchy

Qtip: You can create versions of both published and unpublished organization hierarchies that are active.
  1. Sign in to Studio.
  2. Expand the user avatar menu in the top navigation area.
    Expand the user avatar menu in the top navigation area. Select Account Settings.
  3. Select Account Settings.
  4. Select the Organization tab.
    Select the Organization tab. Search for the organization hierarchy using the Name filter.
  5. Search for the organization hierarchy using the Name filter.
  6. Expand the actions menu to the left of the hierarchy.
    Expand the actions menu to the left of the hierarchy.
  7. Select Create Version.This creates a disabled version of the original hierarchy with the same name and the word “Copy” added to it.
    Select Create Version.

    Qtip: If you don’t see this option, it means a version of this hierarchy already exists.

Editing an Organization Hierarchy Version

You can edit all aspects of the hierarchy’s version without affecting the original by doing the following:

Replacing an Original Organization Hierarchy

Once your version is ready to be made live, you can replace all references to the original hierarchy with the version.

  1. Sign in to Studio.
  2. Expand the user avatar menu in the top navigation area.
    Expand the user avatar menu in the top navigation area. Select Account Settings.
  3. Select Account Settings.
  4. Select the Organization tab.
    Select the Organization tab. Search for the organization hierarchy using the Name filter.
  5. Search for the organization hierarchy using the Name filter.
  6. Expand the actions menu to the left of the version.
    Expand the actions menu to the left of the version.
  7. Select Replace Original.
    Select Replace Original.
  8. Click Yes to confirm that you want to proceed.This replaces the original organization hierarchy with the modified version.
    Click Yes to confirm that you want to proceed.

    Qtip: The original version remains in the list, allowing you to make further changes to it. Alternatively, you can delete it.

Deleting an Original Organization Hierarchy Version

You can delete original organization hierarchy versions you no longer need.

Viewing Organization Hierarchy’s Dependencies

Qtip: This action requires a Manage Settings permission.

You can view which dashboards and metrics use your organization hierarchies. This is useful to consider when editing or deleting hierarchies.

Qtip: You can only view dependencies of the hierarchies you own.
  1. Sign in to Studio.
  2. Expand the user avatar menu in the top navigation area.
    Expand the user avatar menu in the top navigation area. Select Account Settings.
  3. Select Account Settings.
  4. Select the Organization tab.
    Select the Organization tab. Search for the organization hierarchy using the Name filter.
  5. Search for the organization hierarchy using the Name filter.
  6. Expand the actions menu to the left of the version.
    Expand the actions menu to the left of the version.
  7. Select Dependencies.
    Select Dependencies.
  8. To see which dashboards use the hierarchy, select Dashboards from the menu.
    To see which dashboards use the hierarchy, select Dashboards from the menu. For each dashboard that uses the hierarchy, the following information is displayed: Dashboard, Owner, Last Run and Status.
  9. For each dashboard that uses the hierarchy, the following information is displayed:
  • Dashboard: The name of the dashboard.
  • Owner: The user who owns the dashboard.
  • Last Run: The last time the dashboard was viewed in Studio, emailed as a PDF, or refreshed.
  • Status: The status of the dashboard (Private, Shared, or Public).
  1. To see which metrics use this filter, select Metrics from the menu.
    To see which metrics use this filter, select Metrics from the menu. For each metric that uses this hierarchy, the following information is displayed: Metric, Owner, Calculation Type and Status. Click Export to export all hierarchy's dependencies to Excel. Click Ok to close the Dependencies window.
  2. For each metric that uses this hierarchy, the following information is displayed:
    • Metric: The name of the metric.
    • Owner: The user who owns the metric.
    • Calculation Type: The metric type.
    • Status: The status of the metric (Private, Shared, or Public).
  3. Click Export to export all hierarchy’s dependencies to Excel. This step is optional. Once the export is finished, the file will be emailed to you. The export file contains all metrics and dashboards that use the hierarchy broken down into separate sheets.
  4. Click Ok to close the Dependencies

Deleting an Organization Hierarchy

Qtip: This action requires a Manage Settings permission.
Attention: This action cannot be undone.

You can remove the organization hierarchies you no longer need.

  1. Sign in to Studio.
  2. Expand the user avatar menu in the top navigation area.
    Expand the user avatar menu in the top navigation area. Select Account Settings.
  3. Select Account Settings.
  4. Select the Organization tab.
    Select the Organization tab. Search for the organization hierarchy using the Name filter.
  5. Search for the organization hierarchy using the Name filter.
  6. Expand the actions menu to the left of the version.
    Expand the actions menu to the left of the version.
  7. Select Delete.
    Select Delete.
  8. Click Next to confirm the hierarchy deletion.
    Click Next to confirm the hierarchy deletion.
  9. If you chose to automatically create groups from this hierarchy when uploading user mappings, you will be prompted to automatically delete those groups. Select Yes to delete the groups.
    Select Yes to delete the groups. Select No to keep the groups. Click Next to finish the hierarchy deletion.
  10. Select No to keep the groups.
  11. Click Next to finish the hierarchy deletion.

Dashboard Personalization

Dashboard personalization enables you to tie widgets to the structure of your organization or market segmentation. In a personalized dashboard, widgets are automatically filtered according to the selected organization hierarchy and the currently logged-in user’s highest position in that hierarchy.

Here is how dashboard personalization works:

  • Different users see different report results on the same dashboard if they are in different parts of the organization hierarchy.
  • A corresponding business segment is shown in the dashboard header.
  • If a user is assigned to a hierarchy level that is not the lowest, that user can toggle between children levels of the hierarchy. A user with access to the highest level of a hierarchy can select all subsequent business segments.
  • If a user is not identified in the hierarchy, that user will not see any data and will encounter an error message.

Enabling Dashboard Personalization

  1. Sign in to Studio.
  2. Navigate to the dashboard.
  3. Expand the options menu in the dashboard header.
    Expand the options menu in the dashboard header. Select Edit Properties.
  4. Select Edit Properties.
  5. Expand the Advanced Settings section in the Dashboard Properties window.
    Expand the Advanced Settings section in the Dashboard Properties window.
  6. Select the Personalization checkbox.
    Select the Personalization checkbox. Choose 1 of the active organization hierarchies from the menu. You can enable the Organization Context option to allow users to see, but not access, the entire organization hierarchy in dashboard filters regardless of their position within it. This step is optional.
  7. Choose 1 of the active organization hierarchies from the menu.
    Attention: If at least 1 widget is using the same organization hierarchy as a grouping, personalizing a dashboard will enable peer and parent reporting.
    Qtip: The list of available organization hierarchies is filtered to only include the organization hierarchies that are relevant to the default project for a specific dashboard
    Qtip: If you do not see the hierarchy right away, it is likely because it is still running classification. Once classification is complete, the hierarchy will be available on all personalized dashboards.
  8. You can enable the Organization Context option to allow users to see, but not access, the entire organization hierarchy in dashboard filters regardless of their position within it. This step is optional.
  9. Click Save.
    Click Save.

Previewing an Organization Hierarchy

Qtip: To preview a dashboard on behalf of a certain user, you need to be at or above that user’s level in the hierarchy, as well as being able to share a dashboard.

You can preview dashboards exactly how other users in your organization hierarchy will see them. Use this feature to confirm that you’re sharing precisely what you intend to share with a user and to make sure that the information you’re sharing with each user is correct, important, and actionable.

Qtip: Previewing a hierarchy as another user is not the same as the “View As” functionality. “View As” is an administrative ability where account owners can view all of Studio as any other user. When previewing a hierarchy, you can only view users located lower in the hierarchy than you, and you can only view the dashboard, the goal being to confirm that the user you’re looking at can see the correct data. Because of this, you can’t drill into feedback or view document explorer when previewing a hierarchy.
  1. Sign in to Studio.
  2. Navigate to the dashboard with an organization hierarchy applied.
  3. Click the Share button in the dashboard header.
    Click the Share button in the dashboard header.
  4. Locate the user on whose behalf you wish to preview the dashboard depending on their sharing status. If the dashboard is already shared with the user, locate them in the Previously Shared section.
     If the dashboard is already shared with the user, locate them in the Previously Shared section.
  5. If the dashboard has not been shared with the user, start typing the user’s Studio email address into the Enter users or groups to share with box and select the email from the options displayed.
    If the dashboard has not been shared with the user, start typing the user’s Studio email address into the Enter users or groups to share with box and select the email from the options displayed.
  6. Locate the selected email address in the Add section.
    Locate the selected email address in the Add section. Click the Preview link next to the user's email.
  7. Click the Preview link next to the user’s email.
  8. The dashboard preview personalized for the selected user opens.
    The dashboard preview personalized for the selected user opens. Inside the preview click Return to Share to go back to dashboard sharing. Alternatively, click Exit Preview to cancel sharing and go back to the dashboard.

    Qtip: The preview has limited interaction and is meant to make sure the dashboard is actionable for each user.
  9. Inside the preview click Return to Share to go back to dashboard sharing.
  10.  Alternatively, click Exit Preview to cancel sharing and go back to the dashboard.