{"_id":"560b5d62af40a70d003df332","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"},"user":"55a6caa022cfa321008e01d6","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"},"parentDoc":null,"__v":7,"updates":["56180bdf8213e91700a0a0f2"],"next":{"pages":[],"description":""},"createdAt":"2015-09-30T03:56:18.252Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":3,"body":"[block:html]\n{\n  \"html\": \"<A NAME=\\\"Pages-Subdir\\\"></a>The <span class=\\\"inline-code\\\">.../templates/pages/</span> subdirectory contains the complete set of base template pages used to construct a BigCommerce online store. These pages call resources from the <span class=\\\"inline-code\\\">.../templates/components/</span> and <NOBR><span class=\\\"inline-code\\\">.../templates/layout/</span></nobr> subdirectories.\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"Pages in the <span class=\\\"inline-code\\\">.../templates/pages/</span> subdirectory are the only place you can insert and modify \\n<a href=\\\"/docs/using-yaml-front-matter\\\">YAML front-matter</a> <a href=\\\"/docs/front-matter-variables\\\">attributes</a> to customize the rendered storefront.\",\n  \"title\": \"Front-Matter Restriction\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"Do not change the names of the <span class=\\\"inline-code\\\">.../templates/pages/</span> subdirectory or its contained files.\\nThese default names are required for the storefront to compile properly. You can, however, edit pages’ front‑matter and Handlebars resources to customize the storefront theme’s look and function.\",\n  \"title\": \"Naming Requirements\"\n}\n[/block]\n\n[block:html]\n{\n  \"html\": \"Children of this subdirectory group together pages that serve a particular storefront function:<br>\\n\\n<p></p><pre>&lt;theme-name&gt;\\n└── templates\\n  └── pages\\n      ├── account\\n      │   └── orders\\n      ├── auth\\n      ├── errors\\n      ├── gift-certificate\\n      ├── newsletter\\n      └── unavailable</pre><br>\\n\\nFor example, here are the contents of the <span class=\\\"inline-code\\\">.../errors/</span> and <span class=\\\"inline-code\\\">.../gift-certificate/</span> subdirectories:<br>\\n\\n<p></p><pre>&lt;theme-name&gt;\\n└── templates\\n  └── pages\\n      ├── errors\\n      │   ├── 403.html\\n      │   ├── 404.html\\n      │   ├── 500.html\\n      │   └── generic.html\\n      ├── gift-certificate\\n      │   ├── balance.html\\n      │   ├── purchase.html\\n      │   └── redeem.html</pre><br>\\n\\n\\nThe subdirectory’s remaining contents are single-purpose pages:<br>\\n\\n<p></p><pre>&lt;theme-name&gt;\\n└── templates\\n  └── pages\\n      ├── blog-post.html\\n      ├── blog.html\\n      ├── brand.html\\n      ├── brands.html\\n      ├── cart.html\\n      ├── category.html\\n      ├── checkout.html\\n      ├── compare.html\\n      ├── contact-us.html\\n      ├── home.html\\n      ├── newsletter\\n      ├── order-complete.html\\n      ├── page.html\\n      ├── product.html\\n      ├── search.html\\n      ├── sitemap.html</pre>\"\n}\n[/block]","excerpt":"(Front Matter and Rendered Pages)","slug":"pages-subdirectory","type":"basic","title":"Pages Subdirectory"}

Pages Subdirectory

(Front Matter and Rendered Pages)

[block:html] { "html": "<A NAME=\"Pages-Subdir\"></a>The <span class=\"inline-code\">.../templates/pages/</span> subdirectory contains the complete set of base template pages used to construct a BigCommerce online store. These pages call resources from the <span class=\"inline-code\">.../templates/components/</span> and <NOBR><span class=\"inline-code\">.../templates/layout/</span></nobr> subdirectories." } [/block] [block:callout] { "type": "info", "body": "Pages in the <span class=\"inline-code\">.../templates/pages/</span> subdirectory are the only place you can insert and modify \n<a href=\"/docs/using-yaml-front-matter\">YAML front-matter</a> <a href=\"/docs/front-matter-variables\">attributes</a> to customize the rendered storefront.", "title": "Front-Matter Restriction" } [/block] [block:callout] { "type": "warning", "body": "Do not change the names of the <span class=\"inline-code\">.../templates/pages/</span> subdirectory or its contained files.\nThese default names are required for the storefront to compile properly. You can, however, edit pages’ front‑matter and Handlebars resources to customize the storefront theme’s look and function.", "title": "Naming Requirements" } [/block] [block:html] { "html": "Children of this subdirectory group together pages that serve a particular storefront function:<br>\n\n<p></p><pre>&lt;theme-name&gt;\n└── templates\n └── pages\n ├── account\n │ └── orders\n ├── auth\n ├── errors\n ├── gift-certificate\n ├── newsletter\n └── unavailable</pre><br>\n\nFor example, here are the contents of the <span class=\"inline-code\">.../errors/</span> and <span class=\"inline-code\">.../gift-certificate/</span> subdirectories:<br>\n\n<p></p><pre>&lt;theme-name&gt;\n└── templates\n └── pages\n ├── errors\n │ ├── 403.html\n │ ├── 404.html\n │ ├── 500.html\n │ └── generic.html\n ├── gift-certificate\n │ ├── balance.html\n │ ├── purchase.html\n │ └── redeem.html</pre><br>\n\n\nThe subdirectory’s remaining contents are single-purpose pages:<br>\n\n<p></p><pre>&lt;theme-name&gt;\n└── templates\n └── pages\n ├── blog-post.html\n ├── blog.html\n ├── brand.html\n ├── brands.html\n ├── cart.html\n ├── category.html\n ├── checkout.html\n ├── compare.html\n ├── contact-us.html\n ├── home.html\n ├── newsletter\n ├── order-complete.html\n ├── page.html\n ├── product.html\n ├── search.html\n ├── sitemap.html</pre>" } [/block]