{"_id":"57d3433257a8572000c4f28f","parentDoc":null,"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"},"__v":0,"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"},"user":"55a6caa022cfa321008e01d6","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-09-09T23:18:10.108Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":9,"body":"[block:html]\n{\n  \"html\": \"The Stencil framework supports two theme-update scenarios, in different ways:\\n\\n<ul>\\n <li><a href=\\\"#Conserved\\\"> Custom Templates Conserved </a>\\n  </li>\\n <li><a href=\\\"#Withdrawn\\\"> Custom Template Withdrawn </a>\\n  </li> \\n</ul><p></p>\\n\\n<h2> <a name=\\\"Conserved\\\"></a> Custom Templates Conserved </h2> \\n\\nWhen a merchant updates a Stencil theme to a new version, BigCommerce will retain any mappings of custom templates to store pages, as long as the new version contains custom templates of the same names.<br><p></p>\\n\\n<h2> <a name=\\\"Withdrawn\\\"></a> Custom Template Withdrawn </h2> \\n\\nWhere a theme developer removes a custom template that a merchant has previously applied to store pages, <!--updates within the same theme will work like switches among different Stencil themes:<br><p></p> \\nWhen the merchant upgrades to the theme's next version,--> BigCommerce will apply the new theme's <i>default</i> template to affected store pages.\\n<!-- (Forthcoming is a control-panel warning about this, offering merchants the opportunity to select a different custom template. This will work the same way as described above for switching between <i>different</i> Stencil themes. But as of 6/17/16, this fallback is silent.) -->\"\n}\n[/block]","excerpt":"","slug":"theme-updates-with-custom-templates","type":"basic","title":"Theme Updates with Custom Templates"}

Theme Updates with Custom Templates


[block:html] { "html": "The Stencil framework supports two theme-update scenarios, in different ways:\n\n<ul>\n <li><a href=\"#Conserved\"> Custom Templates Conserved </a>\n </li>\n <li><a href=\"#Withdrawn\"> Custom Template Withdrawn </a>\n </li> \n</ul><p></p>\n\n<h2> <a name=\"Conserved\"></a> Custom Templates Conserved </h2> \n\nWhen a merchant updates a Stencil theme to a new version, BigCommerce will retain any mappings of custom templates to store pages, as long as the new version contains custom templates of the same names.<br><p></p>\n\n<h2> <a name=\"Withdrawn\"></a> Custom Template Withdrawn </h2> \n\nWhere a theme developer removes a custom template that a merchant has previously applied to store pages, <!--updates within the same theme will work like switches among different Stencil themes:<br><p></p> \nWhen the merchant upgrades to the theme's next version,--> BigCommerce will apply the new theme's <i>default</i> template to affected store pages.\n<!-- (Forthcoming is a control-panel warning about this, offering merchants the opportunity to select a different custom template. This will work the same way as described above for switching between <i>different</i> Stencil themes. But as of 6/17/16, this fallback is silent.) -->" } [/block]