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.x
Anchor 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 version
Anchor link to section titled "Uninstall a legacy version"Check if you are using the legacy version
Anchor 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 CLI
Anchor 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
shopify
command from your shell profile. - Reload your terminal.
Delete the legacy CLI files
Anchor 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 shopify
command from your shell profile
Anchor link to section titled "Remove the legacy 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:
~/.bash_profile
~/.zshrc
~/.bash_login
~/.profile
~/.config/fish/config.fish
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 terminal
Anchor 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 acommand not found
error. - If you have the
shopify_api
gem 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.