> 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](/docs/apps/build/cli-for-apps). Moving forward, Shopify CLI manages those extensions.

Extensions that are migrated to Shopify CLI will include [the `handle` property](https://shopify.dev/docs/apps/build/app-extensions/configure-app-extensions#common-properties), 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.


## Step 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.
1. To start importing your Subscription Link extension, run the following command:

    <p>
    <div class="react-code-block" data-preset="terminal">
    <div class="react-code-block-preload ThemeMode-dim">
    <div class="react-code-block-preload-bar "></div>
    <div class="react-code-block-preload-placeholder-container">
    <div class="react-code-block-preload-code-container">
    <div class="react-code-block-preload-codeline-number"></div>
    <div class="react-code-block-preload-codeline"></div>
    </div>

    </div>
    </div>


    <script type="text/plain" data-language="bash">
    RAW_MD_CONTENTshopify app import-extensions
    END_RAW_MD_CONTENT</script>

    </div>
    </p>


1. Select `Subscription Link Extensions`.
1. 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.

    <p>
    <div class="react-code-block" data-preset="basic">
    <div class="react-code-block-preload ThemeMode-dim">
    <div class="react-code-block-preload-bar basic-codeblock"></div>
    <div class="react-code-block-preload-placeholder-container">
    <div class="react-code-block-preload-code-container">
    <div class="react-code-block-preload-codeline-number"></div>
    <div class="react-code-block-preload-codeline"></div>
    </div>
    <div class="react-code-block-preload-code-container">
    <div class="react-code-block-preload-codeline-number"></div>
    <div class="react-code-block-preload-codeline"></div>
    </div>

    </div>
    </div>


    <script type="text/plain" data-language="text">
    RAW_MD_CONTENT/my-subscription-link-extension
      shopify.extension.toml
    END_RAW_MD_CONTENT</script>

    </div>
    </p>


## Step 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.

    <p>
    <div class="react-code-block" data-preset="terminal">
    <div class="react-code-block-preload ThemeMode-dim">
    <div class="react-code-block-preload-bar "></div>
    <div class="react-code-block-preload-placeholder-container">
    <div class="react-code-block-preload-code-container">
    <div class="react-code-block-preload-codeline-number"></div>
    <div class="react-code-block-preload-codeline"></div>
    </div>

    </div>
    </div>


    <script type="text/plain" data-language="bash">
    RAW_MD_CONTENTshopify app dev
    END_RAW_MD_CONTENT</script>

    </div>
    </p>


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

    <p>
    <div class="react-code-block" data-preset="terminal">
    <div class="react-code-block-preload ThemeMode-dim">
    <div class="react-code-block-preload-bar "></div>
    <div class="react-code-block-preload-placeholder-container">
    <div class="react-code-block-preload-code-container">
    <div class="react-code-block-preload-codeline-number"></div>
    <div class="react-code-block-preload-codeline"></div>
    </div>

    </div>
    </div>


    <script type="text/plain" data-language="bash">
    RAW_MD_CONTENTshopify app deploy
    END_RAW_MD_CONTENT</script>

    </div>
    </p>


## Step 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](https://partners.shopify.com/current/apps), click **Extensions**.
1. 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.

## Next steps

- To learn more about the available flags for the `import-extensions` command, refer to the [Shopify CLI command reference](/docs/api/shopify-cli/app/app-import-extensions#flags).
- To learn more about the extension file structure, refer to our [app structure](/docs/apps/build/cli-for-apps/app-structure) documentation, and the documentation for your [extension type](/docs/apps/build/cli-for-apps/app-structure#extensions).