ZenotiHelp

Guest Gallery Advanced Filtering

ZTZenoti Docs Team Updated August 27, 2026 6 min readGuide

The guest gallery supports advanced filtering so you can quickly locate specific photos across a guest's history. By combining filters for upload source, treatment concern, provider, center, service category, file type, and treatment phase, you can narrow a large gallery to exactly the files you need — whether you are reviewing treatment progress, preparing for a consultation, or auditing photo records.

Audience: Clinical staff, front desk staff, and administrators who review or manage guest photo records.


On this page


Before you begin

  • Photo Manager must be enabled for your organization. If the guest gallery does not appear, contact your administrator to enable the Photo Manager feature toggle.
  • You need access to the guest profile to view the gallery tab.

Permission: You need the Gallery View permission to view the guest gallery and apply filters. Admin path: Configuration icon > Security roles > Appointment book section > Gallery View

  • The guest must have at least one photo on file. Filters return no results if the gallery is empty.
  • Filtering by treatment concern requires that the relevant services are mapped to treatment concerns in your organization's configuration. Photos with no associated service are excluded from treatment concern filter results.
  • Filtering by provider requires that photos are linked to an appointment. Photos uploaded directly to the guest profile without an appointment association are not returned by the provider filter.

Steps

  1. Open the guest profile for the guest whose photos you want to review.

  2. Select the Gallery tab.

    The guest gallery opens, showing all photos associated with the guest across all centers.

Apply filters

  1. In the guest gallery, locate the filter controls at the top of the photo list.

  2. Select one or more of the following filters. Each filter you apply narrows the results further — filters combine using AND logic.

    Apply filters using the options described in Filter reference below.

  3. After selecting your filter values, the gallery updates to show only the files that match all active filters.

Note: Photos linked to a service via an appointment association are included in service-based filters (such as treatment concern and service category) even when the photo's direct service field is empty, as long as the appointment has an active service association on record.

Combine multiple filters

You can apply several filters at the same time to narrow results precisely.

Worked example: You want to review all before photos taken by a specific provider at your downtown center for facial services in the last quarter.

  1. Set the Center filter to your downtown center.

  2. Set the Provider filter to the provider's name.

  3. Set the Service category filter to the facial services category.

  4. Set the File type filter to Images.

  5. Set the Treatment phase filter to Pre-Treatment.

    The gallery now shows only image files from facial services performed by that provider at that center, captured before treatment began.

Clear filters

  1. To remove an individual filter, clear the selected value in that filter control.

  2. To remove all active filters at once, select the option to reset or clear all filters.

    The gallery returns to showing all files for the guest.


Filter reference

The following filters are available in the guest gallery. All filters are optional. When no filter is selected for a given criterion, that criterion is not applied.

Filter What it does
Center Shows only files belonging to one or more selected centers. Useful when a guest visits multiple centers and you want to review records from a specific location. Each file result includes the center name so you can confirm which center the photo belongs to without leaving the gallery view.
Provider Shows only files whose associated appointment was performed by one or more selected providers. Files not linked to an appointment are excluded when this filter is active.
Service category Shows only files whose associated service belongs to one or more selected service categories. Includes services linked to the file via an active appointment association, in addition to the service recorded directly on the file.
Treatment concern Shows only files whose associated service is mapped to one or more selected treatment concerns. Files with no associated service are excluded. Requires treatment concern mappings to be configured in your organization. Multiple treatment concerns can be selected — files matching any of the selected concerns are returned.
Upload source Shows only files that match the selected upload origin (for example, camera capture, manual upload, or another source).
File type Shows only files of the selected type category: Images (png, jpg, jpeg, tiff, gif, webp, heic), PDFs (pdf), or Videos (mp4, mov, avi, wmv, mkv, webm).
Treatment phase Shows only files tagged with the selected treatment phase: Pre-Treatment, Post-Treatment, or During Consultation. Use this filter to isolate before photos, after photos, or consultation images separately.

Note: Each file result in the filtered gallery includes the center name and center identifier, so you can confirm which center the photo belongs to without leaving the gallery view.


Tips

  • Start with the file type filter when you know you are looking for a specific format — for example, select Images to hide PDFs and videos before applying additional filters. This reduces visual noise immediately.
  • Use the center filter when reviewing cross-center guests. If a guest visits multiple centers, the gallery aggregates all their photos by default. Applying the center filter lets you focus on records from a single location without switching guest profiles.
  • Use the service category filter alongside the treatment concern filter for the most precise clinical review. Service category narrows by the type of service performed; treatment concern narrows by the mapped clinical area. Together they surface exactly the photos relevant to a specific treatment plan.
  • Use the treatment phase filter to separate before and after photos. Select Pre-Treatment to review baseline photos before a procedure, or Post-Treatment to review outcome photos — without mixing in consultation images.
  • Provider filter results depend on appointment linkage. If a photo was uploaded directly to the guest profile rather than captured during an appointment, it will not appear in provider-filtered results. If you expect a photo to appear but it does not, check whether it is linked to an appointment.
  • Filters persist within your session. If you navigate away from the gallery and return, check whether previous filters are still active before concluding that photos are missing.

Troubleshooting

Problem Likely cause Resolution
No photos appear after applying the treatment concern filter The service associated with the photos is not mapped to the selected treatment concern, or the photos have no associated service Ask your administrator to verify that the relevant services are mapped to the correct treatment concerns in the organization configuration. Photos with no service ID are always excluded from treatment concern filter results.
Provider filter returns no results even though the provider has taken photos The photos were uploaded directly to the guest profile rather than captured during an appointment Provider filtering only applies to files linked to an appointment. Check whether the photos in question are appointment-linked. If not, use the upload source or date range filters instead.
Service category filter does not show expected photos The service is not assigned to the expected category, or the appointment association is inactive Verify the service category assignment in your service catalog. Also confirm that the appointment association for the relevant photos is active and not voided.
Treatment phase filter returns no results The photos were not tagged with a treatment phase at the time of upload Treatment phase filtering only applies to files that have a phase recorded. Photos captured or uploaded without a phase designation do not appear when a treatment phase filter is active.
The gallery shows photos from centers the guest has not visited recently No center filter is active Apply the Center filter to restrict results to the specific center or centers you want to review.
File type filter excludes a file you know exists The file's extension does not match the selected type category Confirm the file's format. For example, a .heic file is included in the Images category. If the file was uploaded in an unsupported format, it will not appear in any file type filter result.
Filters appear to reset unexpectedly Session timeout or page reload Re-apply your filters. If this happens frequently, check whether your session timeout settings are configured to log out inactive users.

Was this article helpful?
Your feedback helps us improve our documentation.