Skip to main content

Migrate to Shopify CLI

Note

As of June 30, 2025, any subscription link extension that has not been migrated into Shopify CLI will be automatically converted to be managed by Shopify CLI. To maintain full control over your extensions and avoid potential data loss, please follow the first step outlined in this guide to import them into your codebase. Failure to complete this process before deploying your next app version will prompt Shopify to delete your subscription link extensions.

If you have existing Subscription Link extensions that were created through the Partner Dashboard, then you can import these extensions into your codebase. After that, you can deploy the extensions that you've imported into Shopify CLI. Moving forward, Shopify CLI manages those extensions.

Extensions that are migrated to Shopify CLI will include the handle property, which is a globally-unique identifier for the extension. A handle property is created in the extension's TOML configuration file after running the import-extensions command.

Caution

Don't change the handle property of the extensions in your app's codebase until after you've run the dev or deploy commands. Otherwise, your migrations to Shopify CLI will not complete.

Anchor to Step 1: Import your Subscription Link extensionStep 1: Import your Subscription Link extension

The command in this step generates the local file representation of your Partner Dashboard extension.

You can only import extensions that have versions. The published version is imported, if one exists. Otherwise, the latest version is imported.

  1. Navigate to your app directory.

  2. To start importing your Subscription Link extension, run the following command:

    Terminal

    shopify app import-extensions

  3. Select Subscription Link Extensions.

  4. Select extensions from the list of extensions that are available to import.

    After you've selected the extensions, Shopify CLI automatically generates the file representation in your application's /extensions directory and displays a success message.

    /my-subscription-link-extension
    shopify.extension.toml

Anchor to Step 2: Migrate your extensionStep 2: Migrate your extension

After you've imported the extension, finalize your extension's migration to Shopify CLI by running either the dev or deploy commands.

If you haven't made any changes to your extension, then finalize the migration with the dev command.

Terminal

shopify app dev

If you have made changes to your extensions in Shopify CLI, you can create a new version by running the deploy command.

Terminal

shopify app deploy

Anchor to Step 3 (Optional): Confirm the migration to Shopify CLIStep 3 (Optional): Confirm the migration to Shopify CLI

You can confirm that your extensions have been migrated to Shopify CLI for your current or active development app version.

  1. In your Partner Dashboard, click Extensions.

  2. Select the extensions that you migrated.

    If you are no longer able to edit your extension in the Partner Dashboard and see a statement that confirms you can make changes with Shopify CLI, then your extensions have successfully been migrated to Shopify CLI.

Anchor to Next stepsNext steps

Was this page helpful?