{"_id":"590291cc06f90c230056e167","__v":0,"user":"55a6caa022cfa321008e01d6","parentDoc":null,"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"},"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"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-04-28T00:50:20.717Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":13,"body":"To prepare your Stencil theme to support BigCommerce's [Optimized One-Page Checkout](https://support.bigcommerce.com/articles/Public/Optimized-Single-Page-Checkout) option, use the following steps:\n\n1. Update your Stencil CLI installation to the most-recent version, as outlined [here](/docs/installing-stencil-cli-1).\n\n2. Enable Optimized One-Page Checkout in the store's control panel, as shown below. (For details, see [this&#160;support article](https://support.bigcommerce.com/articles/Public/Checkout-Settings).)\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/5fff62c-One-Pg-Checkout-selection.png\",\n        \"One-Pg-Checkout-selection.png\",\n        585,\n        150,\n        \"#c8c9d1\"\n      ],\n      \"caption\": \"\",\n      \"sizing\": \"smart\",\n      \"border\": true\n    }\n  ]\n}\n[/block]\n3. Within your theme's [`config.json` file >  `meta` section](/docs/configjson-reference#config-theme-meta), make sure the `features` array includes the value `customized_checkout`, as shown below:\n\n    ```\n      \"meta\": {\n        [...]\n        \"features\": [\n          [...]\n          \"customized_checkout\"\n    ```\n\n4. Within your theme's `<theme-name>/templates/pages/` subdirectory, refresh the `checkout.html` and \n`order-confirmation.html` files. \n\n    ([Download a current version](/docs/downloading-and-refreshing-cornerstone) of Stencil's Cornerstone reference theme, and extract at least those two templates.)\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"body\": \"For Optimized One-Page Checkout to work properly, the `order-confirmation.html` template must be present in your theme. If this template is absent, shoppers will receive a server error upon submitting their order.\\n\\n(The corresponding template was named `order-complete.html` in earlier versions of Stencil themes. But that minimal template is not a substitute for the required current template.)\",\n  \"title\": \"Order Confirmation Template Is Mandatory\"\n}\n[/block]","excerpt":"","slug":"optimized-checkout-prereqs","type":"basic","title":"Preparing Stencil Themes for Optimized One-Page Checkout"}

Preparing Stencil Themes for Optimized One-Page Checkout


To prepare your Stencil theme to support BigCommerce's [Optimized One-Page Checkout](https://support.bigcommerce.com/articles/Public/Optimized-Single-Page-Checkout) option, use the following steps: 1. Update your Stencil CLI installation to the most-recent version, as outlined [here](/docs/installing-stencil-cli-1). 2. Enable Optimized One-Page Checkout in the store's control panel, as shown below. (For details, see [this&#160;support article](https://support.bigcommerce.com/articles/Public/Checkout-Settings).) [block:image] { "images": [ { "image": [ "https://files.readme.io/5fff62c-One-Pg-Checkout-selection.png", "One-Pg-Checkout-selection.png", 585, 150, "#c8c9d1" ], "caption": "", "sizing": "smart", "border": true } ] } [/block] 3. Within your theme's [`config.json` file > `meta` section](/docs/configjson-reference#config-theme-meta), make sure the `features` array includes the value `customized_checkout`, as shown below: ``` "meta": { [...] "features": [ [...] "customized_checkout" ``` 4. Within your theme's `<theme-name>/templates/pages/` subdirectory, refresh the `checkout.html` and `order-confirmation.html` files. ([Download a current version](/docs/downloading-and-refreshing-cornerstone) of Stencil's Cornerstone reference theme, and extract at least those two templates.) [block:callout] { "type": "danger", "body": "For Optimized One-Page Checkout to work properly, the `order-confirmation.html` template must be present in your theme. If this template is absent, shoppers will receive a server error upon submitting their order.\n\n(The corresponding template was named `order-complete.html` in earlier versions of Stencil themes. But that minimal template is not a substitute for the required current template.)", "title": "Order Confirmation Template Is Mandatory" } [/block]