document-understanding
latest
false
UiPath logo, featuring letters U and I in white

Document Understanding User Guide

Last updated Sep 8, 2025

Creating a custom role

Apart from the default Document Understanding roles, you can also create and manage custom roles. Adapting custom roles to specific needs and permissions helps align them with organizational requirements.

Custom roles are available at both the tenant level, and the project level.

Tenant-level roles

The tenant-level roles can grant the following permissions:

Table 1. Standard permissions
Permission TypePermissionDescription
Authorization / ActionReadRead allows the users to read the actions or permissions when creating a custom role or when viewing a role.
Authorization / RoleReadView all roles.
Authorization / RoleUpdateUpdate custom roles.
Authorization / RoleCreateCreate custom roles.
Authorization / RoleDeleteDelete custom roles.
Authorization / Role AssignmentReadView all existing role assignments.
Authorization / Role AssignmentUpdateUpdate existing role assignments.
Authorization / Role AssignmentCreateCreate new role assignments.
Authorization / Role AssignmentDeleteDelete existing role assignments.
Document Understanding - Tenant SettingsReadRead Document Understanding tenant-level settings.
Document Understanding - Tenant SettingsUpdateUpdate Document Understanding tenant-level settings.
Document Understanding - Tenant SettingsCreateCreate Document Understanding tenant-level settings.
Table 2. Additional permissions
Permission TypePermissionDescription
Authorization / Role AssignmentExport role assignment dataExport role assignment data from the user interface.

Project-level roles

The project-level roles can grant the following permissions:

Table 3. Custom role project-level permissions
Permission TypePermissionDescription
Authorization / ActionReadRead allows the users to read the actions or permissions when creating a custom role or when viewing a role.
Authorization / RoleReadView all roles.
Authorization / RoleUpdateUpdate custom roles.
Authorization / RoleCreateCreate custom roles.
Authorization / RoleDeleteDelete custom roles.
Authorization / Role AssignmentReadView all existing role assignments.
Authorization / Role AssignmentUpdateUpdate existing role assignments.
Authorization / Role AssignmentCreateCreate new role assignments.
Authorization / Role AssignmentDeleteDelete existing role assignments.
Document Understanding - ClassifierReadView all classifiers.
Document Understanding - ClassifierUpdateUpdate classifiers.
Document Understanding - ClassifierCreateCreate classifiers.
Document Understanding - ClassifierDeleteDelete classifiers.
Document Understanding - Data Set ExportReadRead data set exports from a project version.
Document Understanding - Data Set ExportCreateExport data sets from a project version and manage the visibility of the download document(s) button.
Document Understanding - Data Set ExportDeleteDelete data set exports from a project version.
Document Understanding - Document TypeReadRead document types.
Document Understanding - Document TypeUpdateUpdate document types.
Document Understanding - Document TypeCreateCreate document types.
Document Understanding - Document TypeDeleteDelete document types.
Document Understanding - DocumentsDeleteDelete documents from a project.
Document Understanding - ExtractorReadView extractors.
Document Understanding - ExtractorUpdateUpdate extractors.
Document Understanding - ExtractorCreateCreate extractors.
Document Understanding - ExtractorDeleteDelete extractors.
Document Understanding - Monitor Processed DocumentsReadView processed documents.
Document Understanding - Monitor Processed Documents Detail ReadView details for processed documents
Document Understanding - Monitor Project PerformanceReadView the project performance.
Document Understanding - ProjectReadView projects.
Document Understanding - ProjectUpdateUpdate projects.
Document Understanding - ProjectCreateCreate projects.
Document Understanding - ProjectDeleteDelete projects.
Document Understanding - Project VersionReadView project versions.
Document Understanding - Project VersionUpdateUpdate project versions.
Document Understanding - Project VersionCreateCreate project versions.
Document Understanding - Project VersionDeleteDelete project versions.
Document Understanding - Project Version LabelReadView project version labels.
Document Understanding - Project Version LabelUpdateUpdate project version labels.
Document Understanding - Project Version LabelCreateCreate project version labels.
Document Understanding - Project Version LabelDeleteDelete project version labels.
Table 4. Additional permissions
Permission TypePermissionDescription
Authorization / Role AssignmentExport role assignment dataExport role assignment data from the user interface.
Document UnderstandingUse extractors and classifiers from projects.Use the same extractors and classifiers used inside projects.

Creating a custom role

To create a custom role:
  1. Navigate to your respective Automation CloudTM URL and log in with your UiPath® account.
  2. From the left-side navigation pane, select Document Understanding.
  3. Select the Manage access button.

    docs image
  4. Go to the Roles tab, select Create role, and fill in the following fields:
    • Role name - Give your role a descriptive name.
    • Description - Optionally, provide a description.
    • Category - Choose between:
      • Tenant - You can assign this role at tenant-level. It consists of tenant-level permissions.
      • Project - You can assign this role to existing or new projects. It consists of project-level permissions.
  5. Select Next to proceed to the permissions page.
  6. In the Standard permissions and Additional permissions tabs, select the permissions to assign to the custom role.
  7. Select Create.

Viewing a custom role

To view a custom role:
  1. Navigate to your respective Automation CloudTM URL and log in with your UiPath® account.
  2. From the left-side navigation pane, select Document Understanding.
  3. Select the Manage access button.
  4. Go to the Roles tab and select the ellipsis for the custom role you want to view.
  5. Select View.

Editing a custom role

To edit a custom role:
  1. Navigate to your respective Automation CloudTM URL and log in with your UiPath® account.
  2. From the left-side navigation pane, select Document Understanding.
  3. Select the Manage access button.
  4. Go to the Roles tab and select the ellipsis for the custom role you want to view.
  5. Select Edit to modify the description and permissions of the custom role.
  6. After making the changes, select Update.

Duplicating a custom role

To duplicate a custom role:
  1. Navigate to your respective Automation CloudTM URL and log in with your UiPath® account.
  2. From the left-side navigation pane, select Document Understanding.
  3. Select the Manage access button.
  4. Go to the Roles tab and select the ellipsis for the custom role you want to view.
  5. Select Duplicate & customize, to create a copy of the role and modify its description and permissions.
  6. After making the changes, select Create.

Removing a custom role

To remove a custom role:
  1. Navigate to your respective Automation CloudTM URL and log in with your UiPath® account.
  2. From the left-side navigation pane, select Document Understanding.
  3. Select the Manage access button.
  4. Go to the Roles tab and select the ellipsis for the custom role you want to view.
  5. Select Delete.
    Note: Deleting a custom role also removes all associated role assignments.

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo
Trust and Security
© 2005-2025 UiPath. All rights reserved.