What is Changing
Previously, ABConvert test relied on injected storefront scripts directly in your theme or multiple ABConvert app embeds.
After migration to the new setup, all script and all functions will be unified into one single ABConvert theme embedded app. You can full control test scripts in your theme easily and simply by enabling or disabling the embedded app.
Why ABConvert is making this change
The new theme app embed setup is designed to make ABConvert easier to maintain and safer for your store theme.
Cleaner uninstall and cleanup
Injected theme scripts can be harder to remove completely, especially when you use apps like page builders that maintain their own theme liquid files. The app embed approach simplifies cleanup since Shopify manages it through the theme editor rather than direct code modifications.
One setup instead of multiple app embeds
Users no longer manage separate embeds for different test types. A single enabled embed handles all supported storefront tests.
always on the latest script version
With the unified embed, your storefront automatically picks up the latest ABConvert script. Previously, you'd only get script updates the next time you created a test, which meant some stores ran on older versions longer than necessary.
Theme tests can run alongside other tests (coming soon)
The unified embed unlocks running theme tests concurrently with other test types (price, shipping, etc.) on the same store. This was not possible under the old setup where each test type ran from a separate script.
How to migrate
You will find Migration setup in ABConvert homepage, simply follow the steps to migrate.
Step 1. Disable old ABConvert app embeds
Click "Open theme editor" and disable all ABConvert app embeds in your theme and save.
Go back to the banner, click "Verify status" to check and continue to the next step.
Step 2. Enable new ABConvert app embed
Click "Enable in theme", check the ABConvert embed app is enable and save.
Go back to the banner, click "Verify status" to check and continue to the next step.
Step 3. Migrate your active tests
Click Migrate tests and wait for ABConvert to finish the migration.
After migration, your active tests will continue running through the new app embed setup, no other action needed!
FAQ
What happens to my existing tests after I migrate?
Your active tests will move to the new app embed setup and continue to run without any gap. You do not need to rebuild variants, traffic split, audience settings, or analytics setup.
What happens if I do not migrate right away?
Rest assure, your existing setup will not break and your test will continue to run as usual. However, we strongly recommend migrating so your store can use the latest ABConvert script version, best performance, and cleaner setup management.
Do I need to keep the ABConvert app embed turned on?
Yes. We recommend keeping the ABConvert app embed turned on, even when you are not running tests. It will not affect your store if there's no active tests running, and it keeps your store ready for future tests and helps ABConvert confirm your storefront is connected.
What should I do after changing or publishing a new theme?
Confirm the ABConvert app embed is enabled on the theme where your tests should run. Modifying a theme will not affect the embed app, but changing to a new theme will need to enable ABConvert app in the new theme before starting a test.
What happens if ABConvert is not connected?
You can still view existing test data and historical analytics. However, ABConvert will ask you to reconnect before you preview, launch, or continue tests that need the storefront script.
What should I do if my test feels slower or I notice flickering?
The app embed is recommended for most stores, but some custom themes may perform better with manual installation. If you notice slower loading or flickering, contact ABConvert support and we can help check whether manual setup is a better fit.
Can I use manual theme code installation instead of the app embed?
Yes, but manual theme code installation is a fallback option that requires a lot of manual setup and continuously management. We recommend using the Shopify theme app embed first because it is easier to manage, safer for theme updates, and reduces leftover script issues.