--- title: Migrate to Shopify CLI description: >- Learn how to migrate product configuration link extensions created in the Partner Dashboard. source_url: html: >- https://shopify.dev/docs/apps/build/product-merchandising/bundles/product-configuration-extension/migrate-to-shopify-cli md: >- https://shopify.dev/docs/apps/build/product-merchandising/bundles/product-configuration-extension/migrate-to-shopify-cli.md --- ExpandOn this page * [What you'll learn](https://shopify.dev/docs/apps/build/product-merchandising/bundles/product-configuration-extension/migrate-to-shopify-cli.md#what-youll-learn) * [Requirements](https://shopify.dev/docs/apps/build/product-merchandising/bundles/product-configuration-extension/migrate-to-shopify-cli.md#requirements) * [Step 1: Update the shopify.​extension.​toml configuration file](https://shopify.dev/docs/apps/build/product-merchandising/bundles/product-configuration-extension/migrate-to-shopify-cli.md#step-1-update-the-shopifyextensiontoml-configuration-file) * [Step 2: Deploy the extension](https://shopify.dev/docs/apps/build/product-merchandising/bundles/product-configuration-extension/migrate-to-shopify-cli.md#step-2-deploy-the-extension) * [Step 3: Preview the extension](https://shopify.dev/docs/apps/build/product-merchandising/bundles/product-configuration-extension/migrate-to-shopify-cli.md#step-3-preview-the-extension) # Migrate to Shopify CLI Tip To add a product configuration link to your product configuration UI extension, you must be using Shopify CLI version 3.76 or above. Learn how to [create product configuration extensions with Shopify CLI](https://shopify.dev/docs/apps/build/product-merchandising/bundles/product-configuration-extension/add-merchant-config-ui). If you have a product configuration link extension that was created through the Partner Dashboard, you must move this link to a product configuration UI extension to continue managing it. Moving forward, the product configuration link will be set in the `shopify.extension.toml` file of the product configuration UI extension. This file allows developers to define how the product configuration card behaves, including its destination URL and the rendering of a custom UI. The URL template is set using `[extensions.targeting.urls]`. ## extensions/product-configuration/shopify.extension.toml ```toml [[extensions.targeting]] module = "./src/ProductDetailsConfigurationExtension.jsx" target = "admin.product-details.configuration.render" [extensions.targeting.urls] edit = "/bundles/products/{product_id}" ``` *** ## What you'll learn In this tutorial, you'll learn how to do the following tasks: * Update the `shopify.extension.toml` configuration file with your URL template pattern. * Deploy your extension code to Shopify. * Preview the rendered extension on the product details page in the Shopify admin. *** ## Requirements * You're a [user with app development permissions](https://shopify.dev/docs/apps/build/dev-dashboard/user-permissions) and have created a [dev store](https://shopify.dev/docs/apps/build/dev-dashboard/development-stores). - You're using the latest version of [Shopify CLI](https://shopify.dev/docs/api/shopify-cli). - You're using the latest version of [Chrome](https://www.google.com/chrome/) or [Firefox](https://www.mozilla.org/). * Your dev store uses [generated test data](https://shopify.dev/docs/apps/build/dev-dashboard/development-stores/generated-test-data). * You've [created an app that uses Shopify CLI 3.76 or higher](https://shopify.dev/docs/apps/build/scaffold-app). If you previously installed Shopify CLI, then make sure you're using the [latest version](https://shopify.dev/docs/api/shopify-cli#upgrade). * You've installed [Node.js](https://nodejs.org/en/download) 16 or higher. * You've created a [customized bundle](https://shopify.dev/docs/apps/build/product-merchandising/bundles/add-customized-bundle-function) on your shop. * You've created a [product configuration extension](https://shopify.dev/docs/apps/build/product-merchandising/bundles/product-configuration-extension/add-merchant-config-ui). *** ## Step 1: Update the `shopify.extension.toml` configuration file 1. In your app's codebase, navigate to your extension directory. 2. Open the `shopify.extension.toml` configuration file. 3. Update the `[extensions.targeting.urls]` configuration with a URL that matches your app’s structure. The field accepts a URL template pattern which expands template variables according to RFC 6570. Available variables: `{product_id}`. ```toml [[extensions.targeting]] module = "./src/ProductDetailsConfigurationExtension.jsx" target = "admin.product-details.configuration.render" [extensions.targeting.urls] edit = "/bundles/products/{product_id}" ``` *** ## Step 2: Deploy the extension When you're ready to release your changes to users, you can create and release an [app version](https://shopify.dev/docs/apps/launch/deployment/app-versions). An app version is a snapshot of your app configuration and all extensions. 1. Navigate to your app directory. 2. Run the following command. Optionally, you can provide a name or message for the version using the `--version` and `--message` flags. ## Terminal ```terminal shopify app deploy ``` Releasing an app version replaces the current active version that's served to stores that have your app installed. It might take several minutes for app users to be upgraded to the new version. Tip If you want to create a version, but avoid releasing it to users, then run the `deploy` command with a `--no-release` flag. You can release the unreleased app version using Shopify CLI's [`release`](https://shopify.dev/docs/api/shopify-cli/app/app-release) command, or through the Dev Dashboard. *** ## Step 3: Preview the extension Navigate to your customized bundle product page in the Shopify admin. Your extension will be rendered within bundled products card. Verify the product configuration link appears correctly in the top right corner of the card. ![A product configuration extension rendered within the Shopify admin.](https://shopify.dev/assets/assets/images/apps/bundles/product-configuration-extension-CHZt05RT.png) *** * [What you'll learn](https://shopify.dev/docs/apps/build/product-merchandising/bundles/product-configuration-extension/migrate-to-shopify-cli.md#what-youll-learn) * [Requirements](https://shopify.dev/docs/apps/build/product-merchandising/bundles/product-configuration-extension/migrate-to-shopify-cli.md#requirements) * [Step 1: Update the shopify.​extension.​toml configuration file](https://shopify.dev/docs/apps/build/product-merchandising/bundles/product-configuration-extension/migrate-to-shopify-cli.md#step-1-update-the-shopifyextensiontoml-configuration-file) * [Step 2: Deploy the extension](https://shopify.dev/docs/apps/build/product-merchandising/bundles/product-configuration-extension/migrate-to-shopify-cli.md#step-2-deploy-the-extension) * [Step 3: Preview the extension](https://shopify.dev/docs/apps/build/product-merchandising/bundles/product-configuration-extension/migrate-to-shopify-cli.md#step-3-preview-the-extension)