{"_id":"568b6bd8fe6fcc0d006dc8f7","user":"55a6caa022cfa321008e01d6","__v":26,"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"},"project":"55a6e72e8cc73e0d00096635","parentDoc":null,"category":{"_id":"566a35b81e08750d00a0c49b","__v":2,"version":"55a6e72f8cc73e0d00096638","pages":["566b4ba6f46dc90d009de81f","568aea8fcbd4ca0d00aebfa9"],"project":"55a6e72e8cc73e0d00096635","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-12-11T02:32:24.723Z","from_sync":false,"order":5,"slug":"theme-editor-configuration-reference","title":"Theme/Editor Configuration"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-01-05T07:08:08.804Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":7,"body":"[block:html]\n{\n  \"html\": \"<A NAME=\\\"ThemeEdFAQ\\\"></a> Below are some commonly encountered Theme Editor configuration and testing issues, with suggested resolutions.\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Also Check the Terminal Window\",\n  \"body\": \"For any unexpected behavior that you encounter while developing your Stencil theme, please also check the terminal window where you started Stencil CLI.\\n\\nIn some cases, the terminal will provide a verbose error message specifying where to look for problems. For&#160;less-detailed error messages, we list diagnostic suggestions in this documentation.\"\n}\n[/block]\n\n[block:html]\n{\n  \"html\": \"<h3> Empty Drop-Down List in Theme Editor Panel </h3>\\n<ul>\\n  <li><b>Symptom:</b> A drop-down list's outline appears below its configured label. However, the list appears to <NOBR>be empty.</nobr></li>\\n  <li><b>Likely Cause:</b> A default value specified in the theme's <span class=\\\"inline-code\\\">config.json</span> file is not enumerated in the <NOBR><span class=\\\"inline-code\\\">schema.json</span> file.</nobr></li>\\n  <li><b>Resolution:</b> Update <span class=\\\"inline-code\\\">schema.json</span> to include the <span class=\\\"inline-code\\\">config.json</span> value.</li>\\n</ul>\\n  \\n<h3> Configured Control Missing from Theme Editor Panel </h3>\\n<ul>\\n  <li><b>Symptom:</b> A control that you have configured within <span class=\\\"inline-code\\\">schema.json</span> is completely absent from the <NOBR>Theme Editor</nobr> UI.</li>\\n  <li><b>Likely Cause:</b> The specified <span class=\\\"inline-code\\\">\\\"type\\\"</span> is one of: <span class=\\\"inline-code\\\">text</span>, <span class=\\\"inline-code\\\">text area</span>, <span class=\\\"inline-code\\\">radio</span> [button], or <span class=\\\"inline-code\\\">image</span>.<br>\\n    (Theme Editor does not currently support these data types.)</li>\\n  <li><b>Resolution:</b> Display the user option via one of the supported data types: <span class=\\\"inline-code\\\">color</span>, <span class=\\\"inline-code\\\">font</span>, <NOBR><span class=\\\"inline-code\\\">select</span> [drop-down list],</nobr> or <span class=\\\"inline-code\\\">checkbox</span>.</li>\\n</ul>\\n  \\n<h3> Theme Changes Not Saved from Theme Editor UI </h3>\\n<ul>\\n  <li><b>Symptom:</b> Changes saved in a browser's Theme Editor panel are not reflected in the storefront.</li>\\n  <li><b>Likely Cause:</b> Check whether multiple users are simultaneously using Theme Editor to customize the same storefront.</li>\\n  <li><b>Resolution:</b> We strongly recommend opening only one instance of Theme Editor, at a time, per storefront. \\nBigCommerce currently provides no synchronization mechanism for configuration changes from multiple Theme Editor instances. So the storefront's <span class=\\\"inline-code\\\">schema.json</span> will record the last changes made by any instance <NOBR>&ndash; but</span> changes saved earlier by other instances might be lost.</li>\\n</ul>\"\n}\n[/block]","excerpt":"","slug":"theme-editor-configuration-faq","type":"basic","title":"Theme Editor Troubleshooting"}

Theme Editor Troubleshooting


[block:html] { "html": "<A NAME=\"ThemeEdFAQ\"></a> Below are some commonly encountered Theme Editor configuration and testing issues, with suggested resolutions." } [/block] [block:callout] { "type": "info", "title": "Also Check the Terminal Window", "body": "For any unexpected behavior that you encounter while developing your Stencil theme, please also check the terminal window where you started Stencil CLI.\n\nIn some cases, the terminal will provide a verbose error message specifying where to look for problems. For&#160;less-detailed error messages, we list diagnostic suggestions in this documentation." } [/block] [block:html] { "html": "<h3> Empty Drop-Down List in Theme Editor Panel </h3>\n<ul>\n <li><b>Symptom:</b> A drop-down list's outline appears below its configured label. However, the list appears to <NOBR>be empty.</nobr></li>\n <li><b>Likely Cause:</b> A default value specified in the theme's <span class=\"inline-code\">config.json</span> file is not enumerated in the <NOBR><span class=\"inline-code\">schema.json</span> file.</nobr></li>\n <li><b>Resolution:</b> Update <span class=\"inline-code\">schema.json</span> to include the <span class=\"inline-code\">config.json</span> value.</li>\n</ul>\n \n<h3> Configured Control Missing from Theme Editor Panel </h3>\n<ul>\n <li><b>Symptom:</b> A control that you have configured within <span class=\"inline-code\">schema.json</span> is completely absent from the <NOBR>Theme Editor</nobr> UI.</li>\n <li><b>Likely Cause:</b> The specified <span class=\"inline-code\">\"type\"</span> is one of: <span class=\"inline-code\">text</span>, <span class=\"inline-code\">text area</span>, <span class=\"inline-code\">radio</span> [button], or <span class=\"inline-code\">image</span>.<br>\n (Theme Editor does not currently support these data types.)</li>\n <li><b>Resolution:</b> Display the user option via one of the supported data types: <span class=\"inline-code\">color</span>, <span class=\"inline-code\">font</span>, <NOBR><span class=\"inline-code\">select</span> [drop-down list],</nobr> or <span class=\"inline-code\">checkbox</span>.</li>\n</ul>\n \n<h3> Theme Changes Not Saved from Theme Editor UI </h3>\n<ul>\n <li><b>Symptom:</b> Changes saved in a browser's Theme Editor panel are not reflected in the storefront.</li>\n <li><b>Likely Cause:</b> Check whether multiple users are simultaneously using Theme Editor to customize the same storefront.</li>\n <li><b>Resolution:</b> We strongly recommend opening only one instance of Theme Editor, at a time, per storefront. \nBigCommerce currently provides no synchronization mechanism for configuration changes from multiple Theme Editor instances. So the storefront's <span class=\"inline-code\">schema.json</span> will record the last changes made by any instance <NOBR>&ndash; but</span> changes saved earlier by other instances might be lost.</li>\n</ul>" } [/block]