ZenotiHelp

Guest Gallery Image Picker in Annotation Components

ZTZenoti Docs Team Updated October 22, 2026 5 min readGuide

When filling a form that includes an annotation component, providers can select an existing image from a guest's gallery as the base for annotation rather than starting from a blank template. This article explains how to use the guest gallery image picker within the form builder's annotation components during a form-filling session.

Audience: Providers and clinical staff who fill forms with annotation components during appointments.


On this page


Before you begin

  • Your organization must have annotation components enabled in the form builder. Contact your administrator if annotation components are not available in your forms.

  • The guest must have at least one image in their gallery before you can select one as an annotation base.

  • You must have an active appointment open to access form-filling with annotation components.

  • The guest gallery image picker is available in Treatment Hub charts, where the annotation pad always uses the redesigned experience.

  • You need the following permission:

    Permission: View under Medical Record in the Administrator section of the security role β€” required to view and interact with guest medical record data, including guest gallery images used in annotation components.

Steps

Open the annotation component in a form

  1. In Treatment Hub, open the guest's treatment chart (see Chart a treatment).

  2. Locate the annotation component within the form. Annotation components display a drawing canvas that may contain a pre-loaded background image or a blank template.

  3. To change the background image, select the Photo button in the annotation toolbar (tooltip: "Change background image").

    On phones, tap the photo icon in the annotation pad's header instead. A Change Background sheet opens, presenting options for the background image source.

  1. In the Change Background sheet, select Patient Gallery to browse images from the guest's gallery.

    The guest gallery image picker opens and loads the first page of available images from the guest's gallery.

  2. Browse the available images. The picker displays thumbnail previews of each image.

    Note: The picker loads images in pages. If the guest has more images than are shown, scroll down to load additional images automatically. The picker continues loading pages as long as more images are available, regardless of whether some files in the gallery β€” such as PDFs or videos β€” are not shown. Only image files appear in the picker.

  3. Tap the thumbnail of the image you want to use as the annotation base.

    Tapping a thumbnail applies it as the background. There is no separate confirmation step.

    Important: If the annotation canvas already contains annotation markings, a Change Background dialog appears asking "What would you like to do with existing annotations?" Choose from Cancel, Clear Annotations (removes existing markings and applies the new background), or Keep Annotations (overlays existing markings on the new background). Review your existing annotations before making this choice, as clearing annotations cannot be undone.

  4. The selected guest gallery image now appears as the background of the annotation component. You can proceed to add annotation markings on top of it.

Complete and save the annotation

  1. Add your annotation markings using the available tools: Draw, Shapes, Lines, Text, Measure, and other options in the annotation toolbar.

  2. When your annotations are complete, select Done to close the annotation editor and return to the form.

  3. Continue filling out the remainder of the form, then submit or save the form as appropriate.

    Note: If you close the form without submitting, a draft is saved and the message Form saved as draft is displayed. Your annotation, including the selected guest gallery image and any markings, is preserved in the draft.

Worked example: A provider is completing a post-treatment assessment form for a guest who had a skin treatment. The form includes a body diagram annotation component. The provider selects the Photo button in the annotation toolbar, then selects Patient Gallery to open the guest gallery. The guest has three before-and-after photos from a previous visit. The provider taps the most recent photo thumbnail, which immediately applies it as the annotation background. The provider then annotates treatment areas directly on the guest's actual image rather than on a generic diagram, selects Done, and submits the form.

Tips

  • Review the guest gallery before the appointment. If you anticipate needing a specific image for annotation, confirm it has been uploaded to the guest's gallery in advance so it is available when you open the form.
  • Use "Keep Annotations" carefully. If you change the background image after adding markings, selecting Keep Annotations overlays those markings on the new image. This is useful for comparing annotations across visits but may produce unexpected results if the new image has a different orientation or scale.
  • No suitable image in the gallery? If the guest gallery contains no images or the available images are not appropriate, select From Device in the Change Background sheet to load an image directly from the device instead.
  • Save regularly using the form draft feature. Complex annotation sessions benefit from the form auto-save behavior when it is enabled for your organization. If auto-save is not enabled, return to the form and use the save action periodically to preserve your work.
  • Infinite scroll loads more images automatically. You do not need to navigate between pages manually. Scroll to the bottom of the gallery picker to trigger the next page of results.

Troubleshooting

Problem Likely cause Resolution
The Patient Gallery option does not appear in the Change Background sheet The guest gallery picker is only available where the app supplies the gallery β€” currently in Treatment Hub charts. This form may not be in a Treatment Hub chart context Confirm you are filling the form from within a Treatment Hub chart. If so, contact your administrator
The guest gallery picker opens but shows no images The guest has no images uploaded to their gallery, or all gallery files are non-image formats (such as PDFs or videos) that the picker does not display Verify that image files have been uploaded to the guest's gallery from the guest profile before using the picker
The picker shows the message "Unable to load patient photos" A connectivity or loading issue prevented the guest gallery from loading Tap the message to retry. If the issue persists, check your network connection and contact your administrator
Scrolling to the bottom of the picker does not load more images All available guest gallery images have already been loaded β€” the picker has reached the end of the image set No action needed; all available images are displayed
After selecting Clear Annotations, previous annotation markings are still visible The clear action was not completed before the dialog closed Reopen Change Background, tap the image thumbnail again, and select Clear Annotations when prompted
Was this article helpful?
Your feedback helps us improve our documentation.