Role Permissions Management
Roles define what staff can view and change in OceanBooking admin. Create or edit a role's permissions, then assign that role to users. Assignments can be limited by location when Multiple Locations is enabled.
Most permission rows use View and Edit buttons. View generally permits reading; Edit permits changes and includes View. Both off means None. Some rows offer only View or only Edit. Read the row description: Add customers to classes uses View for pass-only booking and Edit for booking with or without a pass.
Multiple roles add permissions; they do not subtract them. For the applicable location, Edit takes precedence over View, and None in one role does not cancel a grant in another. Review all of a user's assigned roles when access is broader than expected. Keep the core Instructor role for teaching identity; reduce its shared permissions before adding custom roles for extra responsibilities.

Tutorial Video
Where is Permissions Settings?
- Open Settings → Roles and Permissions.
- The View tab lists users and their assigned roles. Use Add users to assign roles, or open an existing user to edit their complete role set.
- To change what a role can do, choose Manage roles, then open the role or choose Add role.
- Use the All locations context for role management. Opening Settings and Roles and Permissions requires the corresponding View access; changing roles or assignments requires Roles and Permissions Edit.
The role list defines access; the user assignment page determines who receives it. Editing a shared role affects everyone assigned to that role.



What is "Core Roles"?
- Account Admin: the owner-level role; its permissions cannot be edited in the role editor.
- Manager: a core staff role whose permissions can be customized. Do not assume all managers have identical financial or role-management access.
- Instructor: required for teaching identity and appearing as an instructor. Its calendar, reports and other permissions can be customized; own-class and other-instructor access are separate controls.
- Salesperson: the sales role; review its configured permissions for the responsibilities you want to grant.
Core roles cannot be deleted. Manager, Instructor and Salesperson permission sets can be edited. A custom role adds permissions but does not replace the core Instructor identity.

How the Account Holder Can View Their Own Role


Examples of Insufficient Permissions
If a page or action is unavailable, check the role's parent page permission, the specific child permission, the selected location and every other assigned role. A View grant usually cannot perform an Edit action. A disabled custom feature can also remove its permission controls.
Test with the affected staff account in a separate browser. An Account Admin test does not demonstrate what a restricted instructor can do.

How to Edit
Open Manage roles, select the role, then use Search or the page filter to find the relevant permission. Review the granted-permission summary, save and test with an assigned staff account. Parent permissions may hide dependent children; for example, Override pass defaults requires Pass management Edit.
Multiple roles add permissions; they do not subtract them. For the applicable location, Edit takes precedence over View, and None in one role does not cancel a grant in another. Review all of a user's assigned roles when access is broader than expected. Keep the core Instructor role for teaching identity; reduce its shared permissions before adding custom roles for extra responsibilities.
Add customers to classes: pass-only staff bookings
Under Calendar Management → Add customers to classes, use the normal View and Edit buttons:
- Both off (None): staff cannot add customers to classes.
- View only: staff can book only with a valid pass accepted for the selected class. Every booked seat needs an eligible pass and enough remaining classes or points; an eligible shared pass can be used. Merely owning an expired, depleted or inapplicable pass is not enough.
- Edit: staff may also book without a pass, subject to the other booking rules.
It is the first item in the Calendar Management group. This permission supplements existing calendar and own/other-instructor class access; it does not grant access to every class by itself. It also applies when staff manually promote a waiting-list customer or confirm a new-flow appointment. With View only, staff cannot confirm a booking that takes a one-off payment instead of a pass. Adding a customer to a class's waiting list is not checked against this permission, and it does not change customer self-booking rules or automated class-package bookings. The class setting Requires a valid pass is a separate customer-booking rule.
To restrict instructors, remove Edit for this permission from every applicable role and keep View in at least one. None means this role grants nothing; it is not a denial. Instructor Edit + custom-role None still allows no-pass booking. Instructor None + custom-role View allows pass-only booking. Only when no applicable role grants View or Edit are staff blocked from adding customers entirely. Setting this permission to None does not remove the Instructor role or teaching identity. Account Admin has unrestricted booking permission. This permission is not granted automatically by other Calendar permissions, such as User's Classes Edit or Other Instructor's Classes Edit, so check every role whose staff book customers. A staff member who sees Your role does not allow adding customers to classes. has neither View nor Edit in any applicable role. One who sees Your role requires a valid pass for every customer booking. has View only and needs Edit to book without a pass.


How to Add Custom Roles
From the "Role and Permissions" page, click on the "Manage Roles" button in the upper right corner. Then, utilize the "Add Role" button located at the top right to create a custom role.

📌 FAQ: I have instructors with different permission needs. How should I set that up?
The core role "Instructor" is the basic role that must be assigned to every teacher.
Only with this role can someone be assigned to teach classes in the scheduling system. It acts as the foundation of an instructor's identity in the system.
However, since instructors may have different responsibilities, their required system permissions can vary. Here are two common scenarios:
1. Part-Time Instructor
- Can manage their own classes,
- Take attendance for their own classes,
- Cannot view bookings for other instructors' classes.
2. Full-Time Instructor
- Can manage any instructor's classes,
- Take attendance for any instructor's classes,
- Can view numbers of attendees for all classes.
You might ask:
"Why not just include all permissions in the core 'Instructor' role?"🤔
>> If all permissions were bundled into one role, every instructor (regardless of being part-time or full-time) would have the same level of access. That would remove flexibility and limit your ability to protect sensitive information.😓
The solution
✅ Use the core role "Instructor" to grant the minimum shared permissions (suitable for part-time instructors).
✅ Then, create additional roles as needed (e.g., "Full-Time Instructor") and assign extra permissions accordingly.
---------- The example of how 2 permissions setup ----------
1. Core Role - Instructor (Part-time Instructors Permission)
*The basic role of Instructor.

2. Customized Role(Full-Time Instructor Permission)

Account Role Binding
From Settings → Roles and Permissions → View, choose Add users, select users and roles, then save. To change an existing user, open their row and select the complete role set they should retain: saving replaces that user's current assignments. When Multiple Locations is enabled, configure locations separately for each selected role; an empty selection means All locations. A multi-user save applies the same selected set to every selected user.

Demonstration of Common Role Permissions
Common Roles: Front Desk Staff, Part-time Teacher
Front Desk Staff
- Authorized Role: Custom "Front Desk Staff" Role.
- Responsibilities:
- Add courses to customer accounts.
- Handle payments at the front desk and verify payments.
- Assist students with reservations from the backend.
- View schedules and take attendance.

Part-time Teacher
- Authorized Roles: Core Role - Instructor (Remove all permissions) + Custom "Part-time Teacher" Role.*Binding to the "Core Role - Instructor" allows setting as a class instructor and display on the instructor page.
- Responsibilities:
- View own class on the schedule (No permission to edit classes) + Take attendance.
- Send group messages to classes (No permission to send one-to-one messages, No permission to reply to messages).

Creating Test Accounts
When a business is editing role permissions and wishes to see the actual changes in permissions, they can create a test account, bind the role to the test account, and log in with that account using another browser. This ensures that the permission settings meet their requirements.

Location Based Role Permissions
Location scope belongs to a user's role assignment, not the shared role definition. Open that user from Roles and Permissions and set each role's locations. Empty means All locations, not no access. Another role assigned for All locations may still grant access elsewhere.

Override pass defaults (Users → Pass management)
Under Users → Pass management there is a child permission called Override pass defaults. It controls whether a staff member may change the values that are copied from a pass when that pass is added to a customer's account.
What it controls
- Type, and the number of classes or points
- Price
- Discount
- Activation date - Locked
- Activate now
- Activation date and Expiration date
- Limit customer cancellations
- Sale location
Choosing which pass to give a customer does not require this permission. A staff member with Pass management can still add a pass to a customer's account; without Override pass defaults they simply keep the values that come from the pass itself.
Edit only, and only under Pass management - Edit
- Override pass defaults offers Edit only. There is no View level for it.
- It is listed only while Pass management is set to Edit. When Pass management is set to View or None, the permission is hidden and is included in the hidden-permission count shown on Pass management.
- Setting Pass management below Edit clears Override pass defaults automatically, so the role loses it. Raise Pass management back to Edit and grant the permission again if you need it.
- While it is hidden it also cannot be reached or changed through the permission search box.
What staff see without it
Fields a staff member cannot change are locked, not hidden. They still appear on the customer's pass form with a small lock icon next to them, showing the values carried over from the pass, and cannot be edited.
Security & Visitors (Settings)
Security & Visitors is a permission under Settings, not a separate role. Account Admin has Edit by default; Manager, Instructor and Salesperson do not have it by default. To grant access, open Settings → Roles and permissions → Manage roles, open the intended role, grant Settings View, then set Security & Visitors to View or Edit and save. View permits visitor charts, sessions, event details and restriction history. Edit is required to create or remove restrictions. Granting View does not authorize blocking, even if a block action is visible.
Open Settings → Security & Visitors. The page has Visitors, Sessions and Blocked access tabs. The Settings card is available in both development and production. Opening the page requires Settings View and Security & Visitors View; blocking or unblocking requires Security & Visitors Edit.
