Version and publish your product subscription app extension
To create a stable and consistent experience for Partners and merchants, app extensions are versioned. Versioning allows control over when an extension is published, and provides a way to rollback changes if issues occur. Publishing an app extension version replaces the current live version served to shops that have your app installed.
What you'll learn
Anchor link to section titled "What you'll learn"In this tutorial, you'll learn how to do the following tasks:
- Deploy your extension
- Preview your draft
- Create and publish a version
Requirements
Anchor link to section titled "Requirements"Step 1: Deploy the extension
Anchor link to section titled "Step 1: Deploy the extension"After your extension is created, you can deploy your extension code to Shopify.
- Navigate to your app directory.
Run one of the following commands:
When you run the
deploy
command, the CLI builds your app, bundles your app extensions, and deploys the extensions to Shopify as a draft. It also walks you through multiple configuration steps. If you've already rundev
ordeploy
for this app, then some of these steps are skipped.To learn about the processes that are executed when you run
deploy
, refer to the Shopify CLI command reference.After you deploy the extension to Shopify, click on the link to navigate to your app in the Partner Dashboard, where you can create a version and then publish the extension. Learn more about extension versioning and publishing.
Step 2: Preview your draft
Anchor link to section titled "Step 2: Preview your draft"After deploying your extension code to Shopify, you can preview a draft of the extension on a development store before creating a version.
Step 3: Create a version
Anchor link to section titled "Step 3: Create a version"When you're ready to release your extension to merchants, you can create a version.
- Click Create version.
- In the modal, select either Minor or Major version depending on the nature of your code changes.
- Minor versions introduce changes that are backwards compatible.
- Major version changes aren't backwards compatible and might affect users who are currently using your extension.
Step 4: Publish a version
Anchor link to section titled "Step 4: Publish a version"When you're ready to release your extension to merchants, you can publish it. Publishing an extension version replaces the current Live version served to shops that have your app installed.
- Open the extension versioning page in your Partner Dashboard.
- Click Publish beside the version that you want to publish.
The new version is now served to all shops with your app installed.