Uninstall previous versions of Shopify CLI
To avoid confusion when using Shopify CLI 3.x, you can uninstall your previous version of Shopify CLI.
Uninstall Shopify CLI 2.xAnchor link to section titled "Uninstall Shopify CLI 2.x"
Shopify CLI can be removed from your system using the same package manager that you used to install it.
Homebrew (macOS)Anchor link to section titled "Homebrew (macOS)"
apt (Debian, Ubuntu)Anchor link to section titled "apt (Debian, Ubuntu)"
yum (CentOS 8+, Fedora, Red Hat, SUSE)Anchor link to section titled "yum (CentOS 8+, Fedora, Red Hat, SUSE)"
RubyGems (macOS, Linux, Windows 10)Anchor link to section titled "RubyGems (macOS, Linux, Windows 10)"
Uninstall a legacy versionAnchor link to section titled "Uninstall a legacy version"
Check if you are using the legacy versionAnchor link to section titled "Check if you are using the legacy version"
You can determine if you’re using a legacy version by running the following command. If you get a
command not found error, then you’re using a legacy version.
Uninstall the legacy Shopify App CLIAnchor link to section titled "Uninstall the legacy Shopify App CLI"
To uninstall a legacy version of Shopify CLI, complete the following steps:
- Delete the legacy CLI files.
- Remove the legacy
shopifycommand from your shell profile.
- Reload your terminal.
Delete the legacy CLI filesAnchor link to section titled "Delete the legacy CLI files"
By default, Shopify CLI was installed in your home directory. All the files are contained in a hidden directory called
.shopify-app-cli. Run the following command to delete the directory:
Remove the legacy Anchor link to section titled "Remove the legacy shopify command from your shell profile"
shopify command from your shell profile
During the install process, Shopify CLI added a line to your shell configuration. This line could be located in one of the following files in your home directory:
The line will look similar to one of the following examples. The exact syntax depends on your system. Deleting or commenting out the relevant line in your shell profile removes
shopify as a command.
Reload your terminalAnchor link to section titled "Reload your terminal"
For the changes made to your shell profile to take effect, exit your terminal, and start a new one.
- If you try running
shopify, then you should get a
command not founderror.
- If you have the
shopify_apigem installed, then you might see the following response:
If so, then you also need to upgrade the
shopify_api gem to v9.2.0 or higher to remove a deprecated
shopify command that is contained in that gem.
If you also have the
shopify_app gem (which depends on
shopify_api gem), then you need to install or update
shopify_api first, and then uninstall the older version.
To get a list of the versions of
shopify_api currently installed, run the following command:
To install the latest version, run the following command:
To uninstall the older version, run the following command. Replace
x.y.z with a version number listed from the
gem list command. Repeat as needed.