What are roles in Mitti?

Roles define what users can do in Mitti. In most organizations, team members have different responsibilities and need different permissions. For example, a site supervisor shouldn't have the same permissions as a global admin, and a frontline worker shouldn't have the same permissions either. Roles let organizations match each user's permissions to their actual job. There are two types of roles:

  • Global roles apply across your entire organization.

  • Group and site roles apply only within the sites or groups a user is assigned to.

Assigning these roles allows organizations to delegate user and document management to site supervisors or regional managers without giving them full admin permissions. Control stays with the people who run each group or site, while admins focus on the wider organization.

The Roles page with the Global tab open.

For existing users, the Permissions tab is now called Roles, and permission sets are now called global roles that work exactly the same way.

Managing site or group roles is only available to organizations on Enterprise Plan. By default, all users in an organization on Free Plan have the "Administrator" global role.

Create a global role

  1. Log in to the web app (opens in new tab).

  2. Click your organization name on the lower-left corner of the page and select Roles.

  3. Click Create at the upper-right corner of the global role list and select Create global role.

  4. Configure the following details accordingly:

    • Name: Enter the role name.

    • Description: Enter the role description.

    • Seat type: Click the dropdown and select the seat type.

    • Select permissions: Select the permissions you want to assign to the role.

  5. Click Create role at the upper-right of the page.

Select permissions in the “Create global role” page to create a global role.

The seat type for a global role can't be changed once it's created.

Create a group or site role

  1. Log in to the web app (opens in new tab).

  2. Click your organization name on the lower-left corner of the page and select Roles.

  3. Click Site or Group at the top of the page.

  4. Click Create at the upper-right corner of the role list and select Create site role or Create group role.

  5. Configure the details accordingly:

    • Name: Enter the role name.

    • Description: Enter the role description.

    • Applies to: Click the dropdown and select whether the role will apply to sites, groups, or both.

    • Select permissions: Select the permissions you want to assign to the role.

  6. Click Create role at the upper-right of the page.

Select permissions to apply when creating a group or site role.

Edit a role

  1. Log in to the web app (opens in new tab).

  2. Click your organization name on the lower-left corner of the page and select Roles.

  3. Click Global, Site, or Group at the top of the page.

  4. Click the role.

  5. Edit the role details accordingly:

    • Name: Hover over the role name and click . Enter the new name, then press Enter.

    • Description: Hover over the role description and click . Enter the new description, then press Enter.

    • Permissions: Click Permissions tab at the top of the page, then check or uncheck the permissions. Then, click Save on the lower-right of the page.

Edit a role to update role details.

Delete a role

Deleting is irreversible, and we cannot restore permanently deleted items. Confirmation is always required before any deletion, so be sure you're not accidentally deleting the wrong item.

  1. Log in to the web app (opens in new tab).

  2. Click your organization name on the lower-left corner of the page and select Roles.

  3. Click Global, Site or Group at the top of the page.

  4. Click the role.

  5. Click on the upper-right of the page, and select Delete role.

  6. In the pop-up window, click Delete.

The role details page showing the option to delete the role.

A role can't be deleted while users are still assigned to it.

Limitations

  • Site roles cover user and document management only. Group roles cover user management only. You can't add other permissions, such as template or inspection permissions, to a group or site role. To add other permissions, use a global role.

  • Group and site roles can only be assigned to users on a full seat. Users in lite and guest seats aren't supported.

  • You can't delete the default Administrator global role.

  • You can't edit or delete the default Member role for groups and sites.

  • You can't add Documents permissions to a group role.

Frequently asked questions