ZenotiHelp

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


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

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

Both of the following conditions must be met:

  1. The Photo Manager feature is enabled for the organization.
  2. Your role has Global Gallery View permission.

Contact your administrator if either condition is not met.

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
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:

  1. The Photo Manager feature is enabled for the organization.
  2. The Enable Photo Manager in MyZen setting is turned on.
  3. Your role has Camera Access permission.

Contact your administrator if any condition is not met.

  • 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.