Skip to content

Roles & Permissions

Configure access control with roles and permissions.

Roles and permissions allow you to control what each staff member can do in your store's administration panel. This ensures security and prevents unauthorized access to sensitive areas.

Overview

The access control system consists of:

  • Roles - Groups of permissions assigned to users
  • Permissions - Individual actions a user can perform

Accessing Roles & Permissions

  1. Click on Settings in the sidebar
  2. Select Staff & permissions

The page opens with the title Administrators & roles. Your roles appear as cards under Administrator role available, each with its number of accounts and a View details link that opens the role.

Understanding Permissions

Permissions control access to specific actions:

Permissions

Permission Categories

Permissions are sorted into groups. Most groups hold the same five permissions for one area of the admin: Browse (see the list), Read (open a record), Edit, Add and Delete.

CategoryExamples
SystemAccess Dashboard; Access Setting (all store settings except staff, roles and permissions); Views Users (staff accounts, roles and permissions)
BrandsBrowse, read, edit, add and delete brands
CategoriesBrowse, read, edit, add and delete categories
CollectionsBrowse, read, edit, add and delete collections
ProductsBrowse, read, edit, add and delete products, plus the same five permissions for inventories, attributes, reviews, product variants, suppliers and tags
CustomersBrowse, read, edit, add and delete customers
OrdersBrowse, read, edit, add and delete orders. There is no separate permission for refunds
DiscountsBrowse, read, edit, add and delete discounts

Permissions created without a group are listed under Custom permission.

Browsing Permissions

Open a role with View details and click the Permissions tab. Every permission is listed by group, with a checkbox that shows whether the role has it and the date it was created:

Browse Permissions

Managing Roles

Creating a Role

To create a new role:

  1. On the Administrators & roles page, click the + button next to Administrator role available (its tooltip reads Add new role)
  2. Enter the Name (in lowercase), for example "manager"
  3. Enter the Display name shown in the admin, for example "Manager", and a Description
  4. Click Save
  5. Open the new role with View details, click the Permissions tab and check the permissions the role needs. Each checkbox is saved as soon as you click it
Add Role

Role Fields

FieldDescription
Name (in lowercase)Internal name of the role, unique (e.g., "store_manager")
Display nameName shown in the admin (e.g., "Store Manager")
DescriptionWhat this role is for

Permissions are not part of this form: you check them on the role's Permissions tab once the role exists.

Updating a Role

Open the role with View details. The role page has three tabs:

  • Role: change the Name (in lowercase), Display name and Description, then click Update. Editing the name fills the display name for you. On the Administrator role, a warning reminds you that a wrong change could block your access to the dashboard
  • Users: the staff members who have this role
  • Permissions: check or uncheck the permissions of the role

A role you created can be removed with the Delete button at the top of its page. The Administrator and Manager roles that Shopper installs cannot be deleted.

Update Role
Update Role

Changes apply immediately to all users with that role.

Creating Permissions

Add custom permissions for your specific needs from a role's page. Two buttons at the top of the page, shown to Administrator accounts only, create permissions and give them to that role straight away:

  • Create permission opens the New permission window. Pick a Group name (optional), enter the Permission name (in lowercase) (up to 30 characters, unique), the Display name (up to 75 characters) and a Description, then click Save
  • Generate permissions creates the five standard permissions (browse, read, edit, add and delete) for one area in one go. Enter the Resource name, for example "shipments", pick a Group name if you want, check the list under Permissions that will be created, then click Generate permissions

A new permission only controls something once your developer checks it in the admin or in a custom screen. Creating it does not restrict anything on its own.

Add Permission
Add Permission Form

Creating or deleting a permission requires an Administrator account. Other staff members can still grant existing permissions to roles, but only permissions they hold themselves, and they cannot modify the Administrator role.

Custom Permissions

Create permissions tailored to your business. Permissions created without a group appear under Custom permission on the role's Permissions tab. A permission made with Create permission has a trash icon that lets an Administrator delete it; the permissions Shopper installs and those made with Generate permissions cannot be deleted.

Custom Permissions

Common Role Examples

Store Manager

Full operational access:

  • All product permissions
  • All order permissions
  • All customer permissions
  • Access Setting only if they manage the store settings, as it opens all of them at once

Content Editor

Focus on catalog management:

  • View/edit products
  • View/edit categories
  • View/edit collections
  • No order or customer access

Support Agent

Customer service focus:

  • Browse and read orders
  • Browse and read customers
  • Edit orders only if they handle order changes
  • No product management

Marketing

Promotional access:

  • View products
  • Manage discounts
  • Manage collections
  • No customer data access

Best Practices

Start Restrictive

Begin with minimal permissions and add as needed.

Group Logically

Create roles that match actual job functions.

Review Regularly

Audit roles periodically to ensure they're still appropriate.

Document Roles

Keep clear descriptions of what each role can do.

Permission Hierarchy

Some permissions may depend on others. For example, to edit a product, a user typically also needs the Browse permission to reach the product list.

When assigning permissions, consider:

  1. Browse - Can see the list
  2. Read - Can open a record and see its details
  3. Add - Can add new items
  4. Edit - Can modify existing items
  5. Delete - Can remove items (most sensitive)

Security Considerations

  • Know who has access - The Users tab of each role lists its members. Shopper does not keep a history of who changed what
  • Separation of duties - Don't give one person all permissions
  • Regular reviews - Remove unnecessary access
  • Test roles - Verify permissions work as expected

For developer details, see the Roles & Permissions documentation.

Last updated on

Edit on GitHub