---
title: "Troubleshooting & FAQ"
date: 2026-07-24
author: "Claude MCP"
---

# Troubleshooting & FAQ

## Troubleshooting

 
### A gallery isn't visible on the site

 Check that the gallery's **Status** is set to Published under **Components > Client Response Gallery > Galleries**. If the gallery has a password, visitors need to enter it before the gallery content is shown, that's expected behaviour, not a bug.

 
### Watermark, resizing or quality settings aren't applied to a photo

 These settings only apply to photos added through **Batch Upload** (in the backend or via the API). Photos added by FTP, the Joomla media manager, or the one-by-one **New** photo screen skip this processing entirely, see "Upload Your Photos" for the full list of upload methods and what each one does.

 
### The client or photographer didn't receive a confirmation email

 Check that **Send Client Email** and/or **Send Photographer Email** are enabled under **Mail options**. Also check the receiving mailbox's spam folder, and confirm your Joomla site's mail configuration (System > Global Configuration > Server) is set up correctly, since this component uses Joomla's own mail settings.

 
### The ZIP download link doesn't appear

 The ZIP link on the thank-you page and in emails only appears when **Create selection ZIP** is enabled under **Selection options**, and the corresponding "Include ZIP link" switch is enabled for that page or email.

 
### The API returns 401 Unauthorized

 Check that an API key is generated under **Components > Client Response Gallery > Options > API**, and that the exact key is sent in the `X-API-Key` request header, with no extra spaces. See "API Documentation" for the full reference.

 
### The Lightroom plugin can't load galleries

 Verify the Server URL includes the protocol (`https://` or `http://`), that your Joomla site is reachable from the machine running Lightroom, and that the API key matches exactly. See "Adobe Lightroom Plugin" for the full troubleshooting list.

 
### A selection warning message isn't showing

 Check the **Minimum Photos** or **Maximum Photos** value is not set to 0 (0 disables that warning) under **Selection options**, and check the **Warning message position** setting includes the location you're expecting it in.

 
## FAQ

 
### Do I need a Download Key?

 A Download Key is only needed for the PRO version, to enable automatic updates. See "Download Key" for how to find yours.

 
### Can I password-protect a gallery?

 Yes. Set a **Password** when creating or editing a gallery. Visitors need to enter it before they can view the gallery. Leave the field empty to make the gallery open to everyone.

 
### Can I limit how many photos a client selects?

 Yes, under **Selection options** (global) or per gallery under Gallery Selection options. Set Minimum and/or Maximum Photos, with custom warning messages using the ``/`` placeholders.

 
### What happens to photo files when I delete a gallery?

 That depends on the **Delete Files with Gallery** and **Delete Folder with Gallery** switches under **Advanced options**. Both default to disabled, so files are kept on the server unless you turn them on.

 
### Can I import photos directly from Adobe Lightroom?

 Yes, using the dedicated Lightroom Classic export plugin. See "Adobe Lightroom Plugin" for setup and "API Documentation" for the underlying API it uses.

 
### Can I customize the confirmation and notification emails?

 Yes. Both the client thank you email and the photographer notification email have editable subject and body templates under **Mail options**, with placeholders for the gallery title, client details and selected photos.