Add Roles to a Workapp

Applies to

  • Enterprise
Smartsheet Advance Package


Who can use this capability

Any licensed user in a qualified plan can build a WorkApp. Only the WorkApp builder can create and assign roles for that WorkApp. WorkApp builders with a WorkApps Collab Pack or Smartsheet Advance plan can share their WorkApp with anyone. 

Atfer you add pages to your WorkApp, create Roles to control which pages different stakeholders can view and edit.

Permission levels in WorkApps roles are independent of the Smartsheet permission levels for collaborators on the source item. If you share a WorkApp with someone, you do not need to grant them access to each Smartsheet item contained in the WorkApp.

Here are some examples of how you might use this capability:

  • Reveal different parts of a project to specific roles. You could create a role for Project Managers, which allows people in that role to edit the entire project plan and view the metrics dashboard. You can also create a separate role for Assignee, which hides the metrics dashboard and only allows the people in that role to edit a report that displays their assigned work.
  • Give a user access to a report outside of Smartsheet. A user not shared to an Open Requests report in Smartsheet can be granted editor access to the same report through WorkApps roles. This collaborator will not be able to see or interact with the report in Smartsheet, but they will be able to access it in the WorkApp.
  • Target work assignments Leverage the Current user filter on a report and set the page permission to editor. The report will display only the rows that are relevant to the collaborator. The collaborators in a role with editor permissions for the page will be able to edit values in rows assigned to them in the WorkApp.  

Create and edit roles

  1. Select the Roles icon from the left rail.
  2. Select Add Roles.
  • To edit or remove (delete) an existing role, select the menu icon to the right of the role name and select Edit or Delete.


Settings for WorkApps roles

Role Settings

On the settings page, you can: 

  • Name the role by selecting the bold role name at the top of the panel.
  • Add People to a role.
  • View people assigned to a specific role on the People tab. Collaborators can have more than one role and can switch between those roles. 
  • Delete people you no longer want assigned to a role.
  • Control role permissions for each page in your app f
  • Arrange page order. Hover over the page name and drag it up or down the list when the drag icon is displayed.

Page permission reference

As you create roles, you’ll need to keep the page-level permissions in mind. As a best practice, give people the lowest permission needed while still providing access to the assets they need. 

Role permissions are independent of the collaborator’s permissions on the source item in Smartsheet.

The following table outlines page permissions per role.

Page permission

What people with this permission can do


An Editor can edit rows, cells, and add attachments.

For dashboards, forms, and web content, this permission is the same as Viewer.


Viewer provides a read-only view of the page.

Viewers can fill out forms, pages, and interact with web content pages the same way they would in a separate browser window.


Hidden will hide the page from collaborators.

Hidden is the default permission of each page when you create a new role.