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

# Image Options

Let visitors choose by picture instead of by text, with one image tile per option.

The **Image Options** field turns a choice list into a grid of picture tiles. Use it when the picture is the answer — a fabric swatch on a custom furniture request, a frame style on a print order, or the cake design a customer wants for their order.

{% hint style="info" %}
**Image Options** is not included on the Free plan. Its tile in the element picker is grayed out with an upgrade prompt. See [Plans and billing](/globosoftware-docs/settings/plans-and-billing.md).
{% endhint %}

## 🔧 How to Set It

* In the form editor, click **Add elemen**&#x20;
* Pick **Image Options**.&#x20;

The field is added and its settings open on the left. See [Add and arrange elements](/globosoftware-docs/build-your-form/add-and-arrange-elements.md) for the other ways to add a field and how to reorder them.

<figure><img src="https://712145376-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2AkSDlkSYnQXINUtOZOT%2Fuploads%2FKaQQyOnRGz9VOrlDzAQC%2F2026-10-12_15-40-57.png?alt=media&amp;token=c9fb75dc-9fc2-4f27-881f-079b9e7cd14f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://712145376-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2AkSDlkSYnQXINUtOZOT%2Fuploads%2FybFTl3A8suo70j8LqD0J%2F2026-10-12_15-41-55.png?alt=media&amp;token=58be412b-3a0c-4fa0-90fc-ecdc5a18b6d5" alt=""><figcaption></figcaption></figure>

## 🔧 Settings

Only the settings specific to this field are listed here. **Label**, **Description**, **Required**, **Column width**, **Conditional display** and the other shared settings work the same on every field.

### **📝 Options**

The list of picture choices. Each one has:

* a **Label** (the name of the choice)
* a **Value** (what’s saved in the submission)
* a **Description** (shown as a tooltip, if enabled)
* an **image** (the tile itself)

Click **Expand** to see and edit all columns side by side.

<figure><img src="https://712145376-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2AkSDlkSYnQXINUtOZOT%2Fuploads%2FGVGkhyRyOhXd06HFcKBr%2F2026-10-12_15-43-02.png?alt=media&amp;token=2cb68737-59fe-4bb2-92d0-2d4259d2a17d" alt=""><figcaption></figcaption></figure>

> **⚠️ Note:** Only the **Label** can be translated. The **Value** stays the same across all languages.

**🖼️ Upload the Pictures**

Each option row has a thumbnail slot on its left. Click it, pick an image, and wait for the thumbnail to appear before moving on.

<figure><img src="https://712145376-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2AkSDlkSYnQXINUtOZOT%2Fuploads%2FIWkmQfG9UsyyJLnaIyMI%2F2026-10-12_15-44-14.png?alt=media&amp;token=4ebf02f8-f6a8-4aea-909a-5cf159ca627f" alt=""><figcaption></figcaption></figure>

### **✅ Multiple Selection**

Lets the visitor pick more than one picture. Off by default.

Turning it on reveals **Limit selections**, then **Min selections** and **Max selections**.

**Example:** A cake order turns on **Multiple selection** and **Limit selections** with **Max selections** `2` — visitors can pick up to two designs.

> **📌 Note:** Outside the range, submission is blocked with a message naming your number, like *“Please choose at least 2 options.”* when the submit button is clicked. &#x20;

<figure><img src="https://712145376-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2AkSDlkSYnQXINUtOZOT%2Fuploads%2FRZGiYu7n3YNk4PukZK9F%2F2026-10-12_15-57-58.png?alt=media&amp;token=23e2e2fa-80c7-44b6-8c66-4bc5cb543080" alt=""><figcaption></figcaption></figure>

### **💬 Enable Tooltip**

Shows each option’s **Description** when the visitor hovers over its tile. Off by default.

Click **Expand** above the **Options** list — a **Description** column appears. Whatever you type there shows on hover.

**Example:** A frame-style field uses tooltips for details that won’t fit under the picture — material, size, or lead time.

<figure><img src="https://712145376-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2AkSDlkSYnQXINUtOZOT%2Fuploads%2FptrbKczR8uMjxRugH1jv%2F2026-10-12_15-52-29.png?alt=media&amp;token=0ce2be2d-9d25-4385-928e-bd64516474cf" alt=""><figcaption></figcaption></figure>

## 🔄 How It Works

**What’s saved:** Each chosen option’s **Value** — not the image, not the Label. With **Multiple selection** on, every chosen value is stored. It appears in **Submissions**, emails, exports, and integrations.

<figure><img src="https://712145376-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2AkSDlkSYnQXINUtOZOT%2Fuploads%2FJelsDDqgpRffWbPTY5MX%2F2026-10-12_16-05-34.png?alt=media&amp;token=f5f02eb0-ab04-4680-83ea-fb7d162cdf35" alt=""><figcaption></figcaption></figure>

## 🔁 Compare

<table><thead><tr><th width="185.50006103515625">Use</th><th>When</th></tr></thead><tbody><tr><td><strong>Image Options</strong></td><td>A short set of choices where the picture <em>is</em> the answer</td></tr><tr><td><strong>Image Dropdown</strong></td><td>The same idea in a closed list — better for longer sets</td></tr><tr><td><strong>Color Swatch</strong></td><td>Choose from a color palette instead of pictures</td></tr></tbody></table>

## Next steps

* [Image Dropdown](/globosoftware-docs/field-types/selects/image-dropdown.md) — the same idea in a closed list, for longer sets of choices.
* [Color Swatch](/globosoftware-docs/field-types/colors/color-swatch.md) — pick from a palette you define instead of from pictures.
