> For the complete documentation index, see [llms.txt](https://docs.optis.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.optis.me/swatch/global-settings/two-color-swatch-split.md).

# Two-color swatch split

### **Function**

Some variant values represent **two colors** (for example, a *Black / White* option). This **Global setting** controls how those swatches are **visually split** between the two colors — and it applies **store-wide**, to every product that has two-color values.

### **Where the two colors come from**

The split only affects values that actually have **two colors assigned**. You set the first and second color per value in the [Custom swatch](https://docs.optis.me/swatch/variant-display/custom-swatch.md) editor (also available as the source for [Swatch card](https://docs.optis.me/swatch/variant-display/swatch-card.md) and [Pill swatch](https://docs.optis.me/swatch/variant-display/pill-swatch.md)).

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FQnSNYFxJHqrMVDUsKEvE%2FScreenshot%20at%20Sep%2028%2000-03-17.png?alt=media&amp;token=bc3f767e-6bec-4d1b-881d-3234c214fba5" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Assigning a **2nd color** is a premium feature. If a value has only one color, it renders as a solid swatch and this setting has no visible effect on it.
{% endhint %}

### Split directions

<table><thead><tr><th width="220">Split direction</th><th>Look</th></tr></thead><tbody><tr><td><strong>Diagonal down</strong> (default)</td><td>Split along <code>\</code></td></tr><tr><td><strong>Diagonal up</strong></td><td>Split along <code>/</code></td></tr><tr><td><strong>Horizontal</strong></td><td>Top color / bottom color</td></tr><tr><td><strong>Vertical</strong></td><td>Left color / right color</td></tr></tbody></table>

The **first color** always fills the first half and the **second color** the other half, following the direction you pick.

### **Use when**

* You sell items described by **two colors** (e.g. *Black / White*, *Navy / Red*) and want the swatch to show both.
* You want a **consistent split style** across the whole store rather than per product.

***

## How to use

{% stepper %}
{% step %}

#### Assign a 1st and 2nd color to your two-color values

In the [Custom swatch](https://docs.optis.me/swatch/variant-display/custom-swatch.md) editor, set both colors on each value that needs them. The in-app preview updates to match the direction below.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FvD4HLwoCO5agEivim29F%2FScreenshot%20at%20Sep%2027%2023-59-04.png?alt=media&amp;token=2e3321ea-8ca3-411b-a3b1-e434a4c4ec56" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Go to **Global settings** → pick a **Split direction**

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2F5mFBql83vWQluDIf0Obj%2FScreenshot%20at%20Sep%2028%2000-00-05.png?alt=media&amp;token=e14c50fc-1490-4eb5-bf54-0249704fe2f4" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Click **Save** to apply your changes

{% endstep %}
{% endstepper %}

### Related

* [🎨 Custom swatch](https://docs.optis.me/swatch/variant-display/custom-swatch.md) — assign the two colors per value
* [🪄 Auto-assign swatch](https://docs.optis.me/swatch/variant-display/auto-assign-color-swatch.md) — can fill two-color values from the value name
* [Global settings overview](https://docs.optis.me/swatch/global-settings/global-settings-overview.md)
