Skip to content
  • There are no suggestions because the search field is empty.

Shopify App: Migrate from Custom App (Deprecated) to Official Convert Shopify App

Remove the legacy Custom App, clean your theme, and install the official Convert Shopify app—fast

THIS ARTICLE WILL HELP YOU:

Who should use this guide?

If your Shopify store previously used the Convert Shopify Custom App (now deprecated), follow this guide to remove it and switch to our official Shopify App. This ensures compatibility with Shopify’s latest platform changes and guarantees future support.

📒 Tip:

The official Convert Shopify App supports Online Store 2.0 themes and provides a simplified, secure setup, automatic script installation, and goal configuration.

Before you begin

  • Access required: Shopify Admin access to your store. For step 1 (deleting the legacy custom app), you’ll also need access to the Shopify Partners account that owns the app.

  • Back up your theme(s): In Online Store → Themes, duplicate your live theme and any other themes you plan to clean up.

  • Pause running tests: If you currently run Convert experiments on Shopify, pause them first.

Step 1 — Delete the legacy Custom App (Shopify Partners)

  • Sign in to Shopify Partners: https://partners.shopify.com/

  • Go to Apps → All apps and open your existing Convert custom app.

  • Navigate to Build → Configuration and choose Delete this app (near the bottom).

💡Note:

This removes the custom app container. You will still remove legacy theme files in Step 2.

Step 2 — Clean up legacy theme code (all themes, not just current)

  1. Sign in to Shopify Admin: https://admin.shopify.com/

  2. Go to Online Store → Themes.

  3. For your Current theme, click … → Edit code. Repeat the same cleanup for any other previously active themes.

  4. Delete the following files if present:

    • assets/convert_checkout.js

    • snippets/convert.liquid

  5. Open layout/theme.liquid and remove the legacy Convert block (if present):

    <script type="text/javascript">
    var _conv_page_type = "";
    var _conv_category_id = "";
    var _conv_category_name = "";
    var _conv_product_sku = "";
    var _conv_product_name = '';
    var _conv_product_price = "";
    var _conv_customer_id = "";
    var _conv_custom_v1 = "";
    var _conv_custom_v2 = "";
    var _conv_custom_v3 = "";
    var _conv_custom_v4 = "";
    </script>
  6. Save your changes.

🔁 Repeat this cleanup for every theme that might still contain these files or the include.

Step 3 — Install the official Convert Shopify App

Follow our official installation guide to add and configure the new app:

  1. In Shopify Admin, go to Apps → Shopify App Store and install Convert Experiences.

  2. Open Apps → Convert Experiences and click Start Setup.

  3. Authenticate using your Convert API Key (Account Settings → API Keys in Convert).

  4. Select your Project, Store Currency, and the Goal you use to track completed checkouts, then Save.

  5. Under the Theme section, click Install Tracking Script to open the theme editor and toggle the app block ON, then Save.

  6. In the app, click Check Tracking Script to verify the installation.

ℹ️ Theme compatibility: The official app is compatible with Online Store 2.0 themes. If you use a legacy theme, migrate to an OS 2.0-compatible theme for full app embed support.

Step 4 — Verify and QA

  • Use the Check Tracking Script button in the app to confirm the script is active.

  • Load a few key storefront pages and confirm your experiments/goals register in Convert.

  • (Optional) Use the Convert Chrome Debugger to inspect integration events for deeper verification.

Frequently asked questions

Do I need to remove the legacy code from old or unpublished themes?
Yes. Remove the files/snippet from any theme (live or not) to avoid accidental re-introduction when switching themes.

What if I used the manual/legacy installation instead of the custom app?
That’s fine—after cleanup, you can either install the official app (recommended) or follow the latest manual integration guide if you have a custom setup.

Related: Convert Shopify Manual Integration

Will my historical experiment data be preserved?
Yes, your historical data remains in Convert. The migration only changes how Shopify sends events to Convert.

Is revenue tracking supported?
Yes. The official app includes goal configuration for revenue tracking and other Shopify events. Make sure you’ve selected the Revenue goal during Step 3.

Troubleshooting

  • I don’t see snippets/convert.liquid → It may have a different name in very old setups. Search your theme for render 'convert' or “convert” references and remove them.

  • App says tracking is not installed → Ensure the app embed is toggled ON and that you saved the theme editor. Then click Check Tracking Script again.

  • Using a different checkout domain (Hydrogen / headless) → See Shopify-specific guidance in our Shopify section for cross-domain tracking.