# Custom color swatches

Palo Alto will display swatches for color variants in collection filtering and the product form on product pages.

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

{% hint style="success" %}
Palo Alto will detect if your variant label is color or colour and automatically display swatches
{% endhint %}

## Customize the trigger words

To customize the trigger words that activate swatches, use the theme content (edit default theme content) and add or modify the values:

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

You can add more trigger words that will help use swatches for other options.

The result is the same, and you can use different custom swatches as well.

## Colors

Palo Alto can easily detect simple color names and convert them to swatches. There are a total of 140 color names Palo Alto can detect, all other, more complex names will be represented by a default grey color swatch.

You can upload your own custom color names and graphics as described below. Here is a full list of color names that will automatically be converted to swatches: [color names list](https://groupthought.com/pages/swatch-color-names)

## Customizing

If your products have color names other than the listed colors in the [color names list](https://groupthought.com/pages/swatch-color-names), you can add your own color names and values or upload images to the assets folder:

### Add custom color names and values to swatches.json

Use the `swatches.json` file located in the **assets** folder to add your own custom names and HEX color values:

<figure><img src="/files/23rlliH2gH1E2odNS9KY" alt=""><figcaption></figcaption></figure>

To find additional HEX color codes, visit:  <https://colorhunt.co>

### Add custom images to the assets folder

With Palo Alto, you can upload your own custom swatch images and display them on product and collection pages.

How to:

{% hint style="success" %}

* Create a small square image (60x60 or 100x100 for best results)
* Upload to the **assets** folder
* Modify `swatches.json` to include your color name and image
  {% endhint %}

## Disabling swatches

Swatches can be toggled in the theme settings under Swatches -> Type.

<figure><img src="/files/RNwgkAVlGLMsELQLL3QW" 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://palo-alto.presidiocreative.com/products/palo-alto-product-pages/custom-color-swatches.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.