# 🎨 Custom swatch

{% hint style="success" %}
**Available on:** Product page, Collection page
{% endhint %}

✨Demo product: [Custom swatch](https://optis-color-swatch-variant.myshopify.com/products/custom-swatch?pr_prod_strat=collection_fallback\&pr_rec_id=a9de6891c\&pr_rec_pid=8274609307785\&pr_ref_pid=8274596233353\&pr_seq=uniform) (password: 1)

### **Function**

Allows you to manually assign a custom image or a solid color (hex code) to each variant, instead of using the product images.

### **Use when**

* Variants already have images in Shopify **but you don’t want to use those images as swatches**.
* You want swatches to show **patterns, textures, materials, or plain colors** rather than full product photos.

### **How to use Custom Swatch**

{% stepper %}
{% step %}

#### Change the display type to Custom swatch > Click Save

<figure><img src="/files/WmoIOofFxwLNAT5GtJjV" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### **Click the pencil icon to:**

* Upload your own images (patterns, textures, fabric details, etc.)
* Select a solid color using a **hex color code**

<figure><img src="/files/ur9qkoZ69vCkgmBgjsyN" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Click Save to apply changes

{% endstep %}
{% endstepper %}

### **How it looks on your store**

* Product page:

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

* Collection page:

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


---

# 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.optis.me/swatch/variant-display/custom-swatch.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.