Troubleshoot photo manager
ZTZenoti Docs Team Updated June 11, 2026 5 min readGuide
This article covers common issues with Photo Manager features and how to resolve them.
Audience: Administrators and providers who need to resolve issues with Photo Manager.
On this page
- Photo capture issues
- Camera does not open
- Guideline overlay does not appear
- Photos appear dark or blurry
- Photo sequence issues
- Cannot create a photo sequence
- Error when saving a sequence
- Sequence does not load during appointment
- Guest gallery issues
- Cannot view guest photos
- Cannot delete photos
- Bulk edit fails
- Global Gallery issues
- Global Gallery is not visible in the menu
- Cannot export photos to Global Gallery
- Cannot edit or delete Global Gallery photos
- AI treatment progress issues
- AI analysis returns no results
- AI analysis returns an error
- AI comparison pairs are empty
- MyZen issues
- Photo Manager not visible in MyZen
- Photos captured in MyZen are not appearing in the gallery
- Contact support
Before you begin
- Your organization must have the Photo Manager feature enabled.
- Photo capture requires a supported device: iPad, Android tablet, or a mobile device running the MyZen app.
- Camera permissions must be granted at the device level.
- You need the relevant permissions for the action you are trying to perform: Camera Access, Gallery View, Download, or Delete (Photo Management).
Photo capture issues
Camera does not open
| Possible cause | Resolution |
|---|---|
| Missing Camera Access permission | Ensure your role has Camera Access permission (Photo Management) |
| Photo Manager not enabled | Confirm the Photo Manager feature is active for your organization |
| Browser camera blocked | Check your browser settings and allow camera access for the Zenoti site |
| Device camera in use | Close other apps that may be using the camera and try again |
Guideline overlay does not appear
| Possible cause | Resolution |
|---|---|
| No sequence selected | Select a photo sequence or individual guideline before capturing |
| Sequence not linked to service | Ensure the appointment's service has an associated photo sequence |
| Network connectivity issue | Guideline overlay images require an internet connection — check your network |
Photos appear dark or blurry
- Ensure adequate lighting in the treatment room.
- Tap the screen to adjust the camera's focus point.
- Hold the device steady during capture.
- Clean the camera lens.
Photo sequence issues
Cannot create a photo sequence
| Possible cause | Resolution |
|---|---|
| Missing permission | Ensure your role has Photo Sequence Add permission |
| Photo Manager not enabled | Confirm the Photo Manager feature is active for your organization |
Error when saving a sequence
| Error condition | Resolution |
|---|---|
| Duplicate name | Choose a unique name — a sequence with that name already exists |
| Invalid guideline order | Ensure guidelines are numbered sequentially with no gaps or duplicate numbers |
| Name too short or too long | The name must be 3–50 characters |
Sequence does not load during appointment
| Possible cause | Resolution |
|---|---|
| No service association | Link the photo sequence to the appointment's service |
| Sequence is inactive | Set the sequence status to Active |
| Wrong service linked | Verify the correct sequence is associated with the service being performed |
| ZMA (Zenoti Mobile App) not refreshed | Close and reopen ZMA to load the latest sequences |
Guest gallery issues
Cannot view guest photos
| Possible cause | Resolution |
|---|---|
| Missing permission | Ensure your role has Gallery View permission (Photo Management) |
| No photos uploaded | The guest has no photos — capture or upload photos first |
Cannot delete photos
| Possible cause | Resolution |
|---|---|
| Missing permission | Ensure your role has Delete permission (Photo Management) |
| Invalid file selection | Refresh the gallery and try selecting the files again |
| Too many files selected | Reduce the number of selected files and try again |
Bulk edit fails
| Possible cause | Resolution |
|---|---|
| Missing permission | Bulk edit requires Camera Access or Gallery View AND Guest Add, Edit, or Delete permissions |
| Too many files selected | Reduce the selection to 10 files or fewer and try again |
| Invalid file IDs | Refresh the gallery and try again |
Global Gallery issues
Global Gallery is not visible in the menu
Both of the following conditions must be met:
- The Photo Manager feature is enabled for the organization.
- Your role has Global Gallery View permission.
Contact your administrator if either condition is not met.
Cannot add photos to Global Gallery
| Possible cause | Resolution |
|---|---|
| Missing permission | Ensure your role has Global Gallery Select permission |
| Photos not from guest gallery | Photos can only be added to the Global Gallery from a guest's gallery |
Cannot edit or delete Global Gallery photos
| Possible cause | Resolution |
|---|---|
| Missing Edit permission | Ensure your role has Global Gallery Edit permission |
| Missing Delete permission | Ensure your role has Global Gallery Delete permission |
AI treatment progress issues
AI analysis returns no results
| Possible cause | Resolution |
|---|---|
| No eligible photos | The guest needs treatment photos from multiple sessions before AI analysis can run |
| Date filter too narrow | Widen the date range or remove the date filter |
| Service filter excludes all photos | Broaden the service filter or remove it |
| Non-image files only | AI analysis only includes image files (photos) — documents are excluded |
AI analysis returns an error
| Possible cause | Resolution |
|---|---|
| Guest ID is missing or invalid | Verify you have the correct guest record open |
| Invalid date range | Ensure the start date is before the end date |
| Missing permissions | You need Camera Access or Gallery View AND Guest View permissions |
| Temporary system error | Try again. If the issue persists, contact Zenoti support. |
AI comparison pairs are empty
This happens when photos cannot be matched for comparison. To improve matching:
- Capture photos using the same guidelines across visits.
- Associate photos with treatment services.
- Ensure there are photos from multiple visits over a period of time.
MyZen issues
Photo Manager not visible in MyZen
All three of the following conditions must be met:
- The Photo Manager feature is enabled for the organization.
- The Enable Photo Manager in MyZen setting is turned on.
- Your role has Camera Access permission.
Contact your administrator if any condition is not met.
Photos captured in MyZen are not appearing in the gallery
- Check your network connection — photos are uploaded to the server and require connectivity.
- Refresh the guest gallery on the receiving device.
- Verify in MyZen that the photos were saved successfully before leaving the capture screen.
Contact support
If you cannot resolve an issue using the steps above, contact Zenoti support with:
- The action you were trying to perform
- Any error message displayed
- The device and browser or app version you are using
- Screenshots of the issue
Was this article helpful?
Your feedback helps us improve our documentation.