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

Migrate from the Deprecated Convert Shopify Custom App

Remove the deprecated Shopify Custom App, clean up legacy theme code, and install the official Convert Experiences Shopify App.

THIS ARTICLE WILL HELP YOU:

Overview

This guide explains how to remove Convert’s deprecated Shopify custom or legacy app and migrate your store to the official Convert Experiences Shopify App.

Complete the cleanup steps before installing the official app. This helps prevent duplicate tracking scripts, outdated theme files, and conflicts with JavaScript left behind by the previous integration.

⚠️ Important

If your store already uses the official Convert Experiences Shopify App, you do not need to manually install, replace, or upgrade the Convert tracking script. The official app installs and manages the supported Convert tracking implementation for you.

The general tracking-script migration guide is intended for websites where the Convert script was installed manually. It does not apply to stores already using the official Shopify App.

Before you begin

Make sure that:

  • You have permission to manage Shopify apps and edit theme code.
  • You have access to the Convert project that will be connected to the store.
  • You create a backup or duplicate of each Shopify theme before changing its code.
  • You check the current theme and any previously published themes that may contain the legacy integration.

Step 1: Delete the deprecated custom app

The deprecated custom app was created and managed through Shopify Partners.

To delete it:

  1. Sign in to the Shopify Partners portal.
  2. From the left-side navigation, go to Apps → All apps.
  3. Open the existing Convert custom app.
  4. From the left-side navigation, go to Build → Configuration.
  5. Scroll toward the bottom of the page.
  6. Select Delete this app and confirm the deletion.

Deleting the custom app does not automatically remove the files and code that were previously added to your Shopify themes. Complete the next steps to remove those items.

Step 2: Remove the legacy integration from your Shopify themes

You must clean up every theme where the deprecated integration was installed.

  1. Sign in to your Shopify Admin.
  2. Go to Online Store → Themes.
  3. Locate your current theme.
  4. Open the theme’s action menu and select Edit code.
  5. Repeat this cleanup for any previously published theme that may contain the Convert integration.

Delete the legacy files

Delete the following files if they are present:

assets/convert_checkout.js snippets/convert.liquid

Do not delete files with similar names unless you have confirmed that they belong to the old Convert integration.

Remove the legacy code from theme.liquid

In the theme code editor:

  • Open:
layout/theme.liquid
  • Find the following complete block:
<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>

  • Delete the entire block.
  • Save the file.

Be careful not to remove unrelated scripts or Liquid code from theme.liquid.

Step 3: Remove JavaScript from the previous integration

Delete any Custom JavaScript that was added specifically for the deprecated custom app or manual Shopify integration.

Depending on how the original integration was configured, check the following locations:

  • Convert’s Global Project JavaScript
  • Shopify theme files
  • Shopify custom pixels
  • Google Tag Manager or another tag manager
  • Other scripts added during the original installation

Remove only code associated with the old Convert integration. Do not delete unrelated experiment code, analytics integrations, or storefront functionality.

Step 4: Install the official Convert Experiences Shopify App

After removing the deprecated app, theme files, Liquid code, and old Custom JavaScript, install the official Convert Experiences Shopify App.

Follow the installation and connection instructions in this guide.

During the setup, make sure you:

  1. Install the official Convert Experiences app.
  2. Connect it to your Convert account.
  3. Select the correct Convert project.
  4. Configure the requested Shopify goals.
  5. Save the configuration.
  6. Enable the Convert app embed in the active Shopify theme when prompted.

The official app handles the supported Convert tracking implementation. Do not manually add another copy of the Convert tracking script after installing it.

Step 5: Verify the migration

After completing the migration, confirm that:

  • The deprecated custom app has been deleted from Shopify Partners.
  • assets/convert_checkout.js has been removed from all affected themes.
  • snippets/convert.liquid has been removed from all affected themes.
  • The legacy Convert block has been removed from layout/theme.liquid.
  • Custom JavaScript from the previous integration has been removed.
  • The official Convert Experiences Shopify App is connected to the intended Convert project.
  • The app embed is enabled in the active Shopify theme.
  • The storefront loads normally.
  • Convert is not being loaded twice.
  • Your Shopify goals and revenue tracking work as expected.

We recommend validating the installation on the storefront and performing a controlled test order before starting or resuming live experiments.

Troubleshooting

Convert appears to load twice

A second copy of the Convert script may still be installed manually.

Recheck:

  • layout/theme.liquid
  • Shopify snippets and assets
  • Convert Global Project JavaScript
  • Shopify custom pixels
  • Google Tag Manager
  • Any third-party script manager

The official Shopify App should be the only installation method used after the migration.

Experiments stopped working after the cleanup

Confirm that:

  • The official app is connected to the correct Convert project.
  • The app configuration was saved.
  • The Convert app embed is enabled in the active theme.
  • The pages being tested belong to the selected Convert project.

Shopify goals are not being recorded

Confirm that the required goals exist in the selected Convert project and that the correct goal IDs were configured in the Shopify App.

Also verify that the app is connected to the same Convert project in which the experiments are running.

You are unsure whether code belongs to the old integration

Restore your theme backup if necessary and contact Convert Support before deleting additional code.