Migrate to Shopify CLI

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.

Step 1: Import your Subscription Link extension

Anchor link to section titled "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.

Navigate to your app directory.
To start importing your Subscription Link extension, run the following command:
Select Subscription Link Extensions.
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.

Step 2: Migrate your extension

Anchor link to section titled "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.

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

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

Anchor link to section titled "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.

In your Partner Dashboard, click Extensions.
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

Anchor link to section titled "Next steps"

To learn more about the available flags for the import-extensions command, refer to the Shopify CLI command reference.
To learn more about the extension file structure, refer to our app structure documentation, and the documentation for your extension type.