# Gallery widget configuration

After adding the Gallery to your Apps section in the Theme Template, you can edit it and adjust it to the design of your website. There is a list of fields and appearances that can be changed.

**Exact gallery you’d like to add on a specific page**

* In case you’re adding a Gallery to a Product Template, you can select if you want to have a general gallery appearance on each product in the template, or customize the fields of a specific product separately.
* In case you’re adding a Custom Gallery to a specific page, you can change the page on which this gallery will appear.

**Demo mode**

{% hint style="info" %}
Allows you to review how your gallery will look on a store’s website once it’s filled with photos. We’re providing you with test pictures, but in the theme editor only.
{% endhint %}

**Custom widget width (px)**

{% hint style="info" %}
You can define the widget width by yourself, or leave a 0 value so the gallery will adapt to the width of your site's container.
{% endhint %}

{% tabs %}
{% tab title="Header" %}
Here you can configure the texts of your gallery. It can be customized for the situation, when there are already some photos in the gallery, or when it’s empty. Review the list of fields that could be edited:

* **Title**
* **Title for empty gallery**

{% hint style="info" %}
If you don’t need a title on your gallery, you can put the toggle into the **OFF** position.
{% endhint %}

* **Subtitle**
* **Subtitle for empty gallery**

{% hint style="info" %}
If you don’t need a subtitle on your gallery, you can put the toggle into the **OFF** position.
{% endhint %}

* **Button CSS class**

{% hint style="info" %}
To ensure a consistent design, you might want to use the same CSS classes for our 'Upload' button as your theme uses.
{% endhint %}
{% endtab %}

{% tab title="Layout settings" %}
This settings block allows you to customize the appearance of the gallery when there are already some photos in it. You can also manage the number of slides for each of the device types.

Review the list of fields that could be edited here:

* **Show gallery**

{% hint style="info" %}
In case you don’t require a specific gallery on your Store anymore, you can always disable it.
{% endhint %}

* **Layout**\
  This setting offers you 3 options - **Slider,** **Grid,** and **Masonry** mode.
  * **Grid:** You can depict your photos in a gallery all at once, which means your page will look longer, depending on the number of photos in your gallery.
  * **Slider:** The gallery will always have the same size on your page, as the photos can be seen via pages by turning them via a slider.
  * **Masonry:** Your photos will be arranged in an organic, mosaic-like layout that optimizes space by placing images of different sizes together without gaps, giving your page a dynamic and modern look.
* **Images per row to show on**
  * desktop
  * mobile
* **Number of rows on**
  * desktop
  * mobile
* **Enable lightbox gallery**

{% hint style="info" %}
Allows your customers to review the photo in a full-screen mode and move to another with a slider.
{% endhint %}

* **Show photo description**

{% hint style="info" %}
Allows your customers to see the description of the image that you or other customers left about your products or store.
{% endhint %}
{% endtab %}

{% tab title="Slider settings" %}
Configure the appearance and functioning of the slider on your gallery with the following settings:

* **Navigation arrows**

{% hint style="info" %}
The setup options include disabling the arrows completely or enabling them only on a particular device type.
{% endhint %}

* **Arrows position**
  * Inner
  * Outer
* **Navigation dots**

{% hint style="info" %}
Can be disabled completely or enabled only on a particular device type.
{% endhint %}
{% endtab %}

{% tab title="Upload form settings" %}
This block is responsible for the pop-up form that the customer sees when uploading the photo to the gallery. Depending on your store’s policy and needs, adjust the settings.

By default, the Uploading of photos by your customers to the Gallery is allowed, but in case you don’t want it, there is a possibility to **disable the “Upload” button.**

Other configuration options include:

* Email request
  * Enabled
  * Disabled
  * Enabled and Required
* Description request
  * Enabled
  * Disabled
  * Enabled and Required
* Enable policy agreement checkbox

{% hint style="info" %}
To add the link to your Privacy Policy in the text near the checkbox, you need to add a standard HTML link tag (e.g., `<a href="your-link">link text</a>`) in the consent text field (e.g., "I agree with the Privacy Policy") in the Settings page, Edit / Translate texts tab. The app will automatically open this link in a new tab for your customers.
{% endhint %}
{% endtab %}
{% endtabs %}

{% columns %}
{% column %}

<figure><img src="/files/yEHBEjz0j9af7Gb3EAHx" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/JWW4lOma5CCFrs5nKoUo" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/oxhjqnntELIJPhKlGYf5" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/sMhJLR3qlrFGl8soJimA" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.customer-photo-uploader.app/user-manual/getting-started/gallery-widget-configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
