> For the complete documentation index, see [llms.txt](https://help.byinspiredlabs.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.byinspiredlabs.com/theme-settings/swatches.md).

# Swatches

Theme settings – Swatches

Swatches are small color or image chips that show a product's variants, such as its colors. Customers can see the options at a glance, and choosing a swatch updates the product image.

<figure><img src="https://441504973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv0IRrXJZ4YweBmaaR6L8%2Fuploads%2F8fJhHeALSXx6GreZU1vH%2FScreenshot%202025-09-16%20at%2011.29.59%E2%80%AFAM.png?alt=media&amp;token=473dcde7-f77e-4712-8ad2-2b9cf1880673" alt=""><figcaption></figcaption></figure>

### 1. Add color swatches with category metafields

* **Assign a product category**

  * In your Shopify admin, open a product. In **Category**, choose a category that supports the **Color** metafield, such as **Apparel & Accessories > Clothing > Clothing Tops > Shirts**.

  <figure><img src="https://441504973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv0IRrXJZ4YweBmaaR6L8%2Fuploads%2Fe2ZIPYWT3Id3yJ8CQZJH%2FScreenshot%202025-09-16%20at%2011.32.10%E2%80%AFAM.png?alt=media&amp;token=e3246bba-9c13-4bd1-bb70-4d046b2a5a5a" alt=""><figcaption></figcaption></figure>
* **Connect the Color category metafield**

  * In the product's variant options, click the **dynamic source icon ⛁** to connect the option to the **Color** metafield.
  * To add your own option values, click **Edit > Add new entry**, fill in the fields and click **Save**.

  <figure><img src="https://441504973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv0IRrXJZ4YweBmaaR6L8%2Fuploads%2FqtLbbnsLJeotWwiY5Nwm%2FScreenshot%202025-09-16%20at%2011.33.44%E2%80%AFAM.png?alt=media&amp;token=fb89f66f-27f5-4d7f-afb1-679161fa3458" alt=""><figcaption></figcaption></figure>
* **See the swatches in your store**
  * Once set up, swatches appear wherever the product's variants are shown.

### 2. Swatch settings

In the theme editor, click **Theme settings**, then open **Swatches**.

* **Type:** What the swatch shows.
  * **Color:** The color of the option value.
  * **Native:** The image set on the option value, if it has one. Otherwise, its color.
* **Ratio:** The shape of the swatch. Options: Square, Landscape or Circle.
* **Style:** The corners of the swatch. Options: None (square corners) or Slightly rounded.

{% hint style="info" %}
**Note:** To change the size or shape of swatches on the product page, or how they react on hover, use the [Variant picker](https://help.byinspiredlabs.com/product-page/product-information/variant-picker.md) block settings.
{% endhint %}
