Gallery import button in camera screen
When the gallery import button is enabled on the camera screen, providers can select an existing image from the device's photo library instead of capturing a new photo. The imported image passes through the same upload process as a camera-captured photo and carries the same appointment and guest context.
Audience: Providers and front desk staff who capture photos using Photo Manager during a service.
On this page
- Before you begin
- Steps
- Import a photo from the device gallery
- What happens after import
- Tips
- Troubleshooting
- Related articles
Before you begin
- Photo Manager must be enabled for your organization. If you do not see the camera screen in your workflow, contact your administrator to enable Photo Manager.
Availability: The gallery import button on the camera screen is controlled by the
showGalleryButtonInCamerafeature setting. Contact your Zenoti Customer Success Manager to enable this option for your organization.
- You must be on a supported mobile device: iPad 10th generation or later, iPhone 11 or later, or an Android device with 8 GB or more RAM.
- Photo Manager is only available on forms created using the form builder. Legacy forms do not support Photo Manager.
- You need the following permissions to capture and upload photos:
Permission: Camera Access — Required to open the camera screen and capture or import photos. Admin path: Configuration icon > Security roles > [your role] > Camera Access
Permission: Gallery View — Required to view the guest gallery after upload. Admin path: Configuration icon > Security roles > [your role] > Gallery View
Steps
Import a photo from the device gallery
Open the camera screen. This screen appears during your standard photo capture workflow — for example, when capturing photos for a photo sequence associated with a service.
On the camera screen, tap the gallery import button. The button appears alongside the capture control.
Note: If you do not see the gallery import button, your organization may not have this option enabled. Contact your administrator.
- The device's native file picker opens. Browse your device photo library and select a single image.
Note: Only image files can be selected. Video files and other file types are not available in the picker.
After you select an image, the photo uploads automatically through the same upload process used for camera-captured photos.
The camera screen closes automatically once the selected image is queued for upload.
What happens after import
After a gallery image is selected and queued for upload:
- The camera is released and the camera screen closes. No further action is needed on the camera screen.
- The imported photo carries the same context as a photo taken directly with the camera at that point in the workflow — including the appointment, guest, service, organization, center, form, treatment phase, and display view metadata.
- The gallery import button and its tap handler are cleared when the camera screen closes, regardless of whether you imported a photo, captured one, or dismissed the screen.
- The uploaded photo appears in the guest gallery and is available for comparison and AI treatment progress analysis, like any camera-captured photo.
Worked example: A provider is documenting a guest's pre-treatment state for a facial service. The guest brought a photo from two weeks prior on their personal phone. The provider opens the camera screen, taps the gallery import button, selects the image from the device library, and the photo uploads tagged as pre-treatment for the current appointment — identical in context to a photo the provider would have captured live.
Tips
- Use gallery import for pre-existing reference photos. If a guest has a relevant photo on the device or accessible to the device's library, importing it avoids having to retake a photo that already exists.
- Only one image can be selected per import action. If you need to upload multiple photos, open the camera screen again to repeat the process for each additional image.
- Verify the treatment phase before importing. The imported photo inherits the treatment phase (pre-treatment or post-treatment) active at the point in the workflow when you opened the camera screen. Confirm the correct phase is set before tapping the gallery import button.
- Check device storage permissions. If the file picker does not open, your device may be blocking Photo Manager from accessing the photo library. Review your device's app permissions and grant library access if needed.
Troubleshooting
| Problem | Likely cause | Resolution |
|---|---|---|
| The gallery import button does not appear on the camera screen | The gallery import feature is not enabled for your organization | Contact your administrator or Zenoti Customer Success Manager to enable the gallery import button |
| The file picker opens but the image you need is not visible | The photo is stored in a location not accessible to the device file picker (for example, a cloud-only album not synced locally) | Download the photo to the device's local library before attempting to import |
| The camera screen does not close after selecting an image | The upload may still be in progress, or a network issue interrupted the queue | Wait a moment; if the screen remains open, check your network connection and try again |