We looked at what currently ranks for “how to add virtual try-on to Shopify.” The top result was created in May 2024 and last touched in February 2025. It has no screenshots, no mention of theme app blocks versus app embeds, and its entire instruction is “install the app, then go to your Shopify admin dashboard.”
That’s not a guide. Here’s the actual mechanics, sourced from Shopify’s own developer and help documentation, plus the failure modes real merchants have hit.
One note before we start: production screenshots for your specific theme belong here when this goes live — the admin navigation below is verified against Shopify’s documentation, but the exact screen will vary slightly by theme.
App block or app embed — which one is a try-on button?
Shopify’s Online Store 2.0 architecture gives apps two different ways to add themselves to your storefront, and they’re not interchangeable. An app block is placed at a specific spot inside a specific template — the mechanism you want for a “Try It On” button that needs to sit next to your Add to Cart button. An app embed is a global, site-wide toggle for things like chat widgets or floating elements that don’t need precise placement.
For a try-on button on the product page specifically, the correct mechanism is an app block. If an app only offers a global embed, you have far less control over exactly where the button appears relative to size selection and Add to Cart — worth checking before you install.
Both are built on Shopify’s theme app extensions framework. One technical detail worth knowing if something looks broken later: app blocks aren’t supported in statically rendered sections — they need a JSON template — and a section that supports app blocks can only include one resource setting of each type.
What are the actual steps?
To activate an app embed: Shopify admin → Online Store → Themes → Edit theme (opens the theme editor) → the App embeds icon in the left sidebar → find the app → toggle it on → Save. To add an app block: Online Store → Themes → Edit theme → navigate to the product template → Add block → select the app from the Apps section → Save.
That’s it. No code, if the app is built correctly and your theme is current. The two paths matter because a try-on app might ship one, the other, or both — and where you’ll go to turn it on depends on which.
Will it work on my theme?
Only if you’re on an Online Store 2.0 theme. Shopify’s own theme architecture comparison lists “enhanced app support” — install apps and add functionality anywhere via app blocks and embeds, without code — as available only on OS 2.0 themes, and explicitly unavailable on Vintage themes. Vintage themes are no longer in the Theme Store and, if free, receive only security fixes.
If you’re on an older theme, app blocks and embeds simply aren’t an option. The try-on app’s fallback is usually custom code injection — messier, harder to remove cleanly, and worth asking the vendor about directly rather than discovering after you’ve installed.
Will it slow my store down?
Shopify’s own performance documentation names installed apps as one of the biggest factors affecting store speed, and specifically warns that “too much JavaScript in your store from either theme code, app code, or third party/tag manager code” is the likely cause of poor Interaction to Next Paint scores. A try-on app that calls an external API to generate an image is exactly the kind of app this warning is about.
Two things worth doing before you commit to one: ask what the app loads on every page versus only on interaction (a script that only fires when the try-on button is pressed is much lighter than one that loads on every product page load), and test your actual product page speed before and after installing, not just take the vendor’s word for it.
One more thing Shopify’s docs flag that’s easy to miss: uninstalling an app doesn’t automatically remove its code from your theme. If you trial a try-on app and drop it, you may need to go back into the theme code yourself or contact the developer for full removal.
What actually goes wrong, based on real merchant reports
The most common failure isn’t the app itself — it’s a mismatch between what you’re editing and what’s live. Real, documented cases from Shopify’s own merchant community: an app embed toggle that appeared on a development store but not the live store, on the identical theme, with the app developer and Shopify support each pointing at the other. An app block enabled and visible in the theme editor that never appeared on the actual live product page — one community member’s suggested cause was the live product using a different template than the one being edited. An app-embed toggle that vanished from every store after the developer pushed an update through their deployment pipeline.
Before you conclude an app is broken, check three things: that you’re editing the live theme, not a draft or development copy; that the specific product you’re testing uses the same template as the one you added the block to (Shopify allows multiple product templates, and this catches people constantly); and that you’re viewing the published storefront, not a theme preview.
A short pre-install checklist
Note on labels: Shopify’s admin currently labels this button “Edit theme,” not “Customize” — some third-party guides still say “Customize” from an earlier version of the interface. Confirm the current label in your own admin before writing internal instructions.
Confirm you’re on an Online Store 2.0 theme. If not, this whole process changes.
Ask whether the try-on feature is an app block or app embed — it determines how much control you have over placement.
Check your product templates. If you use more than one, you’ll need to add the block to each.
Get your product images ready before you install anything. A high-quality try-on render needs a clean source image — see our post on Google’s own image requirements for the baseline to aim for.
Test page speed before and after, on mobile specifically, since that’s where most fashion traffic is.
Ask what happens on uninstall. Get it in writing that removal is clean.
FAQ
- What’s the difference between an app block and an app embed on Shopify?
- An app block sits at a specific position within a specific template — the right choice for a try-on button that needs to appear next to Add to Cart. An app embed is a global toggle for elements that don’t need precise placement, like a chat widget. Some apps offer both.
- Do app blocks work on every Shopify theme?
- No. They require an Online Store 2.0 theme. Vintage (legacy) themes don’t support app blocks or app embeds at all, per Shopify’s own theme architecture documentation.
- Will installing a virtual try-on app slow down my store?
- It can. Shopify’s own performance guidance names installed apps and their JavaScript as a leading cause of slow Interaction to Next Paint scores. Ask whether the app’s script loads on every page or only when a customer interacts with it, and test your product page speed before and after installing.
- I enabled the app block but it’s not showing on my live product page — why?
- The most common cause, per Shopify’s merchant community, is a template mismatch: the product you’re viewing live uses a different template than the one you edited in the theme editor. Check which template your test product is actually assigned.
- If I uninstall the app, does everything go back to normal?
- Not automatically. Shopify’s documentation states that uninstalling an app doesn’t remove its code from your theme — you may need to remove it manually or contact the developer.
Sources. Shopify Help Center, “Extend your theme with apps” · Shopify.dev, “About theme app extensions” and “App blocks for themes” · Shopify Help Center, “Theme architecture versions and sources” · Shopify Help Center, “Improving your online store performance” · Shopify Community forum threads on app embed/block visibility issues, accessed August 2026.
Last updated 25 August 2026.
