Role Permission Reference Guide (what each toggle does)

Ayesha
Ayesha
  • Updated
This article explains how to configure user roles and permissions in Xenia to ensure secure and efficient workspace management. You will learn the key permission areas, role restrictions, and best practices to properly assign access rights.

1. Overview of Key Role Permissions

This article offers a concise overview of the key permissions within Xenia's role settings, detailing each section's function, emphasizing critical permissions, and highlighting potential points of concern. Consider this your reference guide. For a comprehensive written analysis, please refer to the article version, which can be easily bookmarked for future use.

Overview of Key Role Permissions

2. Limit Workspace Permissions to Admins

Configure Workspace Settings Controls access to workspace-level settings (timezone, currency, workspace name, working hours). Toggle this on for admins and owners only. Frontline and store-level roles do not need this. Who should have it: Admin, Owner only

Manage Billing Gives access to the billing page — the user can upgrade, downgrade, or cancel the subscription. Keep this extremely restricted. Who should have it: Owner only (or one designated billing admin)

Kiosk Mode (Mobile & Tablet) Controls the ability to enable/disable kiosk mode and configure PIN settings on both the web settings page and store devices. Users with this on can toggle kiosk mode on any device they're logged into. Who should have it: Admin, Owner (and possibly store-level accounts if you use kiosk mode)

Configure Single Sign-On (SSO) Allows the user to enable and configure SSO settings for the workspace. Admin/Owner only. Who should have it: Admin, Owner only

Activity Logs Gives access to the activity logs view in Settings — a record of actions taken in the workspace. Who should have it: Admin, Owner only

Limit Workspace Permissions to Admins

3. Restrict HRIS Permissions to Admins and Managers

HRIS permissions, including access, integration viewing, HRIS management, and all related integration permissions, should be restricted to administrators and managers only.

Restrict HRIS Permissions to Admins and Managers

4. Restrict User Management to Admins

Add or Remove Members (Users) Controls the ability to invite new users and delete existing users. Hides the invite/delete functions when off. Who should have it: Admin, Owner. Optionally for HR Manager roles.

Manage Teams Shows or hides the Teams tab entirely. When off, the Teams section disappears from the navigation. Who should have it: Admin, Owner. Optionally for managers who need to create and manage teams.

Manage Custom Roles Controls the ability to create, edit, and delete custom roles. When off, the Roles tab management options are hidden. Who should have it: Admin, Owner only

Manage Admins Controls the ability to promote or demote a user to the Admin role. Also controls the "All Locations" toggle on user profiles. Who should have it: Owner only (or senior admin)

Manage Owners Controls the ability to promote or demote a user to the Owner role. Who should have it: Owner only

Restrict User Management to Admins

5. Configure Task Permissions and Visibility

Access Tasks The master on/off switch for the Tasks feature. When off, the Tasks tab is hidden entirely on web and mobile. Who should have it: All roles that need to complete or view tasks (essentially everyone except pure requesters)

View Your Own Tasks (single-select — choose one of the three) Shows only tasks directly assigned to this user, their team, their role, or their location. Who should have it: Frontline employees, cashiers, cooks, basic operators

View Your Own Tasks + Tasks Assigned to Others at Your Location (single-select) Shows own tasks plus all tasks tagged to any location the user is a member of. Who should have it: Store managers, shift managers, GMs, district managers

View All Tasks (single-select) Shows every task in the workspace. Location membership becomes irrelevant for task visibility. Who should have it: Admin, Owner only

Configure Task Permissions and Visibility

6. Manage Tasks and Projects Visibility

Manage Tasks Controls the ability to create, edit, and delete tasks. Also shows/hides bulk action options. Note: works in conjunction with task visibility — you can only manage tasks you can see. Who should have it: Store managers and above. Off for basic frontline roles. ⚠️ Important: Manage Tasks also controls visibility of the Scheduled Work / Projects tab. If this is off, users cannot see or access Projects — even if they have the Create Projects permission.

Change Status of Your Own Tasks Controls the ability to change the completion status of tasks assigned to or created by this user. Who should have it: All roles that complete tasks — should be on for everyone

Change Status of Others' Tasks Controls the ability to change the status of tasks not personally assigned to this user. Who should have it: Store managers and above. Off for frontline roles.

Manage Tasks and Projects Visibility

7. Control Operations Templates Access

Access Operations Templates Master on/off for the Templates module. When off, the Templates tab is hidden entirely on all devices. Who should have it: All roles that need to complete or view checklists — turn this on for virtually everyone except pure task-only roles

Manage Templates Controls the ability to create, edit, archive, and delete templates in the template builder. Also controls access to template configurations like flagged item categories. When off: user can still complete and submit templates, but cannot modify the template structure. Who should have it: Admin, Owner only. ❌ OFF for all store-level and frontline roles. ⚠️ This is the most important permission to restrict. Frontline staff with this on can accidentally archive or edit your production checklists.

Control Operations Templates Access

8. Manage Announcement Feature Permissions

Access Announcements Controls whether the user can view announcements deployed to their locations. Who should have it: Any role that should receive company announcements — usually all roles

Manage Announcement Feature Permissions

9. Restrict Location Permissions to Admins

Access Locations Controls whether the user can view the Locations tab and see location details. Who should have it: Admin, Owner, District/Regional managers who need location visibility

Add Locations Controls the ability to create new locations in the hierarchy. Who should have it: Admin, Owner only

Edit Locations Controls the ability to edit existing location details (name, address, hierarchy placement). Who should have it: Admin, Owner only. Keep this off for all other roles to prevent accidental hierarchy changes.

Delete Locations Controls the ability to remove locations from the workspace. Who should have it: Admin, Owner only. ❌ Keep this off for everyone else. Deleting a location doesn't delete historical data but makes it much harder to filter.

Restrict Location Permissions to Admins

10. Assign Approval Permissions to Managers

Approval permissions should enable users to view, edit, or manage approvals. These permissions should be activated for all managerial roles.

Assign Approval Permissions to Managers

11. Set Reporting Permissions

View Dashboard Templates (Preset Dashboards) Controls access to Xenia's built-in preset reporting dashboards. When off, the preset dashboards tab is blank. Who should have it: Any role that uses reporting — managers and above

Manage Custom Dashboards Controls the ability to create, edit, and share custom dashboards. Also affects visibility of the reporting tab in some configurations. Who should have it: Admin, Owner. Optionally for senior analytics users.

Set Reporting Permissions

12. Configure Project Permissions and Frontline Restrictions

Create Projects Controls the ability to create new projects in the Projects feature. ⚠️ Important dependency: Create Projects requires Manage Tasks to also be ON. If Manage Tasks is off, the Projects/Scheduled Work tab is hidden and this permission has no effect. Who should have it: Admin, Owner. Optionally for senior operations managers.

Configure Project Permissions and Frontline Restrictions

13. Review Optional Permissions Settings

Access Assets Controls access to the Assets module (equipment tracking, asset QR codes). Who should have it: Roles involved in facilities/maintenance work. Off for frontline operational roles that don't interact with assets.

Access Chat / Messaging Controls access to the internal messaging and team chat features. Who should have it: Any role that needs team communication

Access Documents / Docs Controls access to the Docs/knowledge base module. Who should have it: Any role that needs to reference SOPs, training materials, or company documents

Access All — Unrestricted Access (Admin Bypass) The master bypass permission. When on, this user can bypass almost all template-level restrictions and access controls across the platform. Even if a template is locked down to specific submitters, a user with this on can still access and edit it. Who should have it: Admin, Owner only. Extremely restricted. This is the failsafe that ensures an admin can always fix access problems.

Review Optional Permissions Settings

14. Complete Permission Guide and Thanks

Quick Reference: Recommended Settings by Role Type

PermissionFrontline/CrewStore ManagerDistrict ManagerAdmin
Access Tasks
Task VisibilityOwn OnlyOwn + At LocationsOwn + At LocationsView All
Manage Tasks
Assign to Any
Access Templates
Manage Templates
Access LocationsOptional
Add/Edit/Delete Locations
Add/Remove Users
Manage Teams
View DashboardsOptional
Access All (Bypass)
This article provides a comprehensive reference for configuring user roles and permissions in Xenia. It covers key permission areas, recommended role restrictions, and best practices to ensure secure and efficient workspace management. For more information, explore related articles on role configuration and workspace security.

Need Help
Reach out to us at Support@xenia.team

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request

Comments

0 comments

Please sign in to leave a comment.