{"_id":"57113a49840e9134005c7678","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"},"parentDoc":null,"__v":159,"user":"55a6caa022cfa321008e01d6","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"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-04-15T19:00:25.799Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":5,"body":"To upload a custom or customized Stencil theme, you must first bundle it, as outlined [here](/docs/bundling-submitting#ship-zip-small). Next, upload it via the BigCommerce control panel, as outlined in <a href=\"https://support.bigcommerce.com/articles/Public/Custom-Theme-Upload\" target=\"_blank\">this</a> merchant-oriented article. \n\nThis entry supplements those sources, by offering developer-oriented details on:\n \n* [Restrictions](#restrix)\n* [Error Codes](#errors)\n* [Warnings](#warnings)\n* [Workarounds and Further Info](#workarounds)\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Also Check: Terminal Window, config.json Documentation\",\n  \"body\": \"If you encounter any unexpected behavior while developing your Stencil theme, please also check the terminal window from which you started Stencil CLI.\\n\\nIn many cases, the terminal will provide a verbose error message specifying where to look for problems. For&#160;less-detailed error messages, we provide diagnostics in this documentation.\\n\\nPlease also check the [config.json documentation](/docs/configjson-reference) for required keys, and for keys that require values.\"\n}\n[/block]\n## <a name=\"restrix\"></a> Restrictions\n\nCustom theme uploads must meet these restrictions:\n\n* You may upload a maximum of 20 custom themes at a time to the control panel's `Store Design` > `My Themes` section.\n* If you reach this maximum, you can delete custom themes, to make room for more uploads.\n* Before uploading, you must package custom themes into a Stencil-specific .zip file format, using Stencil CLI's [<span class=\"inline-code\">stencil bundle</span>](/docs/bundling-submitting#ship-zip-small) command.\n* A theme's .zip file must be no larger than 50 MB. If your file exceeds that size, please use either a [WebDAV](/docs/webdav-static-assets) or a [CDN](https://stencil.bigcommerce.com/docs/cdn-dir) upload to exclude large static assets.\n[block:html]\n{\n  \"html\": \"<!-- * Themes' .zip file names must be restricted to Latin characters (the [ISO-8859-1](http://www.w3schools.com/charsets/ref_html_8859.asp) or 7-bit ASCII character set). Do not include extended-ASCII characters (such as Chinese- or Arabic-language characters). Otherwise, attempts to download the resulting .zip file will trigger an error.\\n-->\"\n}\n[/block]\n## <a name=\"errors\"></a> Error Codes\n\nIf a custom theme upload fails, BigCommerce will display and/or log error codes in the format <span class=\"inline-code\">TR-&lt;code&gt;</span>   \n(where <span class=\"inline-code\">TR</span> is an abbreviation for Theme Registry). Here are the codes and their meanings:\n[block:html]\n{\n  \"html\": \"<table>\\n  <tr>\\n    <td class=\\\"\\\">Error Code</td>\\n    <td class=\\\"\\\">Meaning</td>\\n  </tr>\\n  <tr>\\n    <td class=\\\"\\\">TR-100, -101, -700, -1200, -1300</td>\\n    <td class=\\\"\\\">A server error occurred.</td>\\n  </tr>\\n  <tr>\\n    <td class=\\\"\\\">TR-200</td>\\n    <td class=\\\"\\\">Problem uploading the theme.</td>\\n  </tr>\\n  <tr>\\n    <td class=\\\"\\\">TR-300</td>\\n    <td class=\\\"\\\">Invalid .zip file. (Among other possible root causes, this can indicate an included <span class=\\\"inline-code\\\">bundle.js.map</span> source-map file that exceeds its size limit of 5 MB. As a workaround, move this file outside your theme directory before re-running <span class=\\\"inline-code\\\">stencil bundle</span>).</td>\\n  </tr>\\n  <tr>\\n    <td class=\\\"\\\">TR-301</td>\\n    <td class=\\\"\\\">Failed to unzip file.</td>\\n  </tr>\\n  <tr>\\n    <td class=\\\"\\\">TR-400</td>\\n    <td class=\\\"\\\">The .zip contains restricted/invalid file(s) &ndash; e.g., a file with an invalid extension.</td>\\n  </tr>\\n  <tr>\\n    <td class=\\\"\\\">TR-500</td>\\n    <td class=\\\"\\\">The .zip file is larger than the 50MB limit.</td>\\n  </tr>\\n  <tr>\\n    <td class=\\\"\\\">TR-600</td>\\n    <td class=\\\"\\\">The .zip file is missing a required file (<span class=\\\"inline-code\\\">&lt;theme-name&gt;/templates/pages/home.html</span>).</td>\\n  </tr>\\n  <tr>\\n    <td class=\\\"\\\">TR-601</td>\\n    <td class=\\\"\\\">The .zip file is missing some parsed template file(s); or, one or more non-<span class=\\\"inline-code\\\">.html</span> files are present in the <NOBR><span class=\\\"inline-code\\\">&lt;theme-name&gt;/templates/</span></nobr> subdirectory.</td>\\n  </tr>\\n  <tr>\\n    <td class=\\\"\\\">TR-800</td>\\n    <td class=\\\"\\\">There was a problem processing the contained <a href=\\\"/docs/configjson-reference\\\">config.json</a> file. <br> <b>Please check the <NOBR><a href=\\\"/docs/configjson-reference\\\">config.json documentation</a></nobr> for required keys, and for keys that require values.</b></td>\\n  </tr>\\n  <tr>\\n    <td class=\\\"\\\">TR-900</td>\\n    <td class=\\\"\\\">The contained config.json file is missing required <a href=\\\"/docs/configjson-reference#config-theme-meta\\\">developer information</a>.</td>\\n  </tr>\\n  <tr>\\n    <td class=\\\"\\\">TR-901</td>\\n    <td class=\\\"\\\">A <a href=\\\"/docs/configjson-reference#config-variations\\\">theme variation</a> defined in the contained config.json file is missing its required external ID.</td>\\n  </tr>\\n  <tr>\\n    <td class=\\\"\\\">TR-902</td>\\n    <td class=\\\"\\\">Two or more <a href=\\\"/docs/configjson-reference#config-variations\\\">theme variations</a> defined in the contained config.json file share a external ID. <NOBR>All external</nobr> IDs must be unique.</td>\\n  </tr>\\n  <tr>\\n    <td class=\\\"\\\">TR-1000</td>\\n    <td class=\\\"\\\">There was a problem processing the contained <a href=\\\"/docs/schemajson-metadata-for-theme-editor\\\">schema.json</a> file.</td>\\n  </tr>\\n  <tr>\\n    <td class=\\\"\\\">TR-1001</td>\\n    <td class=\\\"\\\">The theme is missing its required <a href=\\\"/docs/schemajson-metadata-for-theme-editor\\\">schema.json</a> file.</td>\\n  </tr>\\n  <tr>\\n    <td class=\\\"\\\">TR-1400</td>\\n    <td class=\\\"\\\">There was a problem processing template <a href=\\\"/docs/using-yaml-front-matter\\\">front matter</a>.</td>\\n  </tr>\\n  <tr>\\n    <td class=\\\"\\\">TR-1401</td>\\n    <td class=\\\"\\\">There was a database validation error when saving <a href=\\\"/docs/using-yaml-front-matter\\\">front matter</a> to the database.</td>\\n  </tr>\\n  <tr>\\n    <td class=\\\"\\\">TR-1500</td>\\n    <td class=\\\"\\\">There was a problem uploading your files, due to multi-threading (multiple simultaneous uploads). Please try again.</td>\\n  </tr>\\n  <tr>\\n    <td class=\\\"\\\">TR-1600</td>\\n    <td class=\\\"\\\">There was a temporary problem on our system. Please try again.</td>\\n  </tr>\\n  <tr>\\n    <td class=\\\"\\\">TR-1601</td>\\n    <td class=\\\"\\\">There was a problem processing screenshots.</td>\\n  </tr>\\n  <tr>\\n    <td class=\\\"\\\">TR-1700, -1800, -1801, -1802, -1803</td>\\n    <td class=\\\"\\\">System error, possibly temporary. Please try again.</td>\\n  </tr>\\n  <tr>\\n    <td class=\\\"\\\">TR-3402</td>\\n    <td class=\\\"\\\">You are not allowed to edit your active theme. [Please select <span class=\\\"inline-code\\\">Make a Copy</span>, then edit the resulting copy of your theme.]</td>\\n  </tr>\\n  <tr>\\n    <td class=\\\"\\\">TR-4400</td>\\n    <td class=\\\"\\\">One or more values in the <span class=\\\"inline-code\\\">config.json</span> file exceed the 64-character limit. (Can also indicate string lengths that exceed their limits in other JSON files.)</td>\\n  </tr>\\n </table>\\n\\n<!-- \\n`config.json` > `author_support_url` is a required field. If missing, the upload will fail with something like TR-900, and the theme's author will probably call customer support to ask about it.\\n\\n`config.json` > `documentation_url` is not a required field. If missing, it will be replaced by [https://stencil.bigcommerce.com/docs/what-is-stencil](this BigCommerce-hosted page).\\n\\n`config.json` > developer contact info is required. -->\"\n}\n[/block]\n## <a name=\"warnings\"></a> Warnings\n\nWarnings will not block a theme's upload, but these onscreen and/or log messages notify you of problems within the zipped theme. Here are the warnings and their meanings:\n\n| Warning |\n|---|\n| (These messages do not have numeric codes) |\n| Issue in processing this theme's thumbnail [screenshot](/docs/configjson-reference#config-theme-meta) (<span class=\"inline-code\">composed_image</span>). |\n| Issue in processing this theme's full-size [screenshot](/docs/configjson-reference#config-var-meta) (<span class=\"inline-code\">desktop_screenshot</span>). |\n| Issue in processing this theme's mobile [screenshot](/docs/configjson-reference#config-var-meta) (<span class=\"inline-code\">mobile_screenshot</span>). |\n| Missing file: This theme does not support Theme Editor, as it is missing its required <span class=\"inline-code\">[schema.json](/docs/schemajson-metadata-for-theme-editor)</span> file. |\n| One or more of this theme's [screenshots](/docs/configjson-reference#config-var-meta) are not image files. |\n| Theme is missing a valid thumbnail [image](/docs/configjson-reference#config-theme-meta) (<span class=\"inline-code\">composed_image</span>). |\n| Theme is missing a valid full-size [image](/docs/configjson-reference#config-var-meta) (<span class=\"inline-code\">desktop_screenshot</span>). |\n| Theme is missing a valid mobile [image](/docs/configjson-reference#config-var-meta) (<span class=\"inline-code\">mobile_screenshot</span>). |\n| One or more of this theme's [images](/docs/configjson-reference#config-images) is not of a supported file type. Valid filetypes are: .jpg, .jpeg, .png, .gif. |\n| Thumbnail (<span class=\"inline-code\">composed_image</span>) [image dimensions](/docs/configjson-reference#config-theme-meta) are not right. Expected 600 x 760 pixels. |\n| Full-size (<span class=\"inline-code\">desktop_screenshot</span>) [image dimensions](/docs/configjson-reference#config-var-meta) are not right. Expected 2048 x 2600 pixels. |\n| Mobile (<span class=\"inline-code\">mobile_screenshot</span>) [image dimensions](/docs/configjson-reference#config-var-meta) are not right. Expected 304 x 540 pixels. |\n| Too-large [image file size](/docs/configjson-reference#config-theme-meta) for a theme screenshot [<span class=\"inline-code\">composed_image</span> (thumbnails), <span class=\"inline-code\">desktop_screenshot</span>, or <span class=\"inline-code\">mobile_screenshot</span>] . The maximum supported size is x, but the file's actual size is y. |\n\n## <a name=\"workarounds\"></a> Workarounds and Further Info\n\nIf a custom theme does not render properly after you upload and apply it to a storefront: Please make sure you have created the theme's .zip file using the <span class=\"inline-code\">[stencil bundle](/docs/bundling-submitting#ship-zip-small)</span> command, on a Mac OS or Linux computer or virtual machine. (This will exclude Windows-specific errors that have occurred on some bundles.)\n\nIf you repeatedly encounter the same error or warning, and neither this page nor our <a href=\"https://support.bigcommerce.com/articles/Public/Custom-Theme-Upload\" target=\"_blank\">KB</a> resolves the problem: Please&#160;see&#160;support&#160;resources for theme developers [here](https://developer.bigcommerce.com/support/).\n[block:html]\n{\n  \"html\": \"<!-- /!\\\\ Beta Feature\\n\\nThis feature is currently in beta. Please contact your BigCommerce account manager for  details.\\n\\nSupport resources for BigCommerce store owners are linked from [this&#160;page](https://www.bigcommerce.com/contact/). -->\"\n}\n[/block]","excerpt":"","slug":"uploading-a-custom-theme","type":"basic","title":"Troubleshooting Theme Uploads"}

Troubleshooting Theme Uploads


To upload a custom or customized Stencil theme, you must first bundle it, as outlined [here](/docs/bundling-submitting#ship-zip-small). Next, upload it via the BigCommerce control panel, as outlined in <a href="https://support.bigcommerce.com/articles/Public/Custom-Theme-Upload" target="_blank">this</a> merchant-oriented article. This entry supplements those sources, by offering developer-oriented details on: * [Restrictions](#restrix) * [Error Codes](#errors) * [Warnings](#warnings) * [Workarounds and Further Info](#workarounds) [block:callout] { "type": "warning", "title": "Also Check: Terminal Window, config.json Documentation", "body": "If you encounter any unexpected behavior while developing your Stencil theme, please also check the terminal window from which you started Stencil CLI.\n\nIn many cases, the terminal will provide a verbose error message specifying where to look for problems. For&#160;less-detailed error messages, we provide diagnostics in this documentation.\n\nPlease also check the [config.json documentation](/docs/configjson-reference) for required keys, and for keys that require values." } [/block] ## <a name="restrix"></a> Restrictions Custom theme uploads must meet these restrictions: * You may upload a maximum of 20 custom themes at a time to the control panel's `Store Design` > `My Themes` section. * If you reach this maximum, you can delete custom themes, to make room for more uploads. * Before uploading, you must package custom themes into a Stencil-specific .zip file format, using Stencil CLI's [<span class="inline-code">stencil bundle</span>](/docs/bundling-submitting#ship-zip-small) command. * A theme's .zip file must be no larger than 50 MB. If your file exceeds that size, please use either a [WebDAV](/docs/webdav-static-assets) or a [CDN](https://stencil.bigcommerce.com/docs/cdn-dir) upload to exclude large static assets. [block:html] { "html": "<!-- * Themes' .zip file names must be restricted to Latin characters (the [ISO-8859-1](http://www.w3schools.com/charsets/ref_html_8859.asp) or 7-bit ASCII character set). Do not include extended-ASCII characters (such as Chinese- or Arabic-language characters). Otherwise, attempts to download the resulting .zip file will trigger an error.\n-->" } [/block] ## <a name="errors"></a> Error Codes If a custom theme upload fails, BigCommerce will display and/or log error codes in the format <span class="inline-code">TR-&lt;code&gt;</span> (where <span class="inline-code">TR</span> is an abbreviation for Theme Registry). Here are the codes and their meanings: [block:html] { "html": "<table>\n <tr>\n <td class=\"\">Error Code</td>\n <td class=\"\">Meaning</td>\n </tr>\n <tr>\n <td class=\"\">TR-100, -101, -700, -1200, -1300</td>\n <td class=\"\">A server error occurred.</td>\n </tr>\n <tr>\n <td class=\"\">TR-200</td>\n <td class=\"\">Problem uploading the theme.</td>\n </tr>\n <tr>\n <td class=\"\">TR-300</td>\n <td class=\"\">Invalid .zip file. (Among other possible root causes, this can indicate an included <span class=\"inline-code\">bundle.js.map</span> source-map file that exceeds its size limit of 5 MB. As a workaround, move this file outside your theme directory before re-running <span class=\"inline-code\">stencil bundle</span>).</td>\n </tr>\n <tr>\n <td class=\"\">TR-301</td>\n <td class=\"\">Failed to unzip file.</td>\n </tr>\n <tr>\n <td class=\"\">TR-400</td>\n <td class=\"\">The .zip contains restricted/invalid file(s) &ndash; e.g., a file with an invalid extension.</td>\n </tr>\n <tr>\n <td class=\"\">TR-500</td>\n <td class=\"\">The .zip file is larger than the 50MB limit.</td>\n </tr>\n <tr>\n <td class=\"\">TR-600</td>\n <td class=\"\">The .zip file is missing a required file (<span class=\"inline-code\">&lt;theme-name&gt;/templates/pages/home.html</span>).</td>\n </tr>\n <tr>\n <td class=\"\">TR-601</td>\n <td class=\"\">The .zip file is missing some parsed template file(s); or, one or more non-<span class=\"inline-code\">.html</span> files are present in the <NOBR><span class=\"inline-code\">&lt;theme-name&gt;/templates/</span></nobr> subdirectory.</td>\n </tr>\n <tr>\n <td class=\"\">TR-800</td>\n <td class=\"\">There was a problem processing the contained <a href=\"/docs/configjson-reference\">config.json</a> file. <br> <b>Please check the <NOBR><a href=\"/docs/configjson-reference\">config.json documentation</a></nobr> for required keys, and for keys that require values.</b></td>\n </tr>\n <tr>\n <td class=\"\">TR-900</td>\n <td class=\"\">The contained config.json file is missing required <a href=\"/docs/configjson-reference#config-theme-meta\">developer information</a>.</td>\n </tr>\n <tr>\n <td class=\"\">TR-901</td>\n <td class=\"\">A <a href=\"/docs/configjson-reference#config-variations\">theme variation</a> defined in the contained config.json file is missing its required external ID.</td>\n </tr>\n <tr>\n <td class=\"\">TR-902</td>\n <td class=\"\">Two or more <a href=\"/docs/configjson-reference#config-variations\">theme variations</a> defined in the contained config.json file share a external ID. <NOBR>All external</nobr> IDs must be unique.</td>\n </tr>\n <tr>\n <td class=\"\">TR-1000</td>\n <td class=\"\">There was a problem processing the contained <a href=\"/docs/schemajson-metadata-for-theme-editor\">schema.json</a> file.</td>\n </tr>\n <tr>\n <td class=\"\">TR-1001</td>\n <td class=\"\">The theme is missing its required <a href=\"/docs/schemajson-metadata-for-theme-editor\">schema.json</a> file.</td>\n </tr>\n <tr>\n <td class=\"\">TR-1400</td>\n <td class=\"\">There was a problem processing template <a href=\"/docs/using-yaml-front-matter\">front matter</a>.</td>\n </tr>\n <tr>\n <td class=\"\">TR-1401</td>\n <td class=\"\">There was a database validation error when saving <a href=\"/docs/using-yaml-front-matter\">front matter</a> to the database.</td>\n </tr>\n <tr>\n <td class=\"\">TR-1500</td>\n <td class=\"\">There was a problem uploading your files, due to multi-threading (multiple simultaneous uploads). Please try again.</td>\n </tr>\n <tr>\n <td class=\"\">TR-1600</td>\n <td class=\"\">There was a temporary problem on our system. Please try again.</td>\n </tr>\n <tr>\n <td class=\"\">TR-1601</td>\n <td class=\"\">There was a problem processing screenshots.</td>\n </tr>\n <tr>\n <td class=\"\">TR-1700, -1800, -1801, -1802, -1803</td>\n <td class=\"\">System error, possibly temporary. Please try again.</td>\n </tr>\n <tr>\n <td class=\"\">TR-3402</td>\n <td class=\"\">You are not allowed to edit your active theme. [Please select <span class=\"inline-code\">Make a Copy</span>, then edit the resulting copy of your theme.]</td>\n </tr>\n <tr>\n <td class=\"\">TR-4400</td>\n <td class=\"\">One or more values in the <span class=\"inline-code\">config.json</span> file exceed the 64-character limit. (Can also indicate string lengths that exceed their limits in other JSON files.)</td>\n </tr>\n </table>\n\n<!-- \n`config.json` > `author_support_url` is a required field. If missing, the upload will fail with something like TR-900, and the theme's author will probably call customer support to ask about it.\n\n`config.json` > `documentation_url` is not a required field. If missing, it will be replaced by [https://stencil.bigcommerce.com/docs/what-is-stencil](this BigCommerce-hosted page).\n\n`config.json` > developer contact info is required. -->" } [/block] ## <a name="warnings"></a> Warnings Warnings will not block a theme's upload, but these onscreen and/or log messages notify you of problems within the zipped theme. Here are the warnings and their meanings: | Warning | |---| | (These messages do not have numeric codes) | | Issue in processing this theme's thumbnail [screenshot](/docs/configjson-reference#config-theme-meta) (<span class="inline-code">composed_image</span>). | | Issue in processing this theme's full-size [screenshot](/docs/configjson-reference#config-var-meta) (<span class="inline-code">desktop_screenshot</span>). | | Issue in processing this theme's mobile [screenshot](/docs/configjson-reference#config-var-meta) (<span class="inline-code">mobile_screenshot</span>). | | Missing file: This theme does not support Theme Editor, as it is missing its required <span class="inline-code">[schema.json](/docs/schemajson-metadata-for-theme-editor)</span> file. | | One or more of this theme's [screenshots](/docs/configjson-reference#config-var-meta) are not image files. | | Theme is missing a valid thumbnail [image](/docs/configjson-reference#config-theme-meta) (<span class="inline-code">composed_image</span>). | | Theme is missing a valid full-size [image](/docs/configjson-reference#config-var-meta) (<span class="inline-code">desktop_screenshot</span>). | | Theme is missing a valid mobile [image](/docs/configjson-reference#config-var-meta) (<span class="inline-code">mobile_screenshot</span>). | | One or more of this theme's [images](/docs/configjson-reference#config-images) is not of a supported file type. Valid filetypes are: .jpg, .jpeg, .png, .gif. | | Thumbnail (<span class="inline-code">composed_image</span>) [image dimensions](/docs/configjson-reference#config-theme-meta) are not right. Expected 600 x 760 pixels. | | Full-size (<span class="inline-code">desktop_screenshot</span>) [image dimensions](/docs/configjson-reference#config-var-meta) are not right. Expected 2048 x 2600 pixels. | | Mobile (<span class="inline-code">mobile_screenshot</span>) [image dimensions](/docs/configjson-reference#config-var-meta) are not right. Expected 304 x 540 pixels. | | Too-large [image file size](/docs/configjson-reference#config-theme-meta) for a theme screenshot [<span class="inline-code">composed_image</span> (thumbnails), <span class="inline-code">desktop_screenshot</span>, or <span class="inline-code">mobile_screenshot</span>] . The maximum supported size is x, but the file's actual size is y. | ## <a name="workarounds"></a> Workarounds and Further Info If a custom theme does not render properly after you upload and apply it to a storefront: Please make sure you have created the theme's .zip file using the <span class="inline-code">[stencil bundle](/docs/bundling-submitting#ship-zip-small)</span> command, on a Mac OS or Linux computer or virtual machine. (This will exclude Windows-specific errors that have occurred on some bundles.) If you repeatedly encounter the same error or warning, and neither this page nor our <a href="https://support.bigcommerce.com/articles/Public/Custom-Theme-Upload" target="_blank">KB</a> resolves the problem: Please&#160;see&#160;support&#160;resources for theme developers [here](https://developer.bigcommerce.com/support/). [block:html] { "html": "<!-- /!\\ Beta Feature\n\nThis feature is currently in beta. Please contact your BigCommerce account manager for details.\n\nSupport resources for BigCommerce store owners are linked from [this&#160;page](https://www.bigcommerce.com/contact/). -->" } [/block]