Configure photo manager permissions
Photo Manager uses three groups of permissions to control access to its features. This article explains each permission and how to assign them to roles in your organization.
Audience: Administrators who manage security roles and permissions.
On this page
- Before you begin
- Steps
- Understand the permission groups
- Assign permissions to roles
- Use recommended configurations
- Special permission requirements
- Tips
- Troubleshooting
- Related articles
Before you begin
Permission: You need administrator access to manage security roles.
Your organization must have the Photo Manager feature enabled before any Photo Manager permissions have effect. If the feature toggle is off, Photo Manager pages and menus are hidden regardless of what permissions are assigned to a role.
Steps
Understand the permission groups
Photo Manager permissions are organized into three security groups.
Photo Management permissions
These control access to core photo capture and guest gallery features.
| Permission | Description | Typical roles |
|---|---|---|
| Camera Access | Open the camera and capture photos with guideline overlays | Providers |
| Gallery View | View the guest photo gallery and browse photos | Providers, Front Desk, Managers |
| Delete | Delete photos from the guest gallery | Managers, Supervisors |
| Download | Download photos from the guest gallery and Global Gallery | Managers, Marketing |
Note: The Download permission under Photo Management controls downloads from both the guest gallery and the Global Gallery. There is no separate download permission on the Global Gallery security group.
Global Gallery permissions
These control access to the organization-wide Global Gallery.
| Permission | Description | Typical roles |
|---|---|---|
| View | Browse and filter the Global Gallery | All staff with gallery access |
| Select | Select photos from guest galleries to add to the Global Gallery | Managers, Lead Providers |
| Edit | Update tags and descriptions on Global Gallery photos | Managers, Marketing |
| Delete | Remove photos from the Global Gallery | Managers, Administrators |
Photo Sequence permissions
These control access to photo sequence configuration.
| Permission | Description | Typical roles |
|---|---|---|
| View | View available photo sequences and their details | All staff |
| Add | Create new photo sequences | Administrators |
| Edit | Modify existing photo sequences | Administrators |
| Delete | Remove photo sequences | Administrators |
Assign permissions to roles
- Click the Configuration icon and go to Security roles.
- Select the role you want to configure.
- For Photo Management and Global Gallery permissions, navigate to the Appointment book section.
- For Photo Sequence permissions (Add, Edit, Delete, View), navigate to the Administrator section.
- Find the Photo Management, Global Gallery, and Photo Sequence security sections within their respective role sections.
- Enable the appropriate permissions for each role.
- Save the role configuration.
Tip: If a staff member needs to use AI treatment progress analysis, make sure their role has Camera Access or Gallery View under Photo Management, plus Guest View permission. Both are required. See Special permission requirements below.
Use recommended configurations
The following configurations are a starting point. Adjust based on your organization's needs.
Provider
| Security group | Permissions |
|---|---|
| Photo Management | Camera Access, Gallery View |
| Global Gallery | View |
| Photo Sequence | View |
Front desk manager
| Security group | Permissions |
|---|---|
| Photo Management | Gallery View, Delete, Download |
| Global Gallery | View, Select, Edit |
| Photo Sequence | View |
Administrator
| Security group | Permissions |
|---|---|
| Photo Management | Camera Access, Gallery View, Delete, Download |
| Global Gallery | View, Select, Edit, Delete |
| Photo Sequence | View, Add, Edit, Delete |
Marketing team
| Security group | Permissions |
|---|---|
| Photo Management | Gallery View, Download |
| Global Gallery | View, Edit |
| Photo Sequence | View |
Special permission requirements
Global Gallery page visibility
The Global Gallery page is only accessible when both conditions are met:
- The Photo Manager feature is enabled for the organization, and
- The user's role has Global Gallery View permission.
If either condition is not met, the Global Gallery menu item is not visible.
AI treatment progress analysis
Triggering the AI treatment progress analysis requires a combination of permissions:
- Camera Access or Gallery View (Photo Management) — to access photo data
- Guest View permission — to access guest information
Both must be present for a user to run AI treatment progress analysis.
Important: AI treatment progress analysis is also subject to Break Glass security validation on all relevant endpoints. This means a user must not only hold the permissions above but must also be authorized for guest file access through your organization's Break Glass controls. Contact your administrator if a provider with the correct permissions cannot access the treatment progress view.
Bulk operations on guest gallery files
Bulk editing guest gallery files (updating tags across multiple files at once) requires:
- Camera Access or Gallery View (Photo Management)
- Guest Add, Edit, or Delete permission
Photo Manager in MyZen
For providers to use Photo Manager features in the MyZen employee mobile app, two conditions must both be true:
- The Photo Manager feature toggle is enabled for the organization, and
- The Enable Photo Manager in MyZen setting is turned on.
Permissions assigned in security roles apply to MyZen in the same way they apply to the Zenoti web interface.
Access restrictions by platform
Photo Manager API endpoints — including guest gallery, Global Gallery, and AI treatment progress — are accessible from the Zenoti web interface, Mobile POS (Android), and Mobile POS (iOS). Other source applications cannot reach these endpoints regardless of the permissions assigned to a role.
Tips
- Assign Camera Access only to roles whose staff will actively capture photos. Staff who only need to review or manage existing photos should receive Gallery View instead.
- Give Photo Sequence Add, Edit, and Delete permissions only to administrators. Providers and front desk staff typically need only Photo Sequence View to see which sequences apply to their services.
- If your marketing or clinical review team needs to export photos from the Global Gallery, ensure they have Photo Management Download — not Global Gallery View. Download is always controlled by the Photo Management security group.
- Review permission combinations after any role restructure. A provider who loses Camera Access and Gallery View will also lose the ability to initiate AI treatment progress analysis, even if no permissions in the AI feature area were changed directly.
Troubleshooting
A provider can see the guest gallery but cannot open the camera. The provider's role has Gallery View but is missing Camera Access. Go to Configuration icon > Security roles, select the role, navigate to the Appointment book section, find Photo Management, and enable Camera Access.
The Global Gallery menu item is not visible for a manager. Either the Photo Manager feature toggle is off for the organization, or the manager's role does not have Global Gallery View. First verify that Photo Manager is enabled, then check the manager's role in Configuration icon > Security roles > Appointment book > Global Gallery.
A provider with Camera Access and Gallery View cannot run AI treatment progress analysis. AI treatment progress analysis also requires Guest View permission. Add Guest View to the provider's role. If the problem persists after adding the permission, check that the provider's account passes your organization's Break Glass security validation for guest file access.
An administrator cannot create or edit photo sequences. Photo Sequence Add and Edit permissions are located in the Administrator section of the security role, not the Appointment book section. Navigate to Configuration icon > Security roles, select the role, go to the Administrator section, and enable the required Photo Sequence permissions.
A staff member can view the Global Gallery but cannot download photos. Downloads are controlled by the Download permission under the Photo Management security group, not under Global Gallery. Enable Photo Management Download for the staff member's role.