Overview
Simple Roles make it easier to manage access for teams that work across many facilities. A Simple Role has one set of permissions for the Corporate level and one for all facilities. The facilities are chosen for each user. This makes it possible to create one role per job, for example, Store Manager, instead of a separate role for every group of facilities. Knowing how Simple Roles work, and the order in which they are set up, helps give every user the access they need without locking anyone out.
Key Concepts
These terms appear on the Roles & Permissions and user screens, or are used in this article to explain how Simple Roles work in QuikStor.
Role Type – The type chosen when a role is added: Simple or Advanced. The role type cannot be changed after the role is created.
Simple Role – A role with one set of permissions for Corporate and one for all facilities.
Advanced Role – A role with permissions set for Corporate and for each facility separately. All roles that existed in QuikStor before Simple Roles were introduced are Advanced Roles, and they work the same way as before.
All Facilities – The tab of a Simple Role that holds its facility permissions.
Facility Assignees – The field where the facilities of a user with a Simple Role are selected. At least one facility is required.
How It Works
A Simple Role has two sets of permissions. The Corporate permissions control what the user can do at the Corporate level. The All Facilities permissions control what the user can do at a facility. Simple Roles use the same permissions as Advanced Roles, so there are no new permissions to learn.
The Corporate and All Facilities tabs of the Store Manager role, the two sets of permissions of a Simple Role
A new Simple Role starts with every permission turned off, so it is set up in a fixed order: add the role, set its permissions, and then assign it to users.
The role does not include any facilities. Instead, each user's facilities are selected under Facility Assignees when the role is assigned to them. This way, one Simple Role can be given to many users, and each user can have different facilities. A user with a Simple Role can work only at the facilities selected for them.
A Simple Role gives the same facility permissions at every facility the user is assigned to. If a user needs different access at different facilities, for example, full access at one facility and view-only access at another, an Advanced Role is needed instead.
After the Simple Role is assigned, a user's facilities can be changed at any time without changing the role, and the change does not affect other users with the same role. This makes quick changes easy, for example, giving an employee access to a colleague's facility while the colleague is on vacation. Facilities added to the company later are not given to users with a Simple Role automatically, so each user who needs a new facility must have it added under Facility Assignees.
A change to the permissions of a Simple Role, on the other hand, applies to every user who has the role, at all of their facilities. The change takes effect right away, even for users who are already signed in. Until they refresh the page, they may still see the same buttons. However, if they try an action they no longer have permission for, the action is not completed and a message appears.
Using the Feature
A Simple Role is set up in three steps, in this order. All three are done at the Corporate level.
⚠️ Warning: A user who is assigned a Simple Role before its permissions are set sees "No Permissions – You do not have permissions to see this page" on every screen. Set and save the permissions of a Simple Role on the Corporate and All Facilities tabs before assigning it to any user, including your own user.
Adding a Simple Role
A Simple Role is added from Users > Roles & Permissions in the sidebar menu by clicking Add New. In the Add New Role drawer, enter the Role Name, for example, Store Manager, and an optional Description of up to 500 characters. Under Role Type, select Simple. Advanced is selected by default, so Simple needs to be selected each time. The Active toggle is on by default, and inactive roles cannot be assigned to users. Clicking Add Role creates the role.
Adding the Store Manager role from Roles & Permissions, with Simple selected as the Role Type
ℹ️ Info: After a Simple Role is added, the message "You have successfully created [Role Name] role" appears, and the new role is listed on the Roles & Permissions screen with Simple in the Type column.
Setting the Permissions of a Simple Role
The permissions of a Simple Role are set on its permissions screen, which opens by clicking the name of the role on the Roles & Permissions screen. Permissions can be turned on one at a time, for a whole permission group with its Enable all, or for the whole tab with Enable all at the top of the screen.
Save Permissions is grayed out until at least one permission is turned on or off. After the Corporate tab, the permissions on the All Facilities tab are set the same way, and clicking Save Permissions saves both tabs together.
Opening the Store Manager role from Roles & Permissions and setting its permissions on the Corporate and All Facilities tabs before saving
ℹ️ Info: After the permissions are saved, the message "Role [Role Name] updated successfully." appears.
Assigning a Simple Role to a User
A Simple Role is assigned to a user from Users > List in the sidebar menu. Click the name of the user, and then click the pencil icon next to Role to open the Edit User Role drawer. The Role list shows the type after each role name, for example, Store Manager • Simple. When a Simple Role is selected, the Facility Assignees field appears. Select the user's facilities, or click Select All, and then click Save Role. The same fields appear when a user is added with Add New on the Users screen, and when a user is edited in the Edit User drawer.
Assigning the Store Manager role to a user from the Users list, with the user’s facilities selected under Facility Assignees
Saving replaces the user's previous list of facilities.
ℹ️ Info: After the role is saved, the message “Role successfully updated.” appears, and the user’s profile shows the role and the assigned facilities.
FAQ
These are the most commonly asked questions about Simple Roles in QuikStor.
1. What happened to the roles that already existed?
All roles that existed before Simple Roles were introduced are now Advanced Roles. Their permissions, users, and facilities did not change, and they work the same way as before.
2. Can a Simple Role be changed to an Advanced Role?
No, the role type cannot be changed after a role is created. In the Edit Role drawer, the Role Type is shown but grayed out. There is also no option to convert a role. To switch a user from a Simple Role to an Advanced Role, or the other way around, add a new role of the other type, set its permissions, and assign it to the user.
3. Why does a user see "No Permissions" on every screen after getting a Simple Role?
The Simple Role was assigned before its permissions were set. A new Simple Role starts with every permission turned off. Open the role from the Roles & Permissions screen, set its permissions on the Corporate and All Facilities tabs, and click Save Permissions.
4. Can a user with a Simple Role have different permissions at different facilities?
No, a Simple Role gives the same facility permissions at every facility assigned to the user. If a user needs different access at different facilities, use an Advanced Role instead.
5. Are new facilities added to users with a Simple Role automatically?
No, a new facility is never added automatically, even for users whose facilities were chosen with Select All. To give a user access to a new facility, open the Edit User Role drawer and add the facility under Facility Assignees.
6. How can I tell which roles are Simple and which are Advanced?
The Roles & Permissions screen shows the type of each role in the Type column and can be filtered by type. When a role is assigned to a user, the Role list also shows the type after each role name.
Related Articles
Facility Level Permissions: Tenants, Leases, and Payments (coming soon)
Facility Level Permissions: Facility Setup and Operations (coming soon)




