> 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/compatibility/supported-themes.md).

# Supported themes & compatibility

OPTIS Color Swatch is built to work with most Shopify themes out of the box, with no coding required.

## How compatibility works

The app detects your theme and applies the right configuration automatically, in three layers:

1. **Shopify free themes**: full, dedicated support for the latest **Horizon** theme family and the **Dawn / Online Store 2.0** family.
2. **Premium themes**: 40+ popular paid themes have their own built-in configuration (listed below).
3. **Automatic fallback**: for any other theme, the app uses smart detection to place swatches correctly. This works for the vast majority of themes even if they are not named here.

## Shopify free themes

Full support for Shopify's free themes, including the newest **Horizon** family:

> **Horizon family:** Horizon · Pitch · Atelier · Fabric · Dwell · Heritage · Ritual · Savor · Tinker · Vessel
>
> **Dawn / Online Store 2.0 family:** Dawn · Sense · Craft · Spotlight · Refresh · Studio · Ride · Origin · Taste · Publisher · Crave · Colorblock

## Premium themes with dedicated support

These popular paid themes have their own built-in configuration:

> Beauty · Charge · Concept · Desert · Edge · Editions · Ella · Empire · Enterprise · Envy · Gain · Glozin · Grid · Hello Gorgeous · Impact · Impulse · Kalles · King · Motion · Palo Alto · Peach Melody · Pipeline · Plain Jane · Prestige · Release · Rise · Rokan · Shapes · Showcase · Shrine · Sitar · Sleek · Sofine · Starlite · Stiletto · Symmetry · Trade · Woodmart · Xtra · Yuva · Zendrop

## Works with dynamic content

Swatches keep working even when parts of the page are loaded dynamically. The app watches for content changes and re-renders automatically, so it works with:

* **Quick view / quick shop** popups and drawers
* **AJAX collection loading**, infinite scroll, and "load more"
* Other apps and theme features that inject products into the page after it loads

No manual setup is needed for these in most cases.

{% hint style="info" %}
Building a custom integration? See [Swatch events & app integration](/swatch/developers/swatch-events-and-integration.md) for the JavaScript events and the `runScript` helper to re-render after your own code updates the page.
{% endhint %}

## If your theme is not listed

Even if your theme is not named above, the automatic fallback usually handles it. If swatches do not appear or look out of place:

* Make sure the **app embed** is enabled (see [Quickstart](/swatch/getting-started/quickstart.md) and [Why aren't my swatches showing up on the store?](/swatch/frequently-asked-questions/why-arent-my-swatches-showing-up-on-the-store.md)).
* Heavily customized themes may need a small manual adjustment.

{% hint style="success" %}
**Need help with your theme?** Contact our support team via live chat or email <support@optis.me>. We offer custom setup and theme integration to make swatches work on your store.
{% endhint %}