> For the complete documentation index, see [llms.txt](https://endash-guidance-docs.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://endash-guidance-docs.gitbook.io/docs/dashboard/widget-types/gallery.md).

# Gallery

## Overview

* The Gallery widget is a visual component that displays a collection of images as long as your data model has a column that contains an image URL.

<figure><img src="/files/Dce6MYhyVxdlgXLrp22Y" alt=""><figcaption></figcaption></figure>

* First, click on any "+ Add widget" button to add a widget.

<figure><img src="/files/0zb9IVQtbXm32d7FTgL2" alt=""><figcaption></figcaption></figure>

* Click on the Gallery option.
* Click on the Add widget button to proceed.

<figure><img src="/files/SjaaCGwKnPCGGnufDlAC" alt=""><figcaption></figcaption></figure>

* Choose the available Collection or Connection of the data model that has been added.

## Set up your Gallery

### Add Image

<figure><img src="/files/RAwZLof2kaZtJBa8Sz8t" alt=""><figcaption></figcaption></figure>

* Click on the Image field then choose the column that has the image url to display the image.

{% hint style="info" %}
The image will only appear if there is an image url and the image url is not expired.
{% endhint %}

### Add Title

<figure><img src="/files/vwDXlclCFZuQLx1CLUbe" alt=""><figcaption></figcaption></figure>

* Continue to the field that you would like to be the Title of the image.

### Add Values on card

<figure><img src="/files/s7FmRTz1pr4lEDVn3Db9" alt=""><figcaption></figcaption></figure>

* The Galley widget needs to have a value to complete.
* Click on the button to display All fields pop up.

<figure><img src="/files/fL6nrqz6FRwBV06IYMtq" alt="" width="563"><figcaption></figcaption></figure>

* The All fields pop-up will appear with all the available columns of the data model.
* Simply drag and drop one or many fields into the Values.
* Click the Done button and the X button to close the All fields pop-up.

<figure><img src="/files/yhv0TRZYpxfj2ELNVvNd" alt=""><figcaption></figcaption></figure>

* You can click on the 🖊 icon to [customize](/docs/dashboard/custom-column-configuration.md) the column.

### Set up formulas

* In [Grouping](/docs/dashboard/widget-types/gallery/gallery-grouping.md) mode, the Formula box will appear to access on the selected column.

<figure><img src="/files/wRgEBJzPdPG2CGesUUSz" alt=""><figcaption></figcaption></figure>

* Click on the field, the [Formula](/docs/dashboard/footer-formula.md) popup will appear and you can choose from the available options.
* The Sum formula will be auto-selected.

### Choose your Image container&#x20;

<figure><img src="/files/ZKiulPhVpkXA7K78Mr7r" alt=""><figcaption></figcaption></figure>

* The Fit option is the default option. This option helps display the full image.

<figure><img src="/files/EuycCUm65vnx9xt8t6tK" alt=""><figcaption></figcaption></figure>

* You can switch to the Fill option to fill the whole image container.

### Add Description

<figure><img src="/files/qu8WpYQaHY9nwnpnIXpe" alt=""><figcaption></figcaption></figure>

* Continue to the field that you would like to be the Description of the image.

### Add Link

<figure><img src="/files/7ODaF5J1F3twL1NFSfsc" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/M3HM8HZDElQaGlvpAPeQ" alt=""><figcaption></figcaption></figure>

* Fields that contain any Link can also be added.

<figure><img src="/files/vVZyOBOLbCUq6fzyYGT7" alt=""><figcaption></figcaption></figure>

* You can also add additional text.

### Add Other values

<figure><img src="/files/oNi5aJnlnrAtRlZbwXJc" alt=""><figcaption></figcaption></figure>

* With the Other Values option,  the columns can be viewed in [Gallery details](https://app.gitbook.com/o/cYcNMspJTmyfByvJ8hY7/s/Sr8m3Ldc2W7Qqq1jsjgC/~/changes/95/dashboard/widget-types/gallery/gallery-details).

## Clean fields

<figure><img src="/files/EXqxbJwzIOwTZiGYYRWd" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/rg9Nj0UxoOyywfNuxmtI" alt=""><figcaption></figcaption></figure>

* To clean any field, simply click on the X icon next to it.

<figure><img src="/files/pAsuZGFcmcXVXcAPHmnH" alt=""><figcaption></figcaption></figure>

* For the Values section, you can click the Clear all button to quickly clean them all.

## Change to the Gallery type from another widget

<figure><img src="/files/saj9WbwS3ZQi3dlEJoHd" alt=""><figcaption></figcaption></figure>

* The Gallery chart option can be selected by opening the Settings slider and then clicking on the Properties option.

<figure><img src="/files/Sgp8TfAQvieJwNE4XOS4" alt=""><figcaption></figcaption></figure>

* Click on the View type dropdown and choose the Gallery chart icon to begin configuring your data model to the Gallery chart.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://endash-guidance-docs.gitbook.io/docs/dashboard/widget-types/gallery.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.