{"_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 that custom templates' file names 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, you must create and bundle custom templates using Stencil CLI before you can upload them to stores. However, once you have created and uploaded templates, authorized store 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 that custom templates' file names 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, you must create and bundle custom templates using Stencil CLI before you can upload them to stores. However, once you have created and uploaded templates, authorized store 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]