Theme App Embeds vs Manual Snippets: What Merchants Should Know

Shopify has evolved how apps integrate with themes. Many modern apps use Theme App Extensions (app embeds) instead of telling you to paste code into theme.liquid.

But many stores still carry years of legacy snippet installs.

That means it is common to have both:

• app embeds enabled in the theme editor
• old snippet-based includes still present in theme files

This causes duplicates, performance issues, and confusing bugs.

What are app embeds?

App embeds are toggleable integrations in the theme editor. They are:

• easier to enable/disable
• safer than manual code edits
• often scoped and managed by Shopify’s extension system

What are manual snippets?

Manual snippet installs typically mean:

• you add render/include to theme.liquid
• the app creates a snippet and sometimes assets

This approach is older, but many stores still have it.

Why having both causes problems

Common outcomes:

• widget renders twice
• same script loads twice
• tracking events fire twice

This is especially common with:

• reviews widgets
• upsell widgets
• chat widgets
• analytics pixels

How to detect duplicates

Symptoms:

• you see two badges or two widgets
• the console shows repeated logs
• network calls repeat to the same vendor domain

Safe cleanup approach

1. Duplicate the theme.
2. In the duplicate, disable the app embed.
3. Test storefront. If the widget is still there, you have a manual snippet.
4. If the widget disappears, the embed was the source.
5. If both exist, remove one of them (prefer embed for modern apps).

Do not delete files first. Remove references first, test, then delete later.

What to prefer going forward

In most cases:

• prefer app embeds for supported apps
• avoid manual snippet installs unless necessary
• after uninstalling an app, run a cleanup pass to remove snippet leftovers

Modern Shopify theme workflows are safer, but legacy artifacts still create a lot of pain. Cleaning up the duplicates is one of the highest ROI maintenance tasks you can do.

If you want a quicker way to spot duplicate widgets and risky script patterns before they become a problem, Checkpoint: Store Scanner can flag common leftover and duplication signals in a scan report.