theme devcommand
Uploads the current theme as the specified theme, or a development theme, to a store so you can preview it.
This command returns the following information:
A link to your development theme at http://127.0.0.1:9292. This URL can hot reload local changes to CSS and sections, or refresh the entire page when a file changes, enabling you to preview changes in real time using the store's data.
You can specify a different network interface and port using
--host
and--port
.A link to the editor for the theme in the Shopify admin.
A preview link that you can share with other developers.
If you already have a development theme for your current environment, then this command replaces the development theme with your local theme. You can override this using the --theme-editor-sync
flag.
You can't preview checkout customizations using http://127.0.0.1:9292.
Development themes are deleted when you run shopify auth logout
. If you need a preview link that can be used after you log out, then you should share your theme or push to an unpublished theme on your store.
You can run this command only in a directory that matches the default Shopify theme folder structure.
Anchor to flagsFlags
The following flags are available for the theme dev
command:
Controls the visibility of the error overlay when an theme asset upload fails: - silent Prevents the error overlay from appearing. - default Displays the error overlay.
Set which network interface the web server listens on. The default value is 127.0.0.1.
The live reload mode switches the server behavior when a file is modified: - hot-reload Hot reloads local changes to CSS and sections (default) - full-page Always refreshes the entire page - off Deactivate live reload
Disable color output.
The file path or URL. The file path is to a file that you want updated on idle. The URL path is where you want a webhook posted to report on file changes.
Automatically launch the theme preview in your default web browser.
Password generated from the Theme Access app.
The path where you want to run the command. Defaults to the current working directory.
Local port to serve theme preview from.
The password for storefronts with password protection.
Synchronize Theme Editor updates in the local theme files.
Increase the verbosity of the output.
The environment to apply to the current command.
Prevents files from being deleted in the remote theme when a file has been deleted locally. This applies to files that are deleted while the command is running, and files that have been deleted locally before the command is run.
Hot reload only files that match the specified pattern.
Store URL. It can be the store prefix (example) or the full myshopify.com URL (example.myshopify.com, https://example.myshopify.com).
Theme ID or name of the remote theme.
Skip hot reloading any files that match the specified pattern.