{"_id":"570ece8ca38d470e0060c9e8","__v":167,"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","category":{"_id":"560b5cbec341310d00de2a01","pages":["560b5d0b3616ac17004f1c99","560b5d405148ba0d009bd0c9","560b5d62af40a70d003df332","560b5d953bcbd80d0077d0fd","560b5fa83616ac17004f1c9d","569c8c15d326c80d0068f7b7","56d37d35d3f4650b007495ea","56d4ed5f8001e30b0089700c"],"__v":8,"project":"55a6e72e8cc73e0d00096635","version":"55a6e72f8cc73e0d00096638","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-09-30T03:53:34.449Z","from_sync":false,"order":14,"slug":"templates-required-directory","title":"Templates Reference"},"parentDoc":null,"user":"55a6caa022cfa321008e01d6","updates":["589c75d60552cc2f00a61d41"],"next":{"pages":[],"description":""},"createdAt":"2016-04-13T22:56:12.750Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":5,"body":"[block:html]\n{\n  \"html\": \"This page covers:\\n\\n<ul>\\n <li><a href=\\\"#About\\\"> About Custom Templates </a></li>\\n <li><a href=\\\"#WhatsNew\\\"> Stencil versus Blueprint Themes </a></li>\\n <li><a href=\\\"#Video\\\"> Video Demo </a></li>\\n</ul>\\n<p></p>\\n\\nThis subsection's remaining entries cover:\\n\\n<ul> <!--outer-->\\n\\t<li><a href=\\\"/docs/authoring-custom-templates\\\"> Authoring, Testing, and Uploading Custom Templates </a></li>\\n\\n  <!-- inner <ul>\\n\\t\\t\\t<li><a href=\\\"/docs/authoring-custom-templates#Test\\\"> Local Mapping and Testing</a></li> \\n      <li><a href=\\\"/docs/authoring-custom-templates#Submit\\\"> Theme Submission</a></li>\\n  \\t\\t<li><a href=\\\"/docs/authoring-custom-templates#Trouble\\\"> Troubleshooting Template Assignments</a></li>\\n  </ul><p></p> inner -->\\n\\n\\t<li><a href=\\\"/docs/assigning-templates-to-pages\\\"> Assigning Templates to Pages</a></li> <!--outer-->\\n</li> <!--outer-->\\n\\t<li><a href=\\\"/docs/switching-themes-with-custom-templates\\\"> Switching Themes with Custom Templates </a></li>\\n\\t<li><a href=\\\"/docs/theme-updates-with-custom-templates\\\"> Theme Updates with Custom Templates </a></li>\\n\\t<li><a href=\\\"/docs/limitations-on-custom-templates\\\"> Limitations on Custom Templates </a></li>\\n</ul> <!--outer-->\\n<p></p>\\n\\n<h2> <A NAME=\\\"About\\\"></a> About Custom Templates </h2>\\n\\nThe Stencil framework allows theme developers and merchants to assign custom layout templates to storefront pages of the following types:\\n\\n<ul>\\n <li>Brand</li>\\n <li>Category</li>\\n <li>Product</a></li>\\n <li>Page (meaning \\\"Web Pages\\\" &ndash; the BigCommerce control panel's designation for static store pages, which can include the store's home page)</li>\\n</ul>\\n<p></p>\\n\\n\\n<h2> <A NAME=\\\"WhatsNew\\\"></a> Stencil versus Blueprint Themes </h2>\\n\\nIf you are migrating from BigCommerce's legacy Blueprint themes framework, please keep in mind these differences in how Stencil handles custom templates:\\n\\n<ul>\\n <li>The brand option is entirely new in Stencil. Blueprint themes do not allow creating custom templates for brand pages.\\n   <p></p></li>\\n <!-- <li>Also new on the Stencil framework are theme-specific assignments of templates to storefront pages. Blueprint maintains one set of mappings for all Blueprint themes.\\n  <p></p></li> -->\\n  <li>Unlike Blueprint, Stencil does not require custom templates' file names to start with an underscore (_). <NOBR>So in the</nobr> <a href=\\\"/docs/authoring-and-assigning-custom-templates#Test\\\">Local Testing</a> example later in this section, <span class=\\\"inline-code\\\">alternate-product.html</span> is a valid Stencil file name.\\n   <p></p></li>\\n <li>In the current Stencil release, custom templates must be created and bundled using Stencil CLI before they are uploaded to stores. However, once templates have been created, authorized users can <a href=\\\"/docs/assigning-templates-to-pages#Map\\\">assign</a> them to storefront pages through the control panel.\\n  <p></p></li>\\n</ul>\\n\\n\\n<h2> <a name=\\\"Video\\\"></a> Video Demo </h2>\\n\\nWatch a video demonstration of the full process of configuring custom layout templates: <br><p></p>\\n\\n<iframe src=\\\"https://www.youtube.com/embed/qgaDX7bhmd8?ecver=2\\\" width=\\\"560\\\" height=\\\"315\\\" frameborder=\\\"0\\\" allowfullscreen></iframe>\"\n}\n[/block]","excerpt":"","slug":"custom-layout-templates","type":"basic","title":"Custom Templates"}
[block:html] { "html": "This page covers:\n\n<ul>\n <li><a href=\"#About\"> About Custom Templates </a></li>\n <li><a href=\"#WhatsNew\"> Stencil versus Blueprint Themes </a></li>\n <li><a href=\"#Video\"> Video Demo </a></li>\n</ul>\n<p></p>\n\nThis subsection's remaining entries cover:\n\n<ul> <!--outer-->\n\t<li><a href=\"/docs/authoring-custom-templates\"> Authoring, Testing, and Uploading Custom Templates </a></li>\n\n <!-- inner <ul>\n\t\t\t<li><a href=\"/docs/authoring-custom-templates#Test\"> Local Mapping and Testing</a></li> \n <li><a href=\"/docs/authoring-custom-templates#Submit\"> Theme Submission</a></li>\n \t\t<li><a href=\"/docs/authoring-custom-templates#Trouble\"> Troubleshooting Template Assignments</a></li>\n </ul><p></p> inner -->\n\n\t<li><a href=\"/docs/assigning-templates-to-pages\"> Assigning Templates to Pages</a></li> <!--outer-->\n</li> <!--outer-->\n\t<li><a href=\"/docs/switching-themes-with-custom-templates\"> Switching Themes with Custom Templates </a></li>\n\t<li><a href=\"/docs/theme-updates-with-custom-templates\"> Theme Updates with Custom Templates </a></li>\n\t<li><a href=\"/docs/limitations-on-custom-templates\"> Limitations on Custom Templates </a></li>\n</ul> <!--outer-->\n<p></p>\n\n<h2> <A NAME=\"About\"></a> About Custom Templates </h2>\n\nThe Stencil framework allows theme developers and merchants to assign custom layout templates to storefront pages of the following types:\n\n<ul>\n <li>Brand</li>\n <li>Category</li>\n <li>Product</a></li>\n <li>Page (meaning \"Web Pages\" &ndash; the BigCommerce control panel's designation for static store pages, which can include the store's home page)</li>\n</ul>\n<p></p>\n\n\n<h2> <A NAME=\"WhatsNew\"></a> Stencil versus Blueprint Themes </h2>\n\nIf you are migrating from BigCommerce's legacy Blueprint themes framework, please keep in mind these differences in how Stencil handles custom templates:\n\n<ul>\n <li>The brand option is entirely new in Stencil. Blueprint themes do not allow creating custom templates for brand pages.\n <p></p></li>\n <!-- <li>Also new on the Stencil framework are theme-specific assignments of templates to storefront pages. Blueprint maintains one set of mappings for all Blueprint themes.\n <p></p></li> -->\n <li>Unlike Blueprint, Stencil does not require custom templates' file names to start with an underscore (_). <NOBR>So in the</nobr> <a href=\"/docs/authoring-and-assigning-custom-templates#Test\">Local Testing</a> example later in this section, <span class=\"inline-code\">alternate-product.html</span> is a valid Stencil file name.\n <p></p></li>\n <li>In the current Stencil release, custom templates must be created and bundled using Stencil CLI before they are uploaded to stores. However, once templates have been created, authorized users can <a href=\"/docs/assigning-templates-to-pages#Map\">assign</a> them to storefront pages through the control panel.\n <p></p></li>\n</ul>\n\n\n<h2> <a name=\"Video\"></a> Video Demo </h2>\n\nWatch a video demonstration of the full process of configuring custom layout templates: <br><p></p>\n\n<iframe src=\"https://www.youtube.com/embed/qgaDX7bhmd8?ecver=2\" width=\"560\" height=\"315\" frameborder=\"0\" allowfullscreen></iframe>" } [/block]