{"id":16274,"date":"2026-02-19T12:11:57","date_gmt":"2026-02-19T12:11:57","guid":{"rendered":"https:\/\/ecommerce.folio3.com\/blog\/?p=16274"},"modified":"2026-02-21T21:45:55","modified_gmt":"2026-02-21T21:45:55","slug":"how-to-install-shopify-theme-kit","status":"publish","type":"post","link":"https:\/\/ecommerce.folio3.com\/blog\/how-to-install-shopify-theme-kit\/","title":{"rendered":"Shopify Theme Kit: A Complete Guide to Setup and Customization"},"content":{"rendered":"<p><span style=\"font-weight: 400;\">Editing Shopify themes in a browser window \u2014 without version control, proper tooling, or a local environment, is slow and hard to scale. Mistakes go live instantly, and collaboration becomes a bottleneck.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Shopify Theme Kit solves this. It&#8217;s a command-line tool that lets you develop themes locally, sync changes automatically, and manage multiple environments with a single config file. This guide covers installation, authentication, key commands, schema customization, and when to use Theme Kit versus Shopify CLI.<\/span><\/p>\n<h2><span style=\"font-weight: 400;\">Summary<\/span><\/h2>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>What Theme Kit does:<\/b><span style=\"font-weight: 400;\"> Enables local Shopify theme development with automatic file syncing<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>Installation:<\/b><span style=\"font-weight: 400;\"> Platform-specific steps for macOS, Windows, and Linux<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>Authentication:<\/b><span style=\"font-weight: 400;\"> Requires a Theme Access password from your Shopify admin<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>Key commands:<\/b> <span style=\"font-weight: 400;\">theme get<\/span><span style=\"font-weight: 400;\">, <\/span><span style=\"font-weight: 400;\">theme watch<\/span><span style=\"font-weight: 400;\">, <\/span><span style=\"font-weight: 400;\">theme deploy<\/span><span style=\"font-weight: 400;\">, and <\/span><span style=\"font-weight: 400;\">theme new<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>Schema customization:<\/b><span style=\"font-weight: 400;\"> Build client-editable settings into sections without exposing code<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>Theme Kit vs Shopify CLI:<\/b><span style=\"font-weight: 400;\"> Different tools for different project types \u2014 both have a place<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>Best practices:<\/b><span style=\"font-weight: 400;\"> Git, <\/span><span style=\"font-weight: 400;\">.gitignore<\/span><span style=\"font-weight: 400;\">, and multi-environment configs keep workflows team-ready<\/span><\/li>\n<\/ul>\n<h2><span style=\"font-weight: 400;\">What Is Shopify Theme Kit?<\/span><\/h2>\n<p><span style=\"font-weight: 400;\">Shopify Theme Kit is an open-source CLI tool that connects your local file system to a <a href=\"https:\/\/ecommerce.folio3.com\/blog\/best-shopify-themes\/\">Shopify theme<\/a> via API. When you save a file locally, Theme Kit detects the change and syncs it to your store in real time. It works on Windows, macOS, and Linux, and integrates cleanly with Git, VS Code, and build tools like <a href=\"https:\/\/webpack.js.org\/\" target=\"_blank\" rel=\"noopener\">Webpack<\/a> or <a href=\"https:\/\/gulpjs.com\/\" target=\"_blank\" rel=\"noopener\">Gulp<\/a>.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">It&#8217;s particularly useful for teams managing multiple themes, handling frequent updates, or working on complex<\/span><a href=\"https:\/\/ecommerce.folio3.com\/shopify-development\/\"> <span style=\"font-weight: 400;\">Shopify custom development<\/span><\/a><span style=\"font-weight: 400;\"> projects that require a structured workflow.<\/span><\/p>\n<table>\n<tbody>\n<tr>\n<td><b>Feature<\/b><\/td>\n<td><b>Description<\/b><\/td>\n<td><b>Use Case<\/b><\/td>\n<\/tr>\n<tr>\n<td><span style=\"font-weight: 400;\">Local Development<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Edit theme files in any code editor<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Work offline, use familiar tools<\/span><\/td>\n<\/tr>\n<tr>\n<td><span style=\"font-weight: 400;\">Automatic Sync<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Watch command uploads on save<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Real-time updates without manual uploads<\/span><\/td>\n<\/tr>\n<tr>\n<td><span style=\"font-weight: 400;\">Multi-Environment Support<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Configure dev, staging, and production in one file<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Deploy to specific themes with one command<\/span><\/td>\n<\/tr>\n<tr>\n<td><span style=\"font-weight: 400;\">Version Control Integration<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Works alongside Git<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Coordinate changes across teams<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2><span style=\"font-weight: 400;\">Shopify Theme Kit vs. Shopify CLI<\/span><\/h2>\n<p><span style=\"font-weight: 400;\">Shopify CLI is now the recommended tool for new theme development, especially for Online Store 2.0 themes. Theme Kit remains the right choice for maintaining existing themes and managing multi-environment deployments.<\/span><\/p>\n<table>\n<tbody>\n<tr>\n<td><b>Criteria<\/b><\/td>\n<td><b>Shopify Theme Kit<\/b><\/td>\n<td><b>Shopify CLI<\/b><\/td>\n<\/tr>\n<tr>\n<td><span style=\"font-weight: 400;\">Best for<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Legacy themes, maintenance workflows<\/span><\/td>\n<td><span style=\"font-weight: 400;\">New OS 2.0 theme builds<\/span><\/td>\n<\/tr>\n<tr>\n<td><span style=\"font-weight: 400;\">Local dev server<\/span><\/td>\n<td><span style=\"font-weight: 400;\">No \u2014 manual browser reload<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Yes \u2014 hot reload included<\/span><\/td>\n<\/tr>\n<tr>\n<td><span style=\"font-weight: 400;\">Multi-environment config<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Yes \u2014 native config.yml support<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Limited<\/span><\/td>\n<\/tr>\n<tr>\n<td><span style=\"font-weight: 400;\">Setup complexity<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Low<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Moderate<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p><span style=\"font-weight: 400;\">Many developers use both tools depending on the project. Use Shopify CLI for greenfield builds. Use theme kit Shopify for maintaining or updating existing themes.<\/span><\/p>\n<h2><span style=\"font-weight: 400;\">How to Install Shopify Theme Kit<\/span><\/h2>\n<h3><span style=\"font-weight: 400;\">macOS<\/span><\/h3>\n<p><span style=\"font-weight: 400;\">Install via Homebrew:<\/span><\/p>\n<pre><span style=\"font-weight: 400;\">bash<\/span>\r\n\r\n<span style=\"font-weight: 400;\">brew tap shopify\/shopify<\/span>\r\n\r\n<span style=\"font-weight: 400;\">brew <\/span><span style=\"font-weight: 400;\">install<\/span><span style=\"font-weight: 400;\"> themekit<\/span><\/pre>\n<p><span style=\"font-weight: 400;\">Verify with <\/span><span style=\"font-weight: 400;\">theme version<\/span><span style=\"font-weight: 400;\">. On M1\/M2 chips, try running Terminal with Rosetta if you see compatibility errors.<\/span><\/p>\n<h3><span style=\"font-weight: 400;\">Windows<\/span><\/h3>\n<p><span style=\"font-weight: 400;\">Open PowerShell as an administrator, install Chocolatey if needed, then run:<\/span><\/p>\n<pre><span style=\"font-weight: 400;\">powershell<\/span>\r\n\r\n<span style=\"font-weight: 400;\">choco install themekit<\/span><\/pre>\n<p><span style=\"font-weight: 400;\">Verify with <\/span><span style=\"font-weight: 400;\">theme version<\/span><span style=\"font-weight: 400;\">. Wrap URLs containing dashes in quotation marks to avoid PowerShell parsing issues.<\/span><\/p>\n<h3><span style=\"font-weight: 400;\">Linux<\/span><\/h3>\n<pre><span style=\"font-weight: 400;\">bash<\/span>\r\n\r\n<span style=\"font-weight: 400;\">curl<\/span><span style=\"font-weight: 400;\"> -s https:\/\/shopify.github.io\/themekit\/scripts\/install.py | <\/span><span style=\"font-weight: 400;\">sudo<\/span><span style=\"font-weight: 400;\"> python<\/span><\/pre>\n<p><span style=\"font-weight: 400;\">Verify with <\/span><span style=\"font-weight: 400;\">theme version<\/span><span style=\"font-weight: 400;\">. If the version output appears, you&#8217;re ready to proceed.<\/span><\/p>\n<h2><span style=\"font-weight: 400;\">Generating a Theme Access Password<\/span><\/h2>\n<p><span style=\"font-weight: 400;\">Theme Kit authenticates via the <\/span><b>Theme Access<\/b><span style=\"font-weight: 400;\"> app \u2014 a Shopify-native app that generates scoped API passwords.<\/span><\/p>\n<table>\n<tbody>\n<tr>\n<td><b>Step<\/b><\/td>\n<td><b>Action<\/b><\/td>\n<td><b>Notes<\/b><\/td>\n<\/tr>\n<tr>\n<td><span style=\"font-weight: 400;\">1<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Install Theme Access app<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Done by store owner in Shopify Admin \u2192 Apps<\/span><\/td>\n<\/tr>\n<tr>\n<td><span style=\"font-weight: 400;\">2<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Create a new password<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Enter the developer&#8217;s email<\/span><\/td>\n<\/tr>\n<tr>\n<td><span style=\"font-weight: 400;\">3<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Check email for invite<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Expires after 7 days if unused<\/span><\/td>\n<\/tr>\n<tr>\n<td><span style=\"font-weight: 400;\">4<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Copy the password<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Visible only once \u2014 store it securely<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p><span style=\"font-weight: 400;\">Set permissions to &#8220;Read and write&#8221; for themes. Copy the password immediately \u2014 you cannot retrieve it after leaving that screen. Never commit it to a Git repository.<\/span><\/p>\n<h2><span style=\"font-weight: 400;\">Setting Up config.yml<\/span><\/h2>\n<p><span style=\"font-weight: 400;\">The <\/span><span style=\"font-weight: 400;\">config.yml<\/span><span style=\"font-weight: 400;\"> file connects your local environment to a specific Shopify theme. It sits at the root of your theme directory.<\/span><\/p>\n<h3><span style=\"font-weight: 400;\">Connect to an Existing Theme<\/span><\/h3>\n<p><span style=\"font-weight: 400;\">List all themes and their IDs:<\/span><\/p>\n<pre><span style=\"font-weight: 400;\">bash<\/span>\r\n\r\n<span style=\"font-weight: 400;\">theme get --list --password=<\/span><span style=\"font-weight: 400;\">[<\/span><span style=\"font-weight: 400;\">your-password<\/span><span style=\"font-weight: 400;\">]<\/span><span style=\"font-weight: 400;\"> --store=<\/span><span style=\"font-weight: 400;\">[<\/span><span style=\"font-weight: 400;\">your-store.myshopify.com<\/span><span style=\"font-weight: 400;\">]<\/span>\r\n\r\n<span style=\"font-weight: 400;\">Then download the theme and auto-generate <\/span><span style=\"font-weight: 400;\">config.yml<\/span><span style=\"font-weight: 400;\">:<\/span>\r\n\r\n<span style=\"font-weight: 400;\">bash<\/span>\r\n\r\n<span style=\"font-weight: 400;\">theme get --password=<\/span><span style=\"font-weight: 400;\">[<\/span><span style=\"font-weight: 400;\">your-password<\/span><span style=\"font-weight: 400;\">]<\/span><span style=\"font-weight: 400;\"> --store=<\/span><span style=\"font-weight: 400;\">[<\/span><span style=\"font-weight: 400;\">your-store.myshopify.com<\/span><span style=\"font-weight: 400;\">]<\/span><span style=\"font-weight: 400;\"> --themeid=<\/span><span style=\"font-weight: 400;\">[<\/span><span style=\"font-weight: 400;\">your-theme-id<\/span><span style=\"font-weight: 400;\">]<\/span><\/pre>\n<h3><span style=\"font-weight: 400;\">Multi-Environment Setup<\/span><\/h3>\n<p><span style=\"font-weight: 400;\">One of the strongest features of Shopify themekit is native multi-environment support:<\/span><\/p>\n<pre><span style=\"font-weight: 400;\">yaml<\/span>\r\n\r\n<span style=\"font-weight: 400;\">development<\/span><span style=\"font-weight: 400;\">:<\/span>\r\n\r\n<span style=\"font-weight: 400;\">\u00a0\u00a0<\/span><span style=\"font-weight: 400;\">password<\/span><span style=\"font-weight: 400;\">:<\/span><span style=\"font-weight: 400;\"> dev_password<\/span>\r\n\r\n<span style=\"font-weight: 400;\">\u00a0\u00a0<\/span><span style=\"font-weight: 400;\">theme_id<\/span><span style=\"font-weight: 400;\">:<\/span> <span style=\"font-weight: 400;\">\"123456789\"<\/span>\r\n\r\n<span style=\"font-weight: 400;\">\u00a0\u00a0<\/span><span style=\"font-weight: 400;\">store<\/span><span style=\"font-weight: 400;\">:<\/span><span style=\"font-weight: 400;\"> your<\/span><span style=\"font-weight: 400;\">-<\/span><span style=\"font-weight: 400;\">store.myshopify.com<\/span>\r\n\r\n<span style=\"font-weight: 400;\">staging<\/span><span style=\"font-weight: 400;\">:<\/span>\r\n\r\n<span style=\"font-weight: 400;\">\u00a0\u00a0<\/span><span style=\"font-weight: 400;\">password<\/span><span style=\"font-weight: 400;\">:<\/span><span style=\"font-weight: 400;\"> staging_password<\/span>\r\n\r\n<span style=\"font-weight: 400;\">\u00a0\u00a0<\/span><span style=\"font-weight: 400;\">theme_id<\/span><span style=\"font-weight: 400;\">:<\/span> <span style=\"font-weight: 400;\">\"987654321\"<\/span>\r\n\r\n<span style=\"font-weight: 400;\">\u00a0\u00a0<\/span><span style=\"font-weight: 400;\">store<\/span><span style=\"font-weight: 400;\">:<\/span><span style=\"font-weight: 400;\"> your<\/span><span style=\"font-weight: 400;\">-<\/span><span style=\"font-weight: 400;\">store.myshopify.com<\/span><\/pre>\n<p><span style=\"font-weight: 400;\">Deploy to a specific environment with <\/span><span style=\"font-weight: 400;\">theme deploy &#8211;env=staging<\/span><span style=\"font-weight: 400;\">. This makes it easy to test changes before pushing to production \u2014 a standard practice in any serious<\/span> <span style=\"font-weight: 400;\">Shopify development process<\/span><span style=\"font-weight: 400;\">.<\/span><\/p>\n<h2><span style=\"font-weight: 400;\">Core Theme Kit Commands<\/span><\/h2>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>theme watch<\/b><span style=\"font-weight: 400;\"> \u2014 Monitors all files and uploads changes on save. Stops syncing if a Liquid file has a syntax error, acting as a lightweight quality check. Stop with <\/span><span style=\"font-weight: 400;\">Ctrl + C<\/span><span style=\"font-weight: 400;\">.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>theme deploy<\/b><span style=\"font-weight: 400;\"> \u2014 Pushes all local files to Shopify in a single batch. Use this when deploying a complete, reviewed set of changes.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>theme download<\/b><span style=\"font-weight: 400;\"> \u2014 Pulls the latest theme from Shopify to your local machine. Run this when another developer has made changes directly in the Shopify admin.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><b>theme new<\/b><span style=\"font-weight: 400;\"> \u2014 Creates a blank theme on your store and sets up the local directory structure: assets, config, layout, locales, sections, snippets, and templates.<\/span><\/li>\n<\/ul>\n<h2><span style=\"font-weight: 400;\">Schema Customization with Theme Kit<\/span><\/h2>\n<p><span style=\"font-weight: 400;\">One of the most practical \u2014 and often overlooked \u2014 features when working with Shopify themekit is schema-driven settings. Schemas are JSON blocks inside section Liquid files that define client-editable options visible in the Shopify theme editor.<\/span><\/p>\n<pre><span style=\"font-weight: 400;\">json<\/span>\r\n\r\n<span style=\"font-weight: 400;\">{<\/span><span style=\"font-weight: 400;\">% schema %<\/span><span style=\"font-weight: 400;\">}<\/span>\r\n\r\n<span style=\"font-weight: 400;\">{<\/span>\r\n\r\n<span style=\"font-weight: 400;\">\u00a0\u00a0<\/span><span style=\"font-weight: 400;\">\"name\"<\/span><span style=\"font-weight: 400;\">: <\/span><span style=\"font-weight: 400;\">\"Hero Banner\"<\/span><span style=\"font-weight: 400;\">,<\/span>\r\n\r\n<span style=\"font-weight: 400;\">\u00a0\u00a0<\/span><span style=\"font-weight: 400;\">\"settings\"<\/span><span style=\"font-weight: 400;\">: <\/span><span style=\"font-weight: 400;\">[<\/span>\r\n\r\n<span style=\"font-weight: 400;\">\u00a0\u00a0\u00a0\u00a0<\/span><span style=\"font-weight: 400;\">{<\/span> <span style=\"font-weight: 400;\">\"type\"<\/span><span style=\"font-weight: 400;\">: <\/span><span style=\"font-weight: 400;\">\"text\"<\/span><span style=\"font-weight: 400;\">,<\/span> <span style=\"font-weight: 400;\">\"id\"<\/span><span style=\"font-weight: 400;\">: <\/span><span style=\"font-weight: 400;\">\"heading\"<\/span><span style=\"font-weight: 400;\">,<\/span> <span style=\"font-weight: 400;\">\"label\"<\/span><span style=\"font-weight: 400;\">: <\/span><span style=\"font-weight: 400;\">\"Banner Heading\"<\/span><span style=\"font-weight: 400;\">,<\/span> <span style=\"font-weight: 400;\">\"default\"<\/span><span style=\"font-weight: 400;\">: <\/span><span style=\"font-weight: 400;\">\"Welcome\"<\/span> <span style=\"font-weight: 400;\">},<\/span>\r\n\r\n<span style=\"font-weight: 400;\">\u00a0\u00a0\u00a0\u00a0<\/span><span style=\"font-weight: 400;\">{<\/span> <span style=\"font-weight: 400;\">\"type\"<\/span><span style=\"font-weight: 400;\">: <\/span><span style=\"font-weight: 400;\">\"checkbox\"<\/span><span style=\"font-weight: 400;\">,<\/span> <span style=\"font-weight: 400;\">\"id\"<\/span><span style=\"font-weight: 400;\">: <\/span><span style=\"font-weight: 400;\">\"show_button\"<\/span><span style=\"font-weight: 400;\">,<\/span> <span style=\"font-weight: 400;\">\"label\"<\/span><span style=\"font-weight: 400;\">: <\/span><span style=\"font-weight: 400;\">\"Show CTA Button\"<\/span><span style=\"font-weight: 400;\">,<\/span> <span style=\"font-weight: 400;\">\"default\"<\/span><span style=\"font-weight: 400;\">: <\/span><span style=\"font-weight: 400;\">true<\/span> <span style=\"font-weight: 400;\">}<\/span>\r\n\r\n<span style=\"font-weight: 400;\">\u00a0\u00a0<\/span><span style=\"font-weight: 400;\">]<\/span>\r\n\r\n<span style=\"font-weight: 400;\">}<\/span>\r\n\r\n<span style=\"font-weight: 400;\">{<\/span><span style=\"font-weight: 400;\">% endschema %<\/span><span style=\"font-weight: 400;\">}<\/span>\r\n\r\n<span style=\"font-weight: 400;\">The Liquid file references those settings directly:<\/span>\r\n\r\n<span style=\"font-weight: 400;\">liquid<\/span>\r\n\r\n<span style=\"font-weight: 400;\">&lt;<\/span><span style=\"font-weight: 400;\">h1<\/span><span style=\"font-weight: 400;\">&gt;{{<\/span> <span style=\"font-weight: 400;\">section<\/span><span style=\"font-weight: 400;\">.<\/span><span style=\"font-weight: 400;\">settings<\/span><span style=\"font-weight: 400;\">.<\/span><span style=\"font-weight: 400;\">heading <\/span><span style=\"font-weight: 400;\">}}&lt;\/<\/span><span style=\"font-weight: 400;\">h1<\/span><span style=\"font-weight: 400;\">&gt;<\/span>\r\n\r\n<span style=\"font-weight: 400;\">{%<\/span> <span style=\"font-weight: 400;\">if<\/span> <span style=\"font-weight: 400;\">section<\/span><span style=\"font-weight: 400;\">.<\/span><span style=\"font-weight: 400;\">settings<\/span><span style=\"font-weight: 400;\">.<\/span><span style=\"font-weight: 400;\">show_button <\/span><span style=\"font-weight: 400;\">%}&lt;<\/span><span style=\"font-weight: 400;\">a <\/span><span style=\"font-weight: 400;\">href<\/span><span style=\"font-weight: 400;\">=\"<\/span><span style=\"font-weight: 400;\">\/collections\/all<\/span><span style=\"font-weight: 400;\">\"&gt;<\/span><span style=\"font-weight: 400;\">Shop Now<\/span><span style=\"font-weight: 400;\">&lt;\/<\/span><span style=\"font-weight: 400;\">a<\/span><span style=\"font-weight: 400;\">&gt;{%<\/span> <span style=\"font-weight: 400;\">endif<\/span> <span style=\"font-weight: 400;\">%}<\/span><\/pre>\n<p><span style=\"font-weight: 400;\">This allows non-developers to update content without touching code \u2014 a significant time saver for client projects. You can further extend functionality using<\/span><a href=\"https:\/\/ecommerce.folio3.com\/blog\/shopify-theme-app-extensions\/\"> <span style=\"font-weight: 400;\">Shopify theme app extensions<\/span><\/a><span style=\"font-weight: 400;\"> without modifying core theme files. Global theme settings live in <\/span><span style=\"font-weight: 400;\">\/config\/settings_schema.json<\/span><span style=\"font-weight: 400;\"> and control the &#8220;Theme settings&#8221; panel in the editor.<\/span><\/p>\n<h2><span style=\"font-weight: 400;\">Common Errors and Fixes<\/span><\/h2>\n<table>\n<tbody>\n<tr>\n<td><b>Error<\/b><\/td>\n<td><b>Likely Cause<\/b><\/td>\n<td><b>Fix<\/b><\/td>\n<\/tr>\n<tr>\n<td><span style=\"font-weight: 400;\">theme: command not found<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Theme Kit not in system PATH<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Reinstall via package manager; restart terminal<\/span><\/td>\n<\/tr>\n<tr>\n<td><span style=\"font-weight: 400;\">Authentication failed<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Wrong or expired password<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Regenerate a Theme Access password<\/span><\/td>\n<\/tr>\n<tr>\n<td><span style=\"font-weight: 400;\">File not syncing<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Liquid syntax error<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Check for unclosed tags or missing delimiters<\/span><\/td>\n<\/tr>\n<tr>\n<td><span style=\"font-weight: 400;\">CSS changes not appearing<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Browser cache<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Hard refresh (Ctrl+Shift+R)<\/span><\/td>\n<\/tr>\n<tr>\n<td><span style=\"font-weight: 400;\">config.yml not found<\/span><\/td>\n<td><span style=\"font-weight: 400;\">Wrong working directory<\/span><\/td>\n<td><span style=\"font-weight: 400;\">cd<\/span><span style=\"font-weight: 400;\"> into the theme folder first<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p><span style=\"font-weight: 400;\">For deeper customization challenges, consider working with a team that specializes in<\/span><a href=\"https:\/\/ecommerce.folio3.com\/shopify-development\/theme-customization\/\"> <span style=\"font-weight: 400;\">Shopify theme customization<\/span><\/a><span style=\"font-weight: 400;\">.<\/span><\/p>\n<h2><span style=\"font-weight: 400;\">Best Practices<\/span><\/h2>\n<p><b>Use Git from day one.<\/b><span style=\"font-weight: 400;\"> Initialize a repository immediately after downloading a theme. This makes rollbacks and code reviews straightforward.<\/span><\/p>\n<p><b>Add <\/b><b>config.yml<\/b><b> to <\/b><b>.gitignore<\/b><b>.<\/b><span style=\"font-weight: 400;\"> It contains your Theme Access password. Also exclude <\/span><span style=\"font-weight: 400;\">node_modules\/<\/span><span style=\"font-weight: 400;\"> and <\/span><span style=\"font-weight: 400;\">.DS_Store<\/span><span style=\"font-weight: 400;\">.<\/span><\/p>\n<p><b>Never edit the live theme.<\/b><span style=\"font-weight: 400;\"> Always work on a duplicate or development theme. If <\/span><span style=\"font-weight: 400;\">theme watch<\/span><span style=\"font-weight: 400;\"> syncs a broken file, a live store can break.<\/span><\/p>\n<p><b>Pair with a build tool.<\/b><span style=\"font-weight: 400;\"> Combine Theme Kit with Gulp or Webpack to compile SCSS, bundle JavaScript, and optimize images before syncing. For a deeper understanding of Liquid syntax that underpins all Shopify themes, see our<\/span> <span style=\"font-weight: 400;\">Shopify Liquid guide<\/span><span style=\"font-weight: 400;\">.<\/span><\/p>\n<h2><span style=\"font-weight: 400;\">Key Takeaways<\/span><\/h2>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Install Theme Kit using your platform&#8217;s package manager \u2014 Homebrew, Chocolatey, or the Linux curl script<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Authentication goes through the Theme Access app \u2014 the password is shown only once, so store it immediately<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">theme watch<\/span><span style=\"font-weight: 400;\"> is your primary command \u2014 auto-syncs on save and blocks syncing when Liquid errors are detected<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Multi-environment <\/span><span style=\"font-weight: 400;\">config.yml<\/span><span style=\"font-weight: 400;\"> lets you deploy to dev, staging, and production independently with one flag<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Schema settings let non-developers manage content updates without touching code<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Theme Kit is not deprecated \u2014 use it for legacy themes; use Shopify CLI for new OS 2.0 builds<\/span><\/li>\n<\/ul>\n<h2><span style=\"font-weight: 400;\">Conclusion<\/span><\/h2>\n<p><span style=\"font-weight: 400;\">Shopify Theme Kit gives developers a clean, scalable alternative to browser-based theme editing. From installation to schema customization and multi-environment deployment, the setup is straightforward once the moving parts are in place.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Whether you&#8217;re maintaining a legacy theme or coordinating a development team, Shopify Theme Kit keeps your workflow organized and version-controlled. For next steps, explore our guide to<\/span><a href=\"https:\/\/ecommerce.folio3.com\/blog\/how-to-build-a-custom-shopify-theme\/\"> <span style=\"font-weight: 400;\">building a custom Shopify theme<\/span><\/a><span style=\"font-weight: 400;\"> \u2014 or<\/span><a href=\"https:\/\/ecommerce.folio3.com\/contact-us\/\"> <span style=\"font-weight: 400;\">talk to our Shopify team<\/span><\/a><span style=\"font-weight: 400;\"> if you need expert help on a theme project.<\/span><\/p>\n<h2><span style=\"font-weight: 400;\">Frequently Asked Questions<\/span><\/h2>\n<h3><span style=\"font-weight: 400;\">What Is Shopify Theme Kit Used For?<\/span><\/h3>\n<p><span style=\"font-weight: 400;\">Shopify Theme Kit is a CLI tool for developing and editing themes locally. It syncs changes to your store automatically, works with Git and any code editor, and supports multi-environment deployments. It&#8217;s primarily used for legacy theme maintenance and structured team development workflows.<\/span><\/p>\n<h3><span style=\"font-weight: 400;\">Is Shopify Theme Kit Still Supported?<\/span><\/h3>\n<p><span style=\"font-weight: 400;\">Yes. Shopify maintains Theme Kit and it remains functional. Shopify CLI is recommended for new Online Store 2.0 builds. Theme Kit is still the better option for maintaining existing themes or managing multi-environment deployments.<\/span><\/p>\n<h3><span style=\"font-weight: 400;\">How Do I Find My Theme ID for Theme Kit Shopify?<\/span><\/h3>\n<p><span style=\"font-weight: 400;\">Run <\/span><span style=\"font-weight: 400;\">theme get &#8211;list &#8211;password=[password] &#8211;store=[store.myshopify.com]<\/span><span style=\"font-weight: 400;\"> to list all themes with their IDs. Alternatively, go to Shopify Admin \u2192 Online Store \u2192 Themes \u2192 Edit code and copy the numeric ID from the URL.<\/span><\/p>\n<h3><span style=\"font-weight: 400;\">What Is the Difference Between theme watch and theme deploy?<\/span><\/h3>\n<p><span style=\"font-weight: 400;\">theme watch<\/span><span style=\"font-weight: 400;\"> monitors files continuously and uploads individual changes as you save. <\/span><span style=\"font-weight: 400;\">theme deploy<\/span><span style=\"font-weight: 400;\"> pushes all local files to Shopify at once. Use watch during active development; use deploy when pushing a complete, reviewed build.<\/span><\/p>\n<h3><span style=\"font-weight: 400;\">Does Shopify Theme Kit Work with Online Store 2.0?<\/span><\/h3>\n<p><span style=\"font-weight: 400;\">Theme Kit can read and write OS 2.0 theme files, but doesn&#8217;t fully support the JSON template and <a href=\"https:\/\/ecommerce.folio3.com\/blog\/shopify-app-blocks\/\">app block<\/a> architecture. For new OS 2.0 builds, Shopify CLI is the correct tool. Theme Kit is best for pre-2.0 theme maintenance.<\/span><\/p>\n<h3><span style=\"font-weight: 400;\">What Should I Add to .gitignore When Using Shopify Themekit?<\/span><\/h3>\n<p><span style=\"font-weight: 400;\">Always exclude <\/span><span style=\"font-weight: 400;\">config.yml<\/span><span style=\"font-weight: 400;\"> since it contains your Theme Access password. Also exclude <\/span><span style=\"font-weight: 400;\">node_modules\/<\/span><span style=\"font-weight: 400;\">, <\/span><span style=\"font-weight: 400;\">.DS_Store<\/span><span style=\"font-weight: 400;\">, and any build output directories to keep sensitive credentials out of your repository.<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Editing Shopify themes in a browser window \u2014 without version control, proper tooling, or a local environment, is slow and hard to scale. Mistakes go live instantly, and collaboration becomes a bottleneck. Shopify Theme Kit solves this. It&#8217;s a command-line tool that lets you develop themes locally, sync changes automatically, and manage multiple environments with<\/p>\n","protected":false},"author":70,"featured_media":16327,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[29],"tags":[68],"class_list":{"0":"post-16274","1":"post","2":"type-post","3":"status-publish","4":"format-standard","5":"has-post-thumbnail","7":"category-shopify","8":"tag-shopify-development"},"acf":[],"featured_image_data":{"src":"https:\/\/ecommerce.folio3.com\/blog\/wp-content\/uploads\/2023\/02\/install-Shopify-theme-kit.png","alt":"Shopify Theme Kit: A Complete Guide to Setup and Customization","caption":""},"_links":{"self":[{"href":"https:\/\/ecommerce.folio3.com\/blog\/wp-json\/wp\/v2\/posts\/16274"}],"collection":[{"href":"https:\/\/ecommerce.folio3.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ecommerce.folio3.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ecommerce.folio3.com\/blog\/wp-json\/wp\/v2\/users\/70"}],"replies":[{"embeddable":true,"href":"https:\/\/ecommerce.folio3.com\/blog\/wp-json\/wp\/v2\/comments?post=16274"}],"version-history":[{"count":0,"href":"https:\/\/ecommerce.folio3.com\/blog\/wp-json\/wp\/v2\/posts\/16274\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/ecommerce.folio3.com\/blog\/wp-json\/wp\/v2\/media\/16327"}],"wp:attachment":[{"href":"https:\/\/ecommerce.folio3.com\/blog\/wp-json\/wp\/v2\/media?parent=16274"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ecommerce.folio3.com\/blog\/wp-json\/wp\/v2\/categories?post=16274"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ecommerce.folio3.com\/blog\/wp-json\/wp\/v2\/tags?post=16274"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}