Kiwi Size Chart & Recommender is designed to be flexible across many Shopify themes - but some behaviors depend on how your theme, product templates, and variant logic work.
This article explains what Kiwi fully supports, what has limitations, and what is not currently supported so that you can avoid common setup issues and confusion.
✅ Fully Supported Behaviors
These setups work reliably across most Shopify themes when configured correctly.
1. Displaying a Size Chart on Product Pages
Show a size chart as a modal (popup) or inline block
Works on:
Default product templates
Custom product templates
Theme sections that do not reload on variant change
2. Using the Kiwi App Block (Required & Recommended)
The Kiwi App Block is what loads and initializes Kiwi on the product template.
Without it, the size chart will not appear - regardless of your display or injection settings.
What the app block does:
Ensures Kiwi is properly loaded on the product page
Connects the product template to Kiwi’s display logic
Allows Kiwi’s placement rules (display settings or injection selectors) to run correctly
Best for:
Online Store 2.0 themes
Merchants who want a stable, supported setup
Stores without heavy custom theme overrides
3. Using a Custom Injection Selector
Allows advanced placement using a CSS selector (e.g. after the variant picker)
Supported when:
The selector targets a static element
The element does not reload on variant change
⚠️ Requires careful selector choice (see limitations below)
4. Multiple Size Charts Across Products
Different products can use different charts
Works via:
Applied Products (Matching Conditions)
Collections
Tags
5. Variant-Based Recommendations (Recommender)
Size recommendations update based on user input
Supported across most themes when inputs are rendered normally
⚠️ Supported With Limitations
These behaviors may work, but they depend heavily on your theme or setup.
6. Inline Placement Next to Variant Options
This can work, but only if:
The target element does not re-render on variant change
The chart is placed outside dynamic containers
Common issues:
Chart disappears after selecting a variant
Chart jumps position
Duplicate charts appear
👉 In these cases, switching to the app block or adjusting the selector is required.
7. Themes With Heavy JavaScript Variant Reloading
Some themes (and variant apps) fully re-render sections when a variant changes.
Result:
Inline charts may reset or disappear
Selectors that worked initially may fail after interaction
✅ Usually resolved by:
Moving the chart outside the reloading container
Using the app block instead of injection
8. Compatibility With Variant Apps (e.g. Swatch King)
Kiwi can work with variant apps, but:
The size chart must not be injected inside variant-generated markup
Special placement rules may apply
If you’re using a variant app, we recommend:
Using the app block or
Placing the chart below the entire variant section
❌ Unsupported Behaviors
These are not currently supported and will lead to inconsistent behavior.
9. Forcing Inline Charts Inside Variant Inputs
Examples:
Inside radio button markup
Inside
<form>elements that reload on variant changeInside dynamically generated swatch containers
❌ This will cause the chart to:
Disappear
Duplicate
Break on variant change
10. Expecting Kiwi to Override Theme Reload Logic
Kiwi does not:
Prevent your theme from re-rendering sections
Override JavaScript variant logic
Persist elements inside destroyed DOM nodes
If a theme removes an element, Kiwi cannot “hold it in place.”
11. Automatic Support for All Custom Themes
Highly customized themes may:
Use non-standard markup
Replace DOM elements dynamically
Require manual placement decisions
In these cases, custom troubleshooting or escalation may be needed.
✅ Best Practices (Highly Recommended)
To avoid issues:
✅ Use the Kiwi app block whenever possible
✅ Place charts outside variant-reloading containers
✅ Test variant changes after placement
✅ Avoid injecting into inputs, swatches, or dynamic forms
✅ If unsure, start with modal display first
🧭 Not Sure What Setup You’re Using?
To help us assist you faster, please have:
Your theme name
A product page URL
Whether you’re using:
App block
Injection selector
Variant apps (like Swatch King)