Skip to main content
All CollectionsHelp ArticlesAccess and PermissionsUser Permissions
How do I assign users access to Forms? (Role-Based Permissions)
How do I assign users access to Forms? (Role-Based Permissions)
Updated over a week ago

For organizations using Role-Based Permissions, user access to Forms is determined by their Role. Follow the steps listed below to learn how to add Form permissions to a Role.

Step 1: Select the Role

In the Administrator view, expand the Access Control category on the navigation bar and select ‘Users’.

In the Account Management app, select Roles from the navigation bar.

Click the pencil icon next to the Role you want to add permissions for.

Step 3: Edit the permissions

Scroll to the Permissions section of the page, where the Forms tab will be open by default.

The first column lists every Tier 1 form in your site with their subsequent Tier 2 forms indented below them. You can use the search bar to filter the results by name. The first row lists the available access you can grant users per form.

  • View allows users to see data entered on any record of this form.

  • Search allows users to search for any record of this form.

  • Create allows users to create new records of this form.

  • Edit (Records) allows users to make changes to data entered on records of this form.

  • Archive allows users to archive or delete records of this form.

    • Note: This is a powerful capability, and access should be very carefully selected.

  • Ignore Program Assignment allows users to view all records of this form regardless of the record’s program assignment.

  • Caseload requires that participants are assigned to a caseload before users can access their information.

  • View Secure Fields allows users to view all secure field data within records of this form and view reports that contain that secure data.

  • Edit (Forms) allows users to make changes to the form selected.

The toggles in the column headers function as a Select All option. A gray toggle indicates that users assigned to this role cannot perform this action for any record. Once a permission box is checked, the gray toggle will turn yellow, indicating that users are able to perform the action for some but not all records. Clicking the toggle itself will then check the permission box for every available record. The toggle will turn green to indicate that users have access to perform this action for all available records. You can click the toggle once again to uncheck all boxes at once or select the Undo button at the top to revert your most recent changes.

Step 4: Save your changes

To confirm your selected permissions, click Update in the bottom-right corner.

What else do you need help with?

Did this answer your question?