Skip to main content

Create Role

Administrators can create and assign roles to users to govern access to user-created objects in the Alteryx Analytics Cloud.

  • A role is a set of privileges that can be assigned to users.

  • A privilege governs access level to a type of object.

  • By default, all users are assigned the default role, which allows users to use the user-created object types.

  • For more information, see Privileges and Roles Reference.

As needed, you can create user roles to define different access levels for different object types.

Note

You must be an administrator to create new roles.

Note

Roles are additive. If you assign multiple roles to a user account, the user receives the highest level of access for each privilege among the assigned roles.

Note

When a role is assigned, unassigned, or modified, the changes to privileges are immediately applied to the associated user accounts. A new login is not required.

Create Role

To create a new role, please complete the following steps.

Steps:

  1. In the left nav bar, select User menu > Admin console > Roles.

  2. In the Roles page, review the list of available roles. For more information, see Roles Page.

  3. To create a new role, click Create Role.

    Create Role Dialog

  4. In the Create Role dialog, specify the following:

    1. Name: Enter a name for your role. This value must be unique among available roles.

    2. Privileges:

      1. For each of the available object types, specify the access level for the role.

      2. For more information on these privileges, see Privileges and Roles Reference.

    3. To create the role, click Save.

  5. The role is now available and can be assigned to users. See below.

For more information, see Create Role Dialog.

Example - Read-only access role

Suppose you wish to limit a set of users to read-only access to role-based objects.

Steps:

  1. In the Roles page, click Create role.

  2. In the Create Role dialog, enter the following:

    1. Name: read-only

    2. Privileges: For each available privilege, select viewer.

      Note

      Some privileges may not have a viewer access level. For these privileges, you should select none. However, users with such a role cannot access the pages where these objects are listed.

  3. Click Save.

  4. The role is now available and can be assigned to users. See below.

Example - Empty role

In some circumstances, you may wish to assign an empty role to a user. For example, you may wish to limit some administrators to only be able to configure aspects of the platform without providing access to any user-created objects.

Steps:

  1. In the Roles page, click Create role.

  2. In the Create Role dialog, enter the following:

    1. Name: empty

    2. Privileges:

    3. For every privilege, select none.

  3. Click Save.

  4. The role is now available and can be assigned to users. See below.

Assign Role

After a role has been created, you can assign it to users.

Note

Assigning a role adds the role to the user's account. It does not replace any role that is already present in the account.

Note

When you assign or unassign a role, the privileges are immediately applied to the assigned user's account. The user does not need to re-login to see the changes.

Steps:

  1. In the Roles page, locate the role to assign.

  2. On the right side of the screen, click the context menu for the role. Select Assign role....

  3. In the Assign role dialog, enter a list of email addresses for users to whom you wish to assign the role.

  4. Click Assign.

  5. The role and its associated privileges are applied immediately to the user account(s).

Modify Role

After a role has been created, you can modify it as needed.

Note

When the privileges of a role are modified, the changes are applied immediately to all users who are currently assigned the role. Before making modifications, you should review the users who could be affected. See Role Details Page.

Steps:

  1. In the Roles page, locate the role to modify.

  2. In the context menu on the right side of the page, select Edit.

  3. Review the privileges assigned to the role, and make any changes as necessary.

  4. Click Save.

  5. All users who currently have the role in their account immediately receive the changed privileges.

Unassign Role

Use the following steps to remove a role from a user account.

Note

Removing a role from a user account may remove access to objects that the user has created. If the user is the owner of these objects, some access may be removed permanently, even if the object is shared.

Steps:

  1. In the Roles page, locate the role that you wish to remove from one or more user accounts.

  2. Select the role.

  3. In the Role Details page, click the Users tab.

  4. Locate the user to un-assign the role. In the context menu for the user, select Unassign from role.

  5. The user no longer has the role in the account.

For more information, see Role Details Page.

Delete Role

Warning

You are permitted to delete roles that are still assigned to users. Deleting a role removes the role from all user accounts and cannot be undone. Before you delete a role, you should review the list of affected users and the objects to which they have access.

Steps:

  1. In the Roles page, locate the role to delete. In the context menu, select Delete.

  2. Confirm the deletion.

  3. The role is deleted. All users who had the role can no longer access the privileges assigned in the role.

See Roles Page.

In this section: