To add virtual try-on to a Shopify store you install a try-on app from the App Store, switch it on in the theme editor as an app embed or place it as an app block on the product template, check your product photos meet the vendor's spec, and test on a live product page — about thirty minutes on an Online Store 2.0 theme, and not possible at all on a vintage theme without code changes. This guide is the full path, including the parts the vendor how-tos leave out.

What do you need before you start?
Is your theme compatible?
How do you install and enable the app?
App embed or app block — which do you want?
What product photos does it need?
What goes wrong, and how do you fix it?
How do you know it's working?
Where Spequlo fits
Questions, answered

What do you need before you start?

Three things.

An Online Store 2.0 theme. This is the requirement most guides skip and the one that generates the most support tickets. App embeds and app blocks only work on themes built with JSON templates — every free Shopify theme released since 2021 and most paid themes on the Theme Store. Legacy Liquid-only themes cannot use them. Check below before installing anything.

Product photos that meet the spec. Generative try-on renders from your existing product images, but it is particular about them. Details in the photography section.

Your size chart, if the app you pick offers size guidance. Have it as a spreadsheet or a clean table, per garment type.

Is your theme compatible?

Go to Online Store → Themes. If your live theme is Dawn, Sense, Craft, Refresh, Ride, Studio or any theme installed from the Theme Store in the last few years, it's Online Store 2.0. To confirm on any theme: click Customize, open the product template, and look for an Add block option inside a section, and an App embeds icon (the puzzle piece) in the left sidebar. If both are there, you're fine.

If your theme is older and was customised heavily by an agency, it may be vintage. The tell is the error in the next-but-one section. Options at that point are to update to a 2.0 version of the theme, or to have a developer inject the app's snippet into theme.liquid manually.

How do you install and enable the app?

Open the app's listing on the Shopify App Store and click Install. Approve the permissions — a try-on app needs to read products and, if it does size guidance, to read your size chart.
Complete the app's onboarding. This is where you choose which products or collections get the try-on button, set the button's colour, shape and text to match your theme, and connect a size chart if the app supports one.
Go to Online Store → Themes → Customize.
In the left sidebar, click the App embeds icon (puzzle piece).
Find the try-on app in the list and toggle it on.
Click Save.
Open a product page on the live store. The try-on button should be there.

That's the whole install for an embed-based app. Total time is dominated by step 2.

App embed or app block — which do you want?

Shopify offers two ways for an app to appear on your storefront, and try-on vendors use both.

An app embed is a floating or injected element that isn't tied to a position in your layout — the mechanism chat widgets use. You switch it on once and it appears wherever the app decides. Easiest to install, works across every product page automatically, but you don't control exactly where the button sits.

An app block is placed at a specific position inside a specific section of the product template — directly under the price, beside the size selector, wherever you drag it. To add one: Customize → Product template → click the section → Add block → Apps → choose the app's block, then drag it into position and Save. More control, one more step, and the same 2.0 theme requirement.

For a try-on button, an app block is usually the better-looking result because the button sits inline with the buy box. An app embed is the faster install and the one to choose if your product template is built with a page builder — see below.

→ See the Spequlo button inline on a product page

What product photos does it need?

Generative try-on is only as good as the garment image it is given. Google's Merchant Center spec for its own try-on feature is a sensible baseline most vendors match:

Resolution: at least 512×512, ideally 1024px or larger on the long edge.
One garment, fully visible, not obscured by hands, props or accessories.
Minimal wrinkles. The model reproduces what it sees, including a creased hem.
On-model, mannequin or flat lay all work. If on-model: facing forward, arms at sides, simple pose. FASHN's API documentation explicitly accepts flat-lay, ghost-mannequin and on-model inputs.
Tops: sleeves down, hoods down, zippers closed, untucked.
Clean, uncluttered background. Lifestyle shots with a busy setting render badly.

If your primary product image is a styled lifestyle shot, add a clean flat-lay or ghost-mannequin image as a secondary and point the app at it. Most apps let you choose which image is the try-on source per product.

What goes wrong, and how do you fix it?

"Liquid templates don't support sections and blocks." The most common failure, documented on the Shopify Community (thread 592520, where a merchant hit exactly this installing a try-on app block). It means the product template — or the whole theme — is vintage. Fix: update the theme to a 2.0 version, or use an app embed instead of a block if the app offers one, or have a developer add the snippet by hand.

The button doesn't appear on pages built with PageFly, Shogun or GemPages. Page builders render their own markup outside Shopify's section-and-block schema, so an app block often can't be inserted into a builder-built page. Fix: use the app embed, or use the page builder's own "custom Liquid" or "HTML" element to place the app's snippet.

The button appears but the try-on fails. Almost always the product image. Check it against the spec above — a lifestyle shot, a low-resolution image or a garment partly out of frame will produce a blank or distorted result.

Page speed drops. Every app embed adds script. Shopify's Built for Shopify standard is that an app must not cut the storefront Lighthouse performance score by more than 10 points; hold every vendor to that number whether they have the badge or not. Test with PageSpeed Insights before and after install.

Code left behind after uninstall. Rare with app embeds and blocks, which Shopify removes cleanly, but a real complaint against older apps that required manual snippet insertion. If you're removing a legacy app, check theme.liquid afterward.

How do you know it's working?

Not from the before-and-after. Conversion moves with the calendar, and a try-on installed in early November will look brilliant through Black Friday regardless of whether it did anything.

The method that holds up is a random session holdout: some product-page sessions see the try-on, some don't, assignment is random and sticky, and you compare the two groups over the same period. Some apps run this for you. We've written the full method up separately, including how many sessions you need — for a store at 2% baseline conversion, detecting a 25% relative lift takes roughly 14,000 sessions per arm.

Whichever app you pick, check its analytics for three things after the first two weeks: try-on open rate on product pages, add-to-cart rate for sessions that opened it versus didn't (directional only — those shoppers self-selected), and whether return reasons shift once the return window closes.

Where Spequlo fits

Spequlo installs as an app embed on Online Store 2.0 themes — the seven steps above, with the size-chart upload in step 2 if you want fit guidance alongside the try-on. It works from the product photography you already have, is free on the Shopify App Store, and runs a session holdout on your traffic by default so you get a treatment-versus-control read rather than a before-and-after.

→ Install Spequlo free from the Shopify App Store

Questions, answered

Do I need a developer to add virtual try-on to Shopify? Not on a 2.0 theme — it's an app install and a toggle. On a vintage theme, yes, for the snippet insertion, or update the theme first.

Will it work on my theme? If the theme is Online Store 2.0 (JSON templates), yes. If it's vintage Liquid-only, app embeds and blocks aren't available. Check for the App embeds icon in the theme editor.

Can I put the try-on button exactly where I want it? With an app block, yes — drag it into position on the product template. With an app embed, the app decides placement.

Does adding a try-on app slow down my store? It adds script, so yes, marginally. Shopify's standard is no more than a 10-point Lighthouse drop; measure before and after.

Do I need to reshoot my products? Usually not. Clean flat-lay or on-model images at 1024px or better, garment fully visible, work with every generative app. Busy lifestyle shots are the main thing that needs replacing.

How long does the whole thing take? Roughly thirty minutes on a compatible theme, most of it in the app's onboarding. Longer if you have many products to configure individually or a size chart to format.

How to Add Virtual Try-On to Your Shopify Store (2026)

Contents