{"_id":"5968244b456d69001568a804","project":"55a6e72e8cc73e0d00096635","version":{"_id":"55a6e72f8cc73e0d00096638","project":"55a6e72e8cc73e0d00096635","hasReference":false,"__v":29,"hasDoc":true,"createdAt":"2015-07-15T23:05:19.125Z","releaseDate":"2015-07-15T23:05:19.125Z","categories":["55a6e7308cc73e0d00096639","55b7ed07aea7c8190058badb","5604567c0c78b00d0039b191","5605e6f23a93940d002b3e4a","5605f2bba4574a0d00811365","5605f309a4574a0d00811366","5608e3b98aedf50d0004cf8f","5608e4318aedf50d0004cf90","5608e6b5a7cc2f0d00d9754d","5608e6d331beb60d001b6560","5608f879a7cc2f0d00d97580","560b097887b71d0d000d3bd9","560b13cbafa0990d00979545","560b5cbec341310d00de2a01","560b5cd0c341310d00de2a02","566a35b81e08750d00a0c49b","566a3e8503b4b20d00d02a4a","567889d307bf6a0d0083edc8","569c8b7c15bb390d00db6f9d","56b254dc65ddf50d0076ba8f","57a8ebc4cdeea20e001d2a63","57e48a4000c8680e00fae6e7","5808216773557d0f00a1e428","58105ad54a8aa50f00aa4cba","58105bf298aea40f00afa3ba","58105f548a4aed0f00d67536","581061b898aea40f00afa3be","584b3de7e5f3a42300df6ef7","596839a75965d400155bb750"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"category":{"_id":"566a3e8503b4b20d00d02a4a","__v":2,"version":"55a6e72f8cc73e0d00096638","pages":["5678aacb07bf6a0d0083eded","56a55f47b26c040d00d99281"],"project":"55a6e72e8cc73e0d00096635","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-12-11T03:09:57.119Z","from_sync":false,"order":7,"slug":"shipping-a-theme","title":"Shipping a Theme"},"user":"55a6caa022cfa321008e01d6","__v":1,"parentDoc":null,"updates":["59b6e4a40e00c90010b64939"],"next":{"pages":[],"description":""},"createdAt":"2017-07-14T01:54:19.164Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":3,"body":"When your theme is complete, you'll be ready to preflight, process, and package an archived copy for upload to BigCommerce. This page covers:\n\n* [Downloaded Theme? Refresh Dependencies](#refresh)\n* [Verify Directory and File Permissions](#permissions)\n* [Bundling Your Theme](#ship-zip-small)\n* [Check/Adjust Zipfile's Size](#zipsize)\n* [Uploading Your Theme](#upload)\n\n\n<hr style=\"background-color:#4E75F8; border-width:0;color:#000000; height:2px; line-height:0; text-align:left; width:100%;\"/>\n\n<h2> <a name=\"refresh\"></a> Downloaded Theme? Refresh Dependencies </h2>\n\nIf you have customized a theme originally downloaded from the BigCommerce Theme Marketplace: Before you package your theme, make sure your theme directory includes all the dependencies that BigCommerce requires for submission. Follow the link for your scenario:\n\n* If you downloaded a refreshed version of Stencil's default Cornerstone theme, or of the Queen theme: Run&#160;`npm install` in the theme directory to install refreshed JavaScript dependencies, as outlined [here](/docs/javascript-utilities).\n\n* If you downloaded a different Marketplace theme, and its [version was lower than `1.10.0`](/docs/downloading-and-customizing-marketplace-themes#jspm_branch): \nYou must also run `jspm install` in the theme directory, as outlined [here](/docs/downloading-and-customizing-marketplace-themes#install_jspm).\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"No Automatic Check for Dependencies\",\n  \"body\": \"The `stencil bundle` and `stencil push` commands do not check for the dependencies that these build systems install. So if those dependencies are missing, these commands will not immediately report errors. However, your resulting .zip file will not properly upload to BigCommerce, and will not run properly on a storefront.\"\n}\n[/block]\n<hr style=\"background-color:#4E75F8; border-width:0;color:#000000; height:2px; line-height:0; text-align:left; width:100%;\"/>\n\n<h2> <a name=\"permissions\"></a> Verify Directory and File Permissions </h2>\n\nIf you have added any new subdirectories or files to your base theme, verify that you have:  \n\n* Set newly added directories to permission `755` (`drwxr-xr-x`). \n* Set newly added files to permission `644` (`rw-r--r--`).\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Writable Permissions Are Required\",\n  \"body\": \"Without these permissions, bundling your theme will fail, blocking its upload to BigCommerce.\"\n}\n[/block]\n<hr style=\"background-color:#4E75F8; border-width:0;color:#000000; height:2px; line-height:0; text-align:left; width:100%;\"/>\n\n<h2> <a name=\"ship-zip-small\"></a> Bundling Your Theme </h2>\n\nOnce you have verified the requirements <a href=\"#refresh\">above</a>, you are ready to process and package your theme for upload to BigCommerce. Stencil CLI provides two alternatives for creating a .zip file that contains all of your theme's essentials, while excluding redundant components. These options are available, depending on how you've [authorized](/docs/initializing-stencil) your theme:\n\n* [Bundle Only](#bundle-only) (OAuth or Basic Auth)\n* [Bundle and Push](#bundle-push) (OAuth Required)\n\n<h3> <a name=\"bundle-only\"></a> Bundle Only (OAuth or Basic Auth) </h3>\n\nThe `stencil bundle` command is available for all themes, whether they were initialized using [OAuth](/docs/creating-an-api-account#oauth) or [Basic-Auth](/docs/creating-an-api-account#legacy) tokens. To use it, just enter the following on your command line:\n\n```\nstencil bundle\n```\n\nThe `bundle` command will notify you of its progress and completion.\n<a name=\"zipsize\"></a>\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"Check the resulting .zip file's size before you proceed. The zipped bundle should (ideally) be only a few megabytes. BigCommerce imposes a hard limit of 50 MB, and any file size approaching that is problematic.\\n  \\nIf your .zip file fits comfortably within the size limit above, jump directly to <a href=\\\"#upload\\\">Uploading Your Theme</a>.\\n\\nHowever, if your .zip file approaches or exceeds 50 MB, you must first use one of these procedures to restructure your theme to a size that's manageable for upload to BigCommerce: \\n\\n* <a href=\\\"/docs/webdav-static-assets\\\">Shrinking Your Theme by Excluding Static Assets (WebDAV)</a>\\n* <a href=\\\"/docs/cdn-dir\\\">Staging a Theme for CDN Delivery</a>\",\n  \"title\": \"Check/Adjust Zipfile's Size\"\n}\n[/block]\n<h3> <a name=\"bundle-push\"></a> Bundle and Push (OAuth Required) </h3>\n\nThe `stencil push` command is available only for themes that you have successfully [initialized](/docs/initializing-stencil#oauth) using an [OAuth](/docs/creating-an-api-account#oauth) token (with `Themes`:`modify` scope). This command bundles your theme, and uploads it to the associated store, in one continuous process.\n\nFor further requirements and usage details, please see: \n* [Command-Line Upload (OAuth Required)](#push) below\n\nFor file-size error diagnostics and workarounds, please see: \n* [Check/Adjust Zipfile's Size](#zipsize) above\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Software Requirements / Resolving Lint Errors\",\n  \"body\": \"* Please use only the `stencil bundle` or the `stencil push` command to process and package themes for submission. These commands generate .zip files that match BigCommerce's expected structure. They also generate metadata required for your theme to function properly. \\n\\n* Do not create .zip files using general-purpose archiving software. The resulting files will trigger errors upon upload to BigCommerce. \\n\\n* Do not open a bundled theme .zip file to add, delete, rename, or update files. Doing so will make your theme unusable on the production store.\\n\\n* If bundling your theme triggers multiple lint errors related to the `bundle.js` file, then your theme is missing the `.eslintignore` file. Please retrieve this file from the <a href=\\\"https://github.com/bigcommerce/cornerstone\\\">Stencil Cornerstone repo</a>, then re-run `stencil bundle` or `stencil push`.\"\n}\n[/block]\n<hr style=\"background-color:#4E75F8; border-width:0;color:#000000; height:2px; line-height:0; text-align:left; width:100%;\"/>\n\n<h2> <a name=\"upload\"></a> Uploading Your Theme </h2>\n\nBigCommerce provides two alternatives for uploading a theme to its associated BigCommerce store. These options are available, depending on how you've [authorized](/docs/initializing-stencil) your theme:\n\n* [Control-Panel Upload](#gui) (OAuth or Basic Auth)\n* [Command-Line Upload](#push) (OAuth Required)\n\n\n### <a name=\"gui\"></a> Control-Panel Upload (OAuth or Basic Auth)\n\nUploading your theme via the BigCommerce control panel's GUI is compatible with any store token (whether [OAuth](/docs/creating-an-api-account#oauth) or [Basic-Auth](/docs/creating-an-api-account#legacy)), and with any OAuth token scope, and with all versions of Stencil CLI. However, this option requires that you first use `stencil bundle` to package your theme into a .zip file. (Prepare your file according to [Bundle Only](#bundle-only) above.)\n\nFor the upload steps in the control panel, please see this article in our merchant-oriented documentation: \n\n* <a href=\"https://support.bigcommerce.com/articles/Public/Custom-Theme-Upload\">Uploading Custom Themes</a>\n\nFor error codes that you might encounter when uploading a theme – and corresponding workarounds – please see the next page in this documentation:\n\n* <a href=\"/docs/uploading-a-custom-theme\">Troubleshooting Theme Uploads</a>\n\n\n### <a name=\"push\"></a> Command-Line Upload (OAuth Required)\n\nThe `stencil push` command allows you to both bundle your theme and upload it to the store, with a single terminal command. To run `stencil push`, you must first:\n\n* Successfully [initialize](/docs/initializing-stencil#oauth) your theme using an [OAuth](/docs/creating-an-api-account#oauth) token that was created with the `Themes`:`modify` scope.\n* Install Stencil CLI version 1.12.0 or higher.\n\n  To check your current Stencil CLI version, enter `stencil --version` or `stencil -V` on the command line. If&#160;you need to update an earlier version, [reinstall](https://stencil.bigcommerce.com/docs/installing-stencil-cli-1) Stencil CLI.\n\n#### Pushing a Theme Upload\n\nTo initiate bundling and upload, enter the following on the command line:\n\n```\nstencil push\n```\n\nStencil CLI is designed to display the same notifications, prompts, and selection options that you would receive when using the [control panel's GUI](#gui). Below are some of the notifications and interactions you might see.\n\n\n##### <a name=\"bundled\"></a> Successful Bundling\n\nStencil CLI will display `ok` confirmations, or `not ok` errors, or `warning`s for individual substeps in bundling and uploading your theme. If bundling is successful, you will next see a `Processing` progress bar to track the upload.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/08cf9d1-push-ok-confirm.png\",\n        \"push-ok-confirm.png\",\n        953,\n        404,\n        \"#1a1c20\"\n      ]\n    }\n  ]\n}\n[/block]\n(If you upload a new version of an existing theme, BC will append an integer to the new copy's name, to distinguish it.)\n\n##### <a name=\"uploaded\"></a>Successful Upload\n\nUpon a successful upload, you will be prompted: `Would you like to apply your theme to your store at <storehash>? (y/N)` Any response except `y` or `Y` will be processed as \"No.\" (You can always apply the theme later [through the control panel](https://support.bigcommerce.com/articles/Public/The-Bigcommerce-Themes-Marketplace#adding).)\n\n##### Apply Which Variation?\n\nIf you chose to apply the newly uploaded theme, you will be prompted: `Which variation would you like to apply? (Use arrow keys)`\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/3f32479-push-variation-prompt.png\",\n        \"push-variation-prompt.png\",\n        951,\n        466,\n        \"#191c1f\"\n      ]\n    }\n  ]\n}\n[/block]\nUse your arrow keys to move the selection caret/highlight to the variation you want, and then press `Enter`. \nStencil CLI will then confirm which variation is active on the storefront.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/7bc84de-push-variation-reply.png\",\n        \"push-variation-reply.png\",\n        948,\n        429,\n        \"#1a1c1f\"\n      ]\n    }\n  ]\n}\n[/block]\n##### <a name=\"quota\"></a> Theme Quota Warning\n\nIf you run `stencil push` when your store's `My Themes` section has reached its [maximum of 20 themes](/docs/uploading-a-custom-theme#restrix), you will be prompted to select at least one existing theme for deletion.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/0cbe3a3-push-quota-delete-prompt.png\",\n        \"push-quota-delete-prompt.png\",\n        941,\n        503,\n        \"#191b1f\"\n      ]\n    }\n  ]\n}\n[/block]\nCustom themes – which are available for selection – will have a circle to their left. Marketplace themes and the store's active theme – all of which are protected from deletion – will be flagged `(Disabled)`.\n\nUse your arrow keys to move the selection caret to each theme/version that you want to select. Then press the spacebar to select it. (Filled circles will indicate your selected themes/versions.)\n\nIf you are certain of your selections, you can next press `Enter` to delete the themes.\n\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"Select Carefully – No Confirmation\",\n  \"body\": \"Once you press `Enter`, the selected themes will be deleted immediately, with no further confirmation.\\n\\nIf you have any doubts – especially about deleting multiple themes/versions – it is safest to [delete them through the control-panel GUI](https://support.bigcommerce.com/articles/Public/Custom-Theme-Upload#delete). This GUI allows you to compare uploaded versions, and to inspect their metadata.\"\n}\n[/block]\n\n[block:html]\n{\n  \"html\": \"<!--\\n##### <a name=\\\"active\\\"></a> Active-Theme Deletion Error\\n\\nIf you try to delete the active theme (the one applied to the storefront), you will receive a `403 Forbidden` error. This&#160;protects you from removing the theme in use on the store.\\n\\n![](https://files.readme.io/6719c8f-push-delete-active-theme-error.png)\\n-->\"\n}\n[/block]\n#### Other Bundling or Upload Errors\n\nFor any other `not ok` bundling or upload errors that you receive, please refer to these debugging guidelines:\n\n* Theme [setup](#refresh) and [sizing](#zipsize) diagnostics, in preceding sections throughout this page.\n* [Troubleshooting Theme Uploads](/docs/uploading-a-custom-theme), on the next page.","excerpt":"","slug":"bundling-submitting","type":"basic","title":"Bundling and Submitting a Theme"}

Bundling and Submitting a Theme


When your theme is complete, you'll be ready to preflight, process, and package an archived copy for upload to BigCommerce. This page covers: * [Downloaded Theme? Refresh Dependencies](#refresh) * [Verify Directory and File Permissions](#permissions) * [Bundling Your Theme](#ship-zip-small) * [Check/Adjust Zipfile's Size](#zipsize) * [Uploading Your Theme](#upload) <hr style="background-color:#4E75F8; border-width:0;color:#000000; height:2px; line-height:0; text-align:left; width:100%;"/> <h2> <a name="refresh"></a> Downloaded Theme? Refresh Dependencies </h2> If you have customized a theme originally downloaded from the BigCommerce Theme Marketplace: Before you package your theme, make sure your theme directory includes all the dependencies that BigCommerce requires for submission. Follow the link for your scenario: * If you downloaded a refreshed version of Stencil's default Cornerstone theme, or of the Queen theme: Run&#160;`npm install` in the theme directory to install refreshed JavaScript dependencies, as outlined [here](/docs/javascript-utilities). * If you downloaded a different Marketplace theme, and its [version was lower than `1.10.0`](/docs/downloading-and-customizing-marketplace-themes#jspm_branch): You must also run `jspm install` in the theme directory, as outlined [here](/docs/downloading-and-customizing-marketplace-themes#install_jspm). [block:callout] { "type": "warning", "title": "No Automatic Check for Dependencies", "body": "The `stencil bundle` and `stencil push` commands do not check for the dependencies that these build systems install. So if those dependencies are missing, these commands will not immediately report errors. However, your resulting .zip file will not properly upload to BigCommerce, and will not run properly on a storefront." } [/block] <hr style="background-color:#4E75F8; border-width:0;color:#000000; height:2px; line-height:0; text-align:left; width:100%;"/> <h2> <a name="permissions"></a> Verify Directory and File Permissions </h2> If you have added any new subdirectories or files to your base theme, verify that you have: * Set newly added directories to permission `755` (`drwxr-xr-x`). * Set newly added files to permission `644` (`rw-r--r--`). [block:callout] { "type": "warning", "title": "Writable Permissions Are Required", "body": "Without these permissions, bundling your theme will fail, blocking its upload to BigCommerce." } [/block] <hr style="background-color:#4E75F8; border-width:0;color:#000000; height:2px; line-height:0; text-align:left; width:100%;"/> <h2> <a name="ship-zip-small"></a> Bundling Your Theme </h2> Once you have verified the requirements <a href="#refresh">above</a>, you are ready to process and package your theme for upload to BigCommerce. Stencil CLI provides two alternatives for creating a .zip file that contains all of your theme's essentials, while excluding redundant components. These options are available, depending on how you've [authorized](/docs/initializing-stencil) your theme: * [Bundle Only](#bundle-only) (OAuth or Basic Auth) * [Bundle and Push](#bundle-push) (OAuth Required) <h3> <a name="bundle-only"></a> Bundle Only (OAuth or Basic Auth) </h3> The `stencil bundle` command is available for all themes, whether they were initialized using [OAuth](/docs/creating-an-api-account#oauth) or [Basic-Auth](/docs/creating-an-api-account#legacy) tokens. To use it, just enter the following on your command line: ``` stencil bundle ``` The `bundle` command will notify you of its progress and completion. <a name="zipsize"></a> [block:callout] { "type": "warning", "body": "Check the resulting .zip file's size before you proceed. The zipped bundle should (ideally) be only a few megabytes. BigCommerce imposes a hard limit of 50 MB, and any file size approaching that is problematic.\n \nIf your .zip file fits comfortably within the size limit above, jump directly to <a href=\"#upload\">Uploading Your Theme</a>.\n\nHowever, if your .zip file approaches or exceeds 50 MB, you must first use one of these procedures to restructure your theme to a size that's manageable for upload to BigCommerce: \n\n* <a href=\"/docs/webdav-static-assets\">Shrinking Your Theme by Excluding Static Assets (WebDAV)</a>\n* <a href=\"/docs/cdn-dir\">Staging a Theme for CDN Delivery</a>", "title": "Check/Adjust Zipfile's Size" } [/block] <h3> <a name="bundle-push"></a> Bundle and Push (OAuth Required) </h3> The `stencil push` command is available only for themes that you have successfully [initialized](/docs/initializing-stencil#oauth) using an [OAuth](/docs/creating-an-api-account#oauth) token (with `Themes`:`modify` scope). This command bundles your theme, and uploads it to the associated store, in one continuous process. For further requirements and usage details, please see: * [Command-Line Upload (OAuth Required)](#push) below For file-size error diagnostics and workarounds, please see: * [Check/Adjust Zipfile's Size](#zipsize) above [block:callout] { "type": "warning", "title": "Software Requirements / Resolving Lint Errors", "body": "* Please use only the `stencil bundle` or the `stencil push` command to process and package themes for submission. These commands generate .zip files that match BigCommerce's expected structure. They also generate metadata required for your theme to function properly. \n\n* Do not create .zip files using general-purpose archiving software. The resulting files will trigger errors upon upload to BigCommerce. \n\n* Do not open a bundled theme .zip file to add, delete, rename, or update files. Doing so will make your theme unusable on the production store.\n\n* If bundling your theme triggers multiple lint errors related to the `bundle.js` file, then your theme is missing the `.eslintignore` file. Please retrieve this file from the <a href=\"https://github.com/bigcommerce/cornerstone\">Stencil Cornerstone repo</a>, then re-run `stencil bundle` or `stencil push`." } [/block] <hr style="background-color:#4E75F8; border-width:0;color:#000000; height:2px; line-height:0; text-align:left; width:100%;"/> <h2> <a name="upload"></a> Uploading Your Theme </h2> BigCommerce provides two alternatives for uploading a theme to its associated BigCommerce store. These options are available, depending on how you've [authorized](/docs/initializing-stencil) your theme: * [Control-Panel Upload](#gui) (OAuth or Basic Auth) * [Command-Line Upload](#push) (OAuth Required) ### <a name="gui"></a> Control-Panel Upload (OAuth or Basic Auth) Uploading your theme via the BigCommerce control panel's GUI is compatible with any store token (whether [OAuth](/docs/creating-an-api-account#oauth) or [Basic-Auth](/docs/creating-an-api-account#legacy)), and with any OAuth token scope, and with all versions of Stencil CLI. However, this option requires that you first use `stencil bundle` to package your theme into a .zip file. (Prepare your file according to [Bundle Only](#bundle-only) above.) For the upload steps in the control panel, please see this article in our merchant-oriented documentation: * <a href="https://support.bigcommerce.com/articles/Public/Custom-Theme-Upload">Uploading Custom Themes</a> For error codes that you might encounter when uploading a theme – and corresponding workarounds – please see the next page in this documentation: * <a href="/docs/uploading-a-custom-theme">Troubleshooting Theme Uploads</a> ### <a name="push"></a> Command-Line Upload (OAuth Required) The `stencil push` command allows you to both bundle your theme and upload it to the store, with a single terminal command. To run `stencil push`, you must first: * Successfully [initialize](/docs/initializing-stencil#oauth) your theme using an [OAuth](/docs/creating-an-api-account#oauth) token that was created with the `Themes`:`modify` scope. * Install Stencil CLI version 1.12.0 or higher. To check your current Stencil CLI version, enter `stencil --version` or `stencil -V` on the command line. If&#160;you need to update an earlier version, [reinstall](https://stencil.bigcommerce.com/docs/installing-stencil-cli-1) Stencil CLI. #### Pushing a Theme Upload To initiate bundling and upload, enter the following on the command line: ``` stencil push ``` Stencil CLI is designed to display the same notifications, prompts, and selection options that you would receive when using the [control panel's GUI](#gui). Below are some of the notifications and interactions you might see. ##### <a name="bundled"></a> Successful Bundling Stencil CLI will display `ok` confirmations, or `not ok` errors, or `warning`s for individual substeps in bundling and uploading your theme. If bundling is successful, you will next see a `Processing` progress bar to track the upload. [block:image] { "images": [ { "image": [ "https://files.readme.io/08cf9d1-push-ok-confirm.png", "push-ok-confirm.png", 953, 404, "#1a1c20" ] } ] } [/block] (If you upload a new version of an existing theme, BC will append an integer to the new copy's name, to distinguish it.) ##### <a name="uploaded"></a>Successful Upload Upon a successful upload, you will be prompted: `Would you like to apply your theme to your store at <storehash>? (y/N)` Any response except `y` or `Y` will be processed as "No." (You can always apply the theme later [through the control panel](https://support.bigcommerce.com/articles/Public/The-Bigcommerce-Themes-Marketplace#adding).) ##### Apply Which Variation? If you chose to apply the newly uploaded theme, you will be prompted: `Which variation would you like to apply? (Use arrow keys)` [block:image] { "images": [ { "image": [ "https://files.readme.io/3f32479-push-variation-prompt.png", "push-variation-prompt.png", 951, 466, "#191c1f" ] } ] } [/block] Use your arrow keys to move the selection caret/highlight to the variation you want, and then press `Enter`. Stencil CLI will then confirm which variation is active on the storefront. [block:image] { "images": [ { "image": [ "https://files.readme.io/7bc84de-push-variation-reply.png", "push-variation-reply.png", 948, 429, "#1a1c1f" ] } ] } [/block] ##### <a name="quota"></a> Theme Quota Warning If you run `stencil push` when your store's `My Themes` section has reached its [maximum of 20 themes](/docs/uploading-a-custom-theme#restrix), you will be prompted to select at least one existing theme for deletion. [block:image] { "images": [ { "image": [ "https://files.readme.io/0cbe3a3-push-quota-delete-prompt.png", "push-quota-delete-prompt.png", 941, 503, "#191b1f" ] } ] } [/block] Custom themes – which are available for selection – will have a circle to their left. Marketplace themes and the store's active theme – all of which are protected from deletion – will be flagged `(Disabled)`. Use your arrow keys to move the selection caret to each theme/version that you want to select. Then press the spacebar to select it. (Filled circles will indicate your selected themes/versions.) If you are certain of your selections, you can next press `Enter` to delete the themes. [block:callout] { "type": "danger", "title": "Select Carefully – No Confirmation", "body": "Once you press `Enter`, the selected themes will be deleted immediately, with no further confirmation.\n\nIf you have any doubts – especially about deleting multiple themes/versions – it is safest to [delete them through the control-panel GUI](https://support.bigcommerce.com/articles/Public/Custom-Theme-Upload#delete). This GUI allows you to compare uploaded versions, and to inspect their metadata." } [/block] [block:html] { "html": "<!--\n##### <a name=\"active\"></a> Active-Theme Deletion Error\n\nIf you try to delete the active theme (the one applied to the storefront), you will receive a `403 Forbidden` error. This&#160;protects you from removing the theme in use on the store.\n\n![](https://files.readme.io/6719c8f-push-delete-active-theme-error.png)\n-->" } [/block] #### Other Bundling or Upload Errors For any other `not ok` bundling or upload errors that you receive, please refer to these debugging guidelines: * Theme [setup](#refresh) and [sizing](#zipsize) diagnostics, in preceding sections throughout this page. * [Troubleshooting Theme Uploads](/docs/uploading-a-custom-theme), on the next page.