App language
Change the language of the Swatch King app dashboard for the current device. This setting is device-specific — each team member can set their own preferred language independently without affecting others.
Available languages:
Chinese (Simplified)
Chinese (Traditional)
Danish
Dutch
English
French
German
Italian
Japanese
Portuguese
Spanish
Turkish
For translating badge text and option labels for different storefronts and markets, use the Localisation settings in the app instead.
Badge settings
Badges are small labels displayed directly on swatches to communicate important variant-level information to customers at a glance. Badge settings apply globally to all swatch-based product page styles.
There are two badges available:
Sale badge
The Sale badge is displayed on a swatch when the variant has an active discount that meets or exceeds the configured sale threshold.
Badge text
You can customize the text displayed on the Sale badge. The default text is SALE. You can replace this with any custom text, or use dynamic variables to display discount information automatically.
Available variables:
{{currency_symbol}}— displays the store's currency symbol (e.g. $){{currency_code}}— displays the store's currency code (e.g. USD){{amount_save}}— displays the exact amount saved on the variant{{percentage_save}}— displays the percentage discount on the variant
For example, setting the badge text to Save {{percentage_save}} would display as "Save 20%" on a variant with a 20% discount. Variables can be combined with plain text to create fully custom badge labels.
For stores serving multiple markets, badge text translations can be managed in the Localisation settings.
Sale threshold
The sale threshold sets the minimum discount percentage a variant must have before the Sale badge is displayed. If a variant's discount is below the threshold, the badge will not appear on that swatch.
For example, if the sale threshold is set to 10%, a variant with a 5% discount will not show the Sale badge, while a variant with a 15% discount will.
This helps avoid showing a badge for minor or insignificant discounts that are not meaningful to customers.
Appearance
You can adjust:
Fill color — the background color of the Sale badge
Font color — the text color of the Sale badge
Sold out badge
The Sold out badge is displayed on a swatch when the variant's inventory has reached zero and the product is not set to continue selling when out of stock.
Badge text
You can customize the text displayed on the Sold out badge. The default text is SOLD OUT. You can replace this with any custom text that fits your store's tone, such as "Unavailable" or "Out of stock".
For stores serving multiple markets, badge text translations can be managed in the Localization settings.
Appearance
You can adjust:
Fill color — the background color of the Sold out badge
Font color — the text color of the Sold out badge
Important note: The Sold out badge will not appear on variants that have been set to continue selling when out of stock in Shopify. It only applies to variants where inventory tracking is enabled and the stock has been fully depleted.
Size Chart settings
The Size Chart settings allow you to connect a third-party size chart app to Swatch King and control how and where the size chart link or button appears alongside your product options on the storefront.
Size Chart app
Select the size chart app you have installed on your store from the dropdown list. Swatch King will integrate with the selected app to display the size chart alongside your variant selectors.
Currently supported size chart apps:
Kiwi Size Chart & Recommender
BF Size Chart & Size Guide
Mage Size Chart & Size Guide
Size Chart & Size Guide by CSC
Smart Size Chart & Size Guide
Clean Size Charts
Size chart by Vitals
Jotly Size Chart & Size Guide
Pify Size Charts & Size Guides
ESC Size Chart
ScaleChart
If your size chart app is not listed, contact the Swatch King support team via the chat link on this page to request integration.
Size chart alignment
Choose how the size chart link or button is displayed relative to the option label on the product page. The option label refers to the name of the product option, for example "Size".
Available options:
Inline with label right — the size chart link is displayed on the same line as the option label, positioned to the right of it
Inline with label — the size chart link is displayed on the same line as the option label, positioned immediately next to it
Product options
Select which product options the size chart should appear alongside. For example, selecting "Size" will display the size chart link next to the Size option on the product page.
This setting is required for the size chart to display correctly. If no product options are selected here, the size chart will not appear on the storefront even if the app is connected and active. Make sure the options selected here match the exact option names used in your products.
Option selection
By default, Shopify automatically pre-selects the first available variant on a product page. This means a customer intending to buy XL may not notice that S is already selected, leading to wrong orders and avoidable returns.
The Option selection setting solves this by forcing customers to manually select an option value before they can add a product to the cart. Until a selection is made, the option label shows a prompt and the Add to Cart button remains disabled, ensuring no order is placed without a deliberate choice.
Search product options
Search for and select the specific product options you want to enforce manual selection on. For example, selecting "Size" will require customers to actively choose a size before they can proceed. You can apply this to one or multiple options depending on your store's needs.
Only the options added here will require manual selection. Options not listed here will continue to behave as normal.
Option label text when variant is not selected
Customize the text displayed in the option selector before a customer makes a selection. The default text is Select a {{ option_name }}, which will display dynamically based on the option name — for example, "Select a Size" or "Select a Color".
You can replace or combine this with any custom text while keeping the {{ option_name }} variable to retain the dynamic option name in the label.
"Add to cart" button text when variant is not selected
Customize the text displayed on the Add to Cart button before a customer has made a selection. The default text is Select a {{ option_name }}, which displays dynamically — for example, "Select a Size". The Add to Cart button remains disabled until the customer selects an option value, preventing them from adding an unintended variant to the cart.
Text entered here should be in your store's published language. For stores serving multiple markets, translations can be managed in the Localisation settings.
Page settings
Page settings give merchants granular control over where Swatch King loads across their store. Rather than running the app globally on every page, merchants can enable or disable the app on specific page templates and even on specific sections within those pages.
When a page is disabled entirely, the app will not load any of its assets — including scripts and stylesheets — on that page. This helps keep page performance optimized by preventing the app from rendering on pages where it is not needed.
Home page
Control whether Swatch King loads on the home page. When the home page is enabled, you can further specify which sections of the home page the app should run on:
Enable app on featured product — enables swatches on the featured product section of the home page
Enable app on product grid — enables swatches on product grid sections such as carousels or product recommendation grids on the home page
For example, if you want swatches to appear on a product carousel but not on a featured product hero section, you can enable the product grid and disable the featured product independently.
Collection and search page
Control whether Swatch King loads on collection pages and search results pages. When enabled, you can specify:
Enable app on product grid — enables swatches on the product grid displayed within collection and search pages
Enable app on quick view — enables swatches inside the quick view modal when customers preview a product without navigating to the full product page
Product page
Control whether Swatch King loads on individual product pages. When enabled, you can specify:
Enable app on main product — enables swatches on the main product section of the product page
Enable app on product grid — enables swatches on any product grid sections on the product page, such as related products or recently viewed sections
Collections list
Control whether Swatch King loads on the collections list page, where all collections are displayed together.
Cart
Control whether Swatch King loads on the cart page.
Pages
Control whether Swatch King loads on standard Shopify pages, such as custom pages created in the Shopify admin.
Blogs and articles
Control whether Swatch King loads on blog listing pages and individual blog article pages.
Add online store password
If your Shopify store is password protected, you can share the store password with the Swatch King support team here. This allows the support team to access your storefront and provide more effective assistance when troubleshooting issues.
Your store password can be found in your Shopify admin under Online Store preferences.
Theme status
Swatch King works by embedding itself into your Shopify theme using app embeds. Clicking Manage app embeds opens the Theme status page, which gives you a full overview of the app embed status across all themes installed on your store.
Themes are divided into two sections:
Published theme
Displays your store's currently live theme. The embed status icon next to the theme name shows whether the Swatch King app embed is active on this theme. A green tick indicates the app embed is enabled and the app will render swatches on your live storefront.
If the app embed is not active on your published theme, swatches and variant selectors will not appear on your storefront even if the app is installed and fully configured.
Unpublished themes
Displays all other themes installed on your store that are not currently live. The embed status icon next to each theme name shows whether the app embed is active on that theme.
This is particularly useful when testing a new theme before publishing it. Merchants can enable and verify the app embed on an unpublished theme first, confirm that swatches are working correctly in preview, and then publish the theme with confidence that the app is already active.
Use the Manage block button next to any theme to open that theme's app embed settings directly in the Shopify theme editor, where you can enable or disable the Swatch King app embed for that specific theme.
Note: The app embed must be active on your published theme for Swatch King to function on your live storefront. Always verify the embed status on your published theme after switching or updating your store's theme, as app embeds may need to be re-enabled on a newly activated theme.