> For the complete documentation index, see [llms.txt](https://docs.customer-photo-uploader.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.customer-photo-uploader.app/user-manual/~/revisions/9v7ePcmfNjvZqJ36WLM6/getting-started/gallery-widget-configuration.md).

# 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 there. 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 2 options - **Slider** and **Grid** 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.
* **Images per row to show on**
  * desktop
  * mobile
* **Number of rows**
* **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 %}
{% 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:

* **Enable email request**

{% hint style="info" %}
This field in your form might be useful if you’d like to reach your engaged customers with a gratitude bonus or other proposals.
{% endhint %}

* **Email is required**

{% hint style="info" %}
If you enabled the previous field and want to make it mandatory for the customer to leave their email, use this option.
{% endhint %}

* **Enable description request**

{% hint style="info" %}
Your customer can not only add the photos, but also share some details or their impression of your product in the description field. Use it to make your products even closer to your potential buyers.
{% endhint %}

* **Description is required**

{% hint style="info" %}
If you enabled the previous field and want to make it mandatory for the customer, use this option.
{% endhint %}

* **Enable policy agreement checkbox**

{% hint style="info" %}
To make your customers feel safe, you can ask your customers to tick the Agreement checkbox.
{% endhint %}
{% endtab %}
{% endtabs %}

{% columns %}
{% column %}

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

{% column %}

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

{% column %}

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

{% column %}

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