Guía de Shopify CLI
Qué es Shopify CLI, cómo instalarlo en tu computadora y los comandos de temas que vas a usar todos los días. Incluye un generador para armar el comando exacto sin memorizar opciones.
Actualizado el 25 de octubre de 2026 · Por aDigital Herramientas
Tu comando
——
Respuesta rápida
¿Qué es Shopify CLI y para qué sirve?
Shopify CLI es la herramienta oficial de línea de comandos de Shopify para desarrollar temas y apps. Con ella descargas un tema a tu computadora (theme pull), lo previsualizas con recarga en vivo (theme dev) y subes cambios (theme push). Requiere Node.js 22.12 o superior y Git.
Fuente: Shopify CLI para temas (shopify.dev).
Sigue con: Ejecuta tu tienda Shopify en local y Calculadora de comisiones Shopify México.
Qué es Shopify CLI
Shopify CLI es la herramienta oficial de línea de comandos de Shopify. Para temas te permite descargar el código de tu tienda, editarlo en tu editor favorito (VS Code, Cursor…), verlo en vivo en tu computadora y subir los cambios cuando estén listos. Es gratis y la mantiene Shopify en GitHub.
Requisitos
- Node.js 22.12 o superior. Revisa tu versión con
node -v. - Git 2.28.0 o superior (
git --version). - Un gestor de paquetes: npm (viene con Node), Yarn 1.x o pnpm.
- Una cuenta con acceso a la tienda: propietario, colaborador o personal con permiso de Temas.
Instalación
Instala Node.js LTS desde nodejs.org (o con brew install node). Git ya viene con las herramientas de desarrollo de Xcode (xcode-select --install). Luego instala Shopify CLI con npm:
npm install -g @shopify/cli@latestO con Homebrew:
brew tap shopify/shopify
brew install shopify-cliInstala Node.js LTS con el instalador de nodejs.org y Git desde git-scm.com. Abre una ventana nueva de PowerShell o Terminal y ejecuta:
npm install -g @shopify/cli@latestSi PowerShell dice que la ejecución de scripts está deshabilitada, permite scripts firmados para tu usuario y vuelve a abrir la terminal:
Set-ExecutionPolicy -Scope CurrentUser RemoteSignedUsa Node.js 22.12+ (las versiones de los repositorios de tu distribución suelen ser antiguas; nvm es la forma más fácil). Instala Git con tu gestor de paquetes y luego Shopify CLI:
nvm install --lts
sudo apt install git # Debian/Ubuntu
npm install -g @shopify/cli@latestCon nvm no necesitas sudo para instalar paquetes globales.
Comprueba la instalación:
shopify version
shopify helpComandos esenciales de temas
La primera vez que ejecutes un comando que necesita tu tienda, agrega --store mitienda.myshopify.com. Shopify CLI abre el navegador para que inicies sesión y recuerda la tienda para los siguientes comandos. Consulta cuál está activa con shopify theme info.
shopify theme init
Crea un tema nuevo clonando el Skeleton theme oficial de Shopify (un punto de partida mínimo). Con --clone-url puedes clonar otro repositorio.
shopify theme init mi-temashopify theme dev
Sube tu carpeta a un tema de desarrollo oculto y sirve una vista previa en http://127.0.0.1:9292 con recarga en vivo de CSS y secciones. También te da un enlace al editor de temas y uno de vista previa para compartir. Guía completa en ejecuta tu tienda Shopify en local.
shopify theme dev --store mitienda.myshopify.comshopify theme pull
Descarga los archivos de un tema de la tienda a tu carpeta. Sin opciones te pregunta cuál.
shopify theme pull --theme 123456789shopify theme push
Sube tus archivos y sobrescribe el tema remoto. Si no indicas tema, te pide elegir uno. Por seguridad, empuja a un tema sin publicar.
shopify theme push --unpublishedshopify theme list
Lista los temas de la tienda con su ID, nombre y estado (live, unpublished, development). Útil para copiar el ID que usarás con --theme.
shopify theme listshopify theme publish
Publica un tema que ya está en tu biblioteca. Se convierte en el que ven tus clientes.
shopify theme publish --theme 123456789shopify theme share
Sube tu carpeta como un tema nuevo sin publicar y te da un enlace de vista previa para enviar a tu cliente o socio.
shopify theme shareshopify theme check
Analiza el código Liquid, JSON y recursos en busca de errores y malas prácticas (imágenes sin tamaño, traducciones faltantes, código obsoleto).
shopify theme checkshopify theme package
Empaqueta tu tema en un archivo ZIP listo para subir manualmente desde el administrador.
shopify theme packageOpciones (flags) más útiles
| Flag | Para qué sirve |
|---|---|
--store / -s | Tienda con la que trabajas: prefijo o URL completa .myshopify.com. |
--theme / -t | Tema de destino por ID o nombre. |
--only / -o | Solo sube o descarga los archivos que coincidan. Se puede repetir; pon los comodines entre comillas. |
--ignore / -x | Excluye archivos. Ideal para no pisar config/settings_data.json. |
--live / -l | Apunta al tema publicado (en pull y push). |
--allow-live / -a | Confirma que sí quieres modificar el tema publicado; obligatorio sin modo interactivo. |
--development / -d | Usa tu tema de desarrollo. |
--unpublished / -u | En push, crea un tema nuevo sin publicar. |
--nodelete / -n | No elimina archivos del otro lado que no existan en el tuyo. |
--password | Token de la app Theme Access, para trabajar sin iniciar sesión con tu cuenta. |
Errores comunes
- "command not found: shopify": la carpeta global de npm no está en tu PATH, o abriste la terminal antes de instalar. Cierra y abre la terminal; en Windows reinicia la sesión.
- Error de versión de Node: actualiza a Node 22.12 o superior y reinstala el CLI.
- EACCES al instalar en macOS/Linux: no uses
sudo npm; instala Node con nvm o Homebrew para que los paquetes globales queden en tu usuario. - "You are not authorized" o error 401: tu cuenta no tiene permiso de Temas en esa tienda, o iniciaste sesión con otra cuenta. Ejecuta
shopify auth logouty vuelve a entrar. - "Invalid theme directory": estás en la carpeta equivocada. Debes estar donde existen
layout/,sections/,templates/, etc. - Se borraron personalizaciones del editor: un push sobrescribió
settings_data.jsono los JSON de plantillas. Usa--ignoreo haz pull antes de subir.
Preguntas frecuentes
¿Qué versión de Node.js necesita Shopify CLI?
Según la documentación de Shopify revisada en octubre de 2026, Shopify CLI requiere Node.js 22.12 o superior y Git 2.28.0 o superior.
¿Shopify CLI es gratis?
Sí. Es una herramienta oficial y gratuita de Shopify. Solo necesitas una cuenta con acceso a la tienda: propietario, colaborador o personal con permiso de Temas.
¿Puedo romper mi tienda con Shopify CLI?
Solo si subes cambios al tema publicado. Por defecto theme dev trabaja sobre un tema de desarrollo oculto, y push al tema en vivo requiere la opción --live o --allow-live. Trabaja siempre sobre una copia.
¿Qué diferencia hay entre theme push y theme share?
push sube tus archivos a un tema existente (lo sobrescribe). share crea un tema nuevo sin publicar con tus archivos y te da un enlace de vista previa para compartir.
Comandos y requisitos verificados contra la documentación de Shopify (shopify.dev) en octubre de 2026. Shopify actualiza el CLI con frecuencia: ante cualquier duda ejecuta shopify theme <comando> --help.