XM Directory Roles

About XM Directory Roles

Do you have multiple directories and want to give access to some directories for certain users, and different directories for other users? This can be accomplished using role-based access control with XM Directory. With this feature, Brand Administrators can choose which specific users have access to which directories as well as grant certain users Admin permissions over specific directories.

Necessary Brand Permissions

Before you can use this feature, your brand must have the Manage Directory Roles permission enabled. To have this permission enabled, please contact your Customer Success Representative. You must also have this permission enabled on a user level to enable and configure roles.

Enabling Directories to Use Roles

Before you can create roles, you need to choose which directories can be controlled by roles.

1. Navigate to the XM Directory by clicking Directories.
   
2. Select a directory using the dropdown menu.
3. Click Directory Settings.
4. Select Manage Directory.
5. Turn on Enable role-based access.

Creating Directory Roles

1. Navigate to the XM Directory by clicking Directories.
   
2. Click on the name of the currently selected directory
3. Select Roles.
4. Click Create a role.
   
5. Give your role a name.
   
6. Click Create.
7. Click Add a directory and select the directory you want this role to have access to. Users will be able to create and edit mailing lists as well as send emails in this directory.
   
   Qtip: If you don’t see your desired directory here, then that directory has not been enabled for role based access. See Enabling Directories to Use Role-Based Access to learn how to enable your directory.
   Qtip: You can add multiple directories to one role.
8. If desired, determine the additional directory privileges this role has by enabling or disabling the following options:
   
   • Manage directory: When enabled, this privilege gives users administrative access to the directory, allowing them to manage the directory settings.
9. Click Add Users to add users to the role.
10. Search for users by typing their username.
    
    Qtip: You can add multiple users to a role.
11. When finished, click Add.

Managing & Deleting Directory Roles

After you create your role, you can change the role privileges and which users are in the role at any time. You can also rename your role or delete the role entirely if needed.

1. Click the pencil icon next to your role name to edit it.
2. Click the trash can icon next to your role name to delete it.
   Qtip: Once a role is deleted, it is irretrievable!
3. Click the X next to a user to remove them from the role.
4. Click the X next to a directory name to remove the directory from the role.

Platform vs. Role-Based Permissions

There are two ways to give users access to directories: through platform permissions and through role-based permissions. This section explains each the differences between these permissions.

• Platform Permission: The individual user permissions found in the Admin page.
  
• Role-Based Permission: The permissions granted to a user via XM Directory roles. These permissions are applicable to directories that have role-based access enabled.
  

Explanation of Permission Types

• Platform Manage Directory Roles permission​: A user with the Manage Directory Roles permission can enable and disable role-based access for directories. The user can also access the roles configuration to view and edit roles for directories where role-based access is enabled.
• Platform Access XM Directory permission: ​A user with the Access XM Directory permission will be able to create and edit mailing lists and use the distribution features on all directories where role-based access is disabled.
• Platform Manage Directory permission: ​A user with Manage Directory permission will be able to access the directory admin features such as directory contacts and directory settings on all directories where role-based access is disabled. This user will be able to view and edit directory contacts, access mailing lists, automations, directory-level summaries and settings.
• Role-Based Access Directory permission: ​A user with the Access Directory role-based permission will be able to create and edit mailing lists and use the distribution features for directories where role-based access is enabled and the user has been added to a role with access to the directory.
• Role-Based Manage Directory permission: ​A user with the Manage Directory role-based permission will be able to access the advanced and management features for directories where role-based access is enabled and the user has been added to a role with access to the directory. This user will be able to view and edit directory contacts, access mailing lists, automations, directory-level summaries and settings.