{"_id":"57d32c922239653600498bf7","parentDoc":null,"__v":1,"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"},"user":"55a6caa022cfa321008e01d6","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"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-09-09T21:41:38.198Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":7,"body":"The steps on this page are performed by the merchant or other authorized store user:\n  * [Assigning a Web Page Template](#section-assigning-a-web-page-template)\n  * [Assigning a Product, Brand, or Category Template](#section-assigning-a-product-brand-or-category-template)\n  * [Troubleshooting Template Assignments](#section-troubleshooting-template-assignments)\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"If you are developing a theme for your own store, the \\\"merchant\\\"/\\\"authorized store user\\\" role mentioned throughout these instructions overlaps with your developer role.\",\n  \"title\": \"In-House Developers\"\n}\n[/block]\n\n[block:html]\n{\n  \"html\": \"Once the developer has submitted the theme to BigCommerce, the merchant (or other authorized store user) can assign custom templates to individual store pages. The&#160;steps are similar whether assigning brands, categories, products, and static Web pages – with slight differences. Below, we show examples for assigning a Web Page and a Category. For further details, please see <a href=\\\"https://support.bigcommerce.com/articles/Public/Creating-Custom-Template-Files#assigning\\\">this Knowledge Base article</a>.\\n\\n<!-- S/he would do so as follows, starting from the BigCommerce control panel's left navigation pane:\\n1. To assign a \\\"Web Page\\\" template, select `Storefront Content` > `Web Pages`. Otherwise, select `Products` > `View` (for a product page) `Products` > `Product Categories`  (for a category page), or `Products` > `Brands` (for a brand page).\\n3. To the right of the Web Page where you want to assign a custom template, select the `Action` [`...`] button, then select `Edit` from the resulting context menu.\\n4. Scroll to the `Template Layout File` drop-down menu, and select your desired custom template from that menu, as shown below. \\n5. Click the `Save & Exit` or `Save & Keep Editing` button at the lower right.-->\"\n}\n[/block]\n## Assigning a Web Page Template\n\nStarting from the BigCommerce control panel's left navigation pane:\n\n1. Select `Storefront Content` > `Web Pages`.\n2. From the resulting `View Web Pages` display, select the existing Page Name to which you want to assign a custom template. (Or select `Create a Web Page` to define a new page.)\n3. From the resulting `Edit a Web Page` display, scroll down to the `Template Layout File` drop-down list. Then&#160;select your desired custom template from that list, as shown below. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/82420f7-cus_templ_page.png\",\n        \"cus_templ_page.png\",\n        646,\n        181,\n        \"#e3d9c3\"\n      ]\n    }\n  ]\n}\n[/block]\n4. Click the `Save & Exit` or `Save & Keep Editing` button at the lower right.\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"Some static page types do not allow you to assign custom templates. You can recognize these excluded pages because their  `Edit a Web Page` display will not include a `Template Layout File` drop-down list.\",\n  \"title\": \"Static Pages You Can't Assign\"\n}\n[/block]\n## Assigning a Product, Brand, or Category Template\n\nStarting from the BigCommerce control panel's left navigation pane:\n\n1. Select `Products` > `View` (for a product page) `Products` > `Product Categories` (for a category page), or `Products` > `Brands` (for a brand page).\n2. Select the Product Name, Category Name, or Brand Name to which you want to assign a custom template. (Or select the `Add` or `Create` button at the upper left to define a new product, category, or band.)\n3. For a product page (only), you must select the `Other Details` tab to proceed to the next step.\n4. Scroll to the `Template Layout File` drop-down list, and select your desired custom template from that list, as shown below for a Category assignment.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/42788c8-cus_templ_categories.png\",\n        \"cus_templ_categories.png\",\n        594,\n        191,\n        \"#ded1bd\"\n      ]\n    }\n  ]\n}\n[/block]\n5. Click the `Save & Exit` or `Save & Keep Editing` button at the lower right.\n\n## Troubleshooting Template Assignments\n[block:html]\n{\n  \"html\": \"In case of problems a custom template in the control panel: Check whether your theme's root directory contains a file named <span class=\\\"inline-code\\\">manifest.json</span>.<br><p></p> \\n\\nIf so, delete the <span class=\\\"inline-code\\\">manifest.json</span> file, then again <a href=\\\"/docs/bundling-submitting#ship-zip-small\\\">bundle</a>, upload, and apply the theme. This should enable assigning the template in the control panel.\\n\\n<!-- <h2> <A NAME=\\\"Trouble\\\"></a> Developers: Troubleshooting Template Assignments</h2>\\n\\nIn case of problems <a href=\\\"/docs/assigning-templates-to-pages\\\">assigning</a> a custom template in the control panel: Check whether your theme's root directory contains a file named <span class=\\\"inline-code\\\">manifest.json</span>.<br><p></p> \\n\\nIf so, delete the <span class=\\\"inline-code\\\">manifest.json</span> file, then again <a href=\\\"/docs/bundling-submitting#ship-zip-small\\\">bundle</a>, upload, and apply the theme. This should enable assigning the template in the control panel. -->\"\n}\n[/block]","excerpt":"","slug":"assigning-templates-to-pages","type":"basic","title":"Assigning Templates to Pages"}

Assigning Templates to Pages


The steps on this page are performed by the merchant or other authorized store user: * [Assigning a Web Page Template](#section-assigning-a-web-page-template) * [Assigning a Product, Brand, or Category Template](#section-assigning-a-product-brand-or-category-template) * [Troubleshooting Template Assignments](#section-troubleshooting-template-assignments) [block:callout] { "type": "info", "body": "If you are developing a theme for your own store, the \"merchant\"/\"authorized store user\" role mentioned throughout these instructions overlaps with your developer role.", "title": "In-House Developers" } [/block] [block:html] { "html": "Once the developer has submitted the theme to BigCommerce, the merchant (or other authorized store user) can assign custom templates to individual store pages. The&#160;steps are similar whether assigning brands, categories, products, and static Web pages – with slight differences. Below, we show examples for assigning a Web Page and a Category. For further details, please see <a href=\"https://support.bigcommerce.com/articles/Public/Creating-Custom-Template-Files#assigning\">this Knowledge Base article</a>.\n\n<!-- S/he would do so as follows, starting from the BigCommerce control panel's left navigation pane:\n1. To assign a \"Web Page\" template, select `Storefront Content` > `Web Pages`. Otherwise, select `Products` > `View` (for a product page) `Products` > `Product Categories` (for a category page), or `Products` > `Brands` (for a brand page).\n3. To the right of the Web Page where you want to assign a custom template, select the `Action` [`...`] button, then select `Edit` from the resulting context menu.\n4. Scroll to the `Template Layout File` drop-down menu, and select your desired custom template from that menu, as shown below. \n5. Click the `Save & Exit` or `Save & Keep Editing` button at the lower right.-->" } [/block] ## Assigning a Web Page Template Starting from the BigCommerce control panel's left navigation pane: 1. Select `Storefront Content` > `Web Pages`. 2. From the resulting `View Web Pages` display, select the existing Page Name to which you want to assign a custom template. (Or select `Create a Web Page` to define a new page.) 3. From the resulting `Edit a Web Page` display, scroll down to the `Template Layout File` drop-down list. Then&#160;select your desired custom template from that list, as shown below. [block:image] { "images": [ { "image": [ "https://files.readme.io/82420f7-cus_templ_page.png", "cus_templ_page.png", 646, 181, "#e3d9c3" ] } ] } [/block] 4. Click the `Save & Exit` or `Save & Keep Editing` button at the lower right. [block:callout] { "type": "warning", "body": "Some static page types do not allow you to assign custom templates. You can recognize these excluded pages because their `Edit a Web Page` display will not include a `Template Layout File` drop-down list.", "title": "Static Pages You Can't Assign" } [/block] ## Assigning a Product, Brand, or Category Template Starting from the BigCommerce control panel's left navigation pane: 1. Select `Products` > `View` (for a product page) `Products` > `Product Categories` (for a category page), or `Products` > `Brands` (for a brand page). 2. Select the Product Name, Category Name, or Brand Name to which you want to assign a custom template. (Or select the `Add` or `Create` button at the upper left to define a new product, category, or band.) 3. For a product page (only), you must select the `Other Details` tab to proceed to the next step. 4. Scroll to the `Template Layout File` drop-down list, and select your desired custom template from that list, as shown below for a Category assignment. [block:image] { "images": [ { "image": [ "https://files.readme.io/42788c8-cus_templ_categories.png", "cus_templ_categories.png", 594, 191, "#ded1bd" ] } ] } [/block] 5. Click the `Save & Exit` or `Save & Keep Editing` button at the lower right. ## Troubleshooting Template Assignments [block:html] { "html": "In case of problems a custom template in the control panel: Check whether your theme's root directory contains a file named <span class=\"inline-code\">manifest.json</span>.<br><p></p> \n\nIf so, delete the <span class=\"inline-code\">manifest.json</span> file, then again <a href=\"/docs/bundling-submitting#ship-zip-small\">bundle</a>, upload, and apply the theme. This should enable assigning the template in the control panel.\n\n<!-- <h2> <A NAME=\"Trouble\"></a> Developers: Troubleshooting Template Assignments</h2>\n\nIn case of problems <a href=\"/docs/assigning-templates-to-pages\">assigning</a> a custom template in the control panel: Check whether your theme's root directory contains a file named <span class=\"inline-code\">manifest.json</span>.<br><p></p> \n\nIf so, delete the <span class=\"inline-code\">manifest.json</span> file, then again <a href=\"/docs/bundling-submitting#ship-zip-small\">bundle</a>, upload, and apply the theme. This should enable assigning the template in the control panel. -->" } [/block]