{"_id":"56b254f41bc8490d00701f77","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,"project":"55a6e72e8cc73e0d00096635","user":"55a6caa022cfa321008e01d6","__v":264,"category":{"_id":"56b254dc65ddf50d0076ba8f","pages":["56b254f41bc8490d00701f77","56f0494fb0fa4d2000067eb6"],"project":"55a6e72e8cc73e0d00096635","__v":2,"version":"55a6e72f8cc73e0d00096638","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-02-03T19:28:28.808Z","from_sync":false,"order":17,"slug":"release-notes","title":"Release Notes"},"updates":["56e9b1568e75a02200fb3da0","57a4b2791c5d931900eb2a2f"],"next":{"pages":[],"description":""},"createdAt":"2016-02-03T19:28:52.814Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"[block:html]\n{\n  \"html\": \"<!-- PENDING FOR CORNERSTONE 1.9.1:\\nFoundation/Citadel fix, via PR. See 1.9.x notes.\\n\\nCorrect `{{template_file}}` glitches:\\n  Roll back https://github.com/bigcommerce/cornerstone/pull/1032:\\nhttps://github.com/bigcommerce/cornerstone/pull/1049/files\\n\\nhttps://jira.bigcommerce.com/browse/STENCIL-2922\\n  ^ Fix issue of JavaScript not running on custom template pages, by changing Cornerstone to use `page_type` instead of `template_file`\\\\/ \\nhttps://github.com/bigcommerce/cornerstone/pull/1050\\n-->\\n\\n<!-- BYPASSED:\\n<b>2017-04-25:</b> We have upgraded Cornerstone's [Citadel](/docs/componentsdesign-patterns#Patterns) SCSS pattern library to version 2.15.1. This upgrade corrects the conditional import of the Clear Sans Web font, and corrects the behavior of active tabs. (PR #999, commit # 562bdf6)\\n\\nExperimental fix for using the API to assign custom template files to products on Stencil stores. (https://jira.bigcommerce.com/browse/STENCIL-2999)\\n\\n<b>2017-02-03:</b> Theme Editor in Stencil CLI updated, was outdated. (STENCIL-2489)\\n\\n<b>2017-02-03:</b> Resizing elements didn't work in Theme Editor after save. (STENCIL-2971)\\n\\n<b>2017-01-30:</b> We have updated Stencil's [Citadel pattern library](/docs/componentsdesign-patterns#Patterns) to remove warnings that were previously present about utility classes. (UI-143)\\n\\nDuplicate title tags on multiple pages (https://jira.bigcommerce.com/browse/STENCIL-2463)\\n\\n[SEO] Canonical tags for category pages not pointing to first page of results (https://jira.bigcommerce.com/browse/BIG-29031)\\n\\nSpam, spam (STENCIL-2475)\\n\\nSKIP, KB ONLY (Stencil-2514): <b>2017-01-06:</b> Within the Edit Theme Files editor, using a Search keyboard shortcut (Cmd-F or Ctrl-F) now properly opens the Search box on each edited file. The Search box supports regular expressions, case-sensitive search, and whole-word search. (https://jira.bigcommerce.com/browse/STENCIL-2783)\\n\\nSKIP: <b>2017-01-06:</b> Fixed a bug that prevented storefronts with \\\"www.\\\" domains from loading after users made changes in Theme Editor. (STENCIL-2724, was MERC-1513)\\n\\nSKiP: <b>2017-01-06:</b> Fixed a bug that prevented newly created stores from being assigned Stencil's Cornerstone base theme by default. (STENCIL-2382, was EAT-2382; PR # 16707, commit # c382104)\\n-->\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"You can choose to manually merge certain individual updates from the [Cornerstone GitHub repo](https://github.com/bigcommerce/cornerstone) using their displayed PR (pull-request) numbers or commit hashes. However, if you are building a custom theme, you might encounter conflicts that you will need to resolve by editing the affected files.\",\n  \"title\": \"Selective Updates\"\n}\n[/block]\n<b>2017-07-21:</b> We have published instructions on ensuring that your theme incorporates [reCAPTCHA v2 challenges](/docs/recaptcha-2) to deter spam submission through storefront forms. BigCommerce encourages all theme developers to incorporate this upgraded spam deterrent. (STENCIL-2934)\n\n<b>2017-07-21:</b> Our documentation includes a new overview of [localizing themes and stores](/docs/localizing-stores) for languages/regions beyond the U.S. English defaults defined within the Cornerstone base theme. We have also documented a new [option to automatically translate](/docs/multi-language-checkout#places) the `Country`/`State` names displayed on the checkout page.\n\n<b>2017-07-20:</b> Version 1.9.0 of Stencil's default Cornerstone theme is now available. This release provides two new region tags (see next entry below); provides a new Theme Editor check box to toggle on/off the display of `Shop by Price` facets; and reduces the size of theme bundles by minifying two JavaScript libraries. It also corrects several display bugs. For details, please see the [Cornerstone 1.9.x release notes](/docs/cornerstone-19x-theme-release-notes#182).\n\n<b>2017-07-20:</b> Two template files include new _region tags_ to support the placement of payments banners. The&#160;`.../templates/components/common/header.html` template now includes a `header_bottom` region tag, and the `.../templates/components/products/product-view.html` template now includes a `product_below_price` region tag. (MERC-2436; PR # [1023](https://github.com/bigcommerce/cornerstone/pull/1023); commit # [2328e7a](https://github.com/bigcommerce/cornerstone/pull/1023/commits/2328e7a78c47cee59feb80326acfb9f653bbb930))\n\n<b>2017-07-18:</b> Version 1.8.2 of Stencil's default Cornerstone theme is now available. This release provides several new options for displaying products, enables the use of third-party gift certificates (see next entry below), and corrects the \"Down for Maintenance\" page's styling. For details, please see the [Cornerstone 1.8.2 release notes](/docs/cornerstone-18x-theme-release-notes#182).\n\n<b>2017-07-18:</b> We have relaxed gift certificates' format validation. This allows imported third-party gift certificates, in arbitrary formats, to be valid on BigCommerce storefronts. (STENCIL-3533; PR # [1026](https://github.com/bigcommerce/cornerstone/pull/1026), commit # [2cc4bde](https://github.com/bigcommerce/cornerstone/pull/1026/commits/2cc4bde25b0ef047ee7bc9debca3f78b5367aff5))\n\n<b>2017-07-18:</b> `Quick View` links can now be displayed over products in list view. As in grid view, these links' visibility will now toggle on/off according to the storewide control-panel setting. (PR # [1033](https://github.com/bigcommerce/cornerstone/pull/1033); commit # [769b9b5](https://github.com/bigcommerce/cornerstone/pull/1033/commits/769b9b5cc3b485b45b02f4d23ee54ea39db63d7f))\n\n<b>2017-07-14:</b> Stencil CLI's new [`stencil push`](/docs/bundling-submitting#push) command allows theme developers (with appropriate OAuth tokens and scopes) to upload bundled themes directly to a BigCommerce store from the command line. This command bypasses the BigCommerce control panel. For detailed prerequisites and usage instructions, please see our documentation on [Uploading Your Theme](/docs/bundling-submitting#upload).\n\n<b>2017-07-14:</b> The [`stencil push`](/docs/bundling-submitting#push) command (see the entry above) relies on BigCommerce's new Themes API. For&#160;details on using this API to programmatically manage store themes, please see our [API documentation](https://developer.bigcommerce.com/api/v3/openapi-v3.html#a-name-themes-a-themes-api).\n\n<b>2017-06-16:</b> We have added new documentation on best practices for [synchronizing custom themes with updates ](/docs/theme-updates-sync)in Stencil's Cornerstone reference theme.\n\n<b>2017-06-15:</b> For developers who must still rely on Legacy API accounts (Basic Authentication) instead of the OAuth&#160;tokens that we now recommend, we have enabled workarounds for [creating](/docs/creating-an-api-account), [copying](/docs/copying-a-token-to-initialize-stencil), and [authenticating](docs/initializing-stencil) Legacy&#160;API accounts/tokens.\n\n<b>2017-06-08:</b> Our documentation now includes a [Getting Started/Transition Guide](/docs/getting-started-guide) for theme developers migrating to Stencil from other theming platforms (including Blueprint) and for designers used to working directly in HTML/CSS. This Guide includes a basic mapping of [Blueprint to Stencil features](/docs/getting-started-guide#map).\n\n<b>2017-05-31:</b> As of Stencil CLI version 1.10.0, the [`stencil init`](/docs/initializing-stencil) command requires that you generate any new API accounts/tokens as OAuth. For details on this new procedure, please see our revised documentation starting at [Creating an API Account](/docs/creating-an-api-account). (For themes that you have already initialized/authorized, the [`stencil start`](/docs/running-stencil-locally) command still supports [Legacy API accounts/tokens](https://support.bigcommerce.com/articles/Public/Legacy-API-Accounts) that rely on Basic Auth.)\n\n<b>2017-05-10:</b> Version 1.8.1 of Stencil's default Cornerstone theme is now available. This release adds a new \"administrative bar\" to Theme Editor, and to the store owner's view of a pre-launched store. These administrative bars offer faster, more consistent navigation, along with less-obstructed views of the storefront. For details, please see the [Cornerstone 1.8.x release notes](/docs/cornerstone-18x-theme-release-notes).\n\n<b>2017-05-09:</b> Our documentation on [Multi-Language Checkout](/docs/multi-language-checkout) configuration options has been expanded and moved to its own page. (These options apply to the Optimized One-Page Checkout and order confirmation templates.)\n\n<b>2017-05-04:</b> We have added a new `images` property to the [Common Product Card Model](/docs/common-product-card-model), plus a corresponding new `product.images` [front-matter attribute](https://stencil.bigcommerce.com/docs/front-matter-variables#Front-ref-prod). You can use `images` to define an array of up to five product images, to support rollovers. (MERC-783)\n\n<b>2017-04-28:</b> Version 1.7.0 of Stencil's default Cornerstone theme is now available. This release adds support for webpack 2 (see below), and also corrects several bugs that affected page display and customers' submission of product reviews. For details, please see the [Cornerstone 1.7.x release notes](/docs/cornerstone-17x-theme-release-notes).\n\n<b>2017-04-28:</b> Stencil now supports the <a href=\"https://medium.com/webpack/webpack-2-and-beyond-40520af9067f\" target=\"_blank\">webpack 2</a> JavaScript build system. By more efficiently excluding unused JavaScript, this webpack upgrade allows store pages to load faster for customers. (STENCIL-3250, STENCIL-3243; PR #964, 961; commits # f7e5d49, 41e6bf7f)\n\n<b>2017-04-27:</b> We have added [new documentation](#/docs/optimized-checkout-prereqs) that covers all the steps involved in _Preparing Stencil Themes for Optimized One-Page Checkout_.\n\n<b>2017-04-26:</b> In response to partner feedback, the Stencil framework now supports more than 100 new \n<a href=\"http://handlebarsjs.com/\" target=\"_blank\">Handlebars helpers</a>. These new helpers offer more power in handling strings, arrays, and dates, and in performing calculations within page templates. You can see our complete set of supported helpers on [this newly combined documentation page](/docs/handlebars-helpers-reference). (STENCIL-3323; PR #110, 114, 115, 294; commits # 71b8562, 777179e, 93cee82, 517f681)\n\n<b>2017-04-19:</b> We have added new [documentation](/docs/checkout-injection) on how to customize your theme's Optimized One-Page Checkout and order confirmation templates with options like injecting custom JavaScript, injecting scripts for trust seals and ecommerce apps, and applying storewide styling and headers/footers.\n\n<b>2017-03-29:</b> Version [1.6.3](/docs/cornerstone-16x-theme-release-notes#163) of Stencil's default Cornerstone theme is now available. This release opens up the Order&#160;Confirmation page for certain editing options. It also corrects the escaping of HTML in product list views, and corrects several display/rendering details for Google AMP (beta) templates.\n\n<b>2017-03-23:</b> We have added demonstration videos to the following Stencil documentation pages: \n[config.json Metadata](https://stencil.bigcommerce.com/docs/configjson-reference), [Navigating the Templates Directory](https://stencil.bigcommerce.com/docs/about-the-templates-directory), [Custom Templates (overview)](https://stencil.bigcommerce.com/docs/custom-layout-templates), [Navigating Stencil Design Assets](https://stencil.bigcommerce.com/docs/css-resources), [Using Custom Fonts](https://stencil.bigcommerce.com/docs/using-custom-fonts), [Using and Updating Icons](https://stencil.bigcommerce.com/docs/updating-icons), and [Invoking Translation Keys](https://stencil.bigcommerce.com/docs/invoking-translation-keys).\n\n<b>2017-03-16:</b> Version [1.6.2](/docs/cornerstone-16x-theme-release-notes#162) of Stencil's default Cornerstone theme is now available. This release fixes a 1.6.1 bug that prevented price and weight values on product pages from updating when shoppers selected an option/variant. (STENCIL-3277; PR # 963, commit # 07c684d)\n\n<b>2017-03-15:</b> Version 1.6.1 of Stencil's default Cornerstone theme is now available. This release adds support for Google reCAPTCHA v2 and for the Google AMP beta (see the next two entries below). Other enhancements include category menus up to eight levels deep, a new option to switch product display between list view/grid view, and faster loading of images within the active viewport. For details, please see the [Cornerstone 1.6.x release notes](/docs/cornerstone-16x-theme-release-notes).\n\n<b>2017-03-15:</b> To deter automated spam submission through storefront pages, Stencil now supports Google [reCAPTCHA v2](https://support.google.com/recaptcha/?hl=en). (STENCIL-2934; PR # 951, commit # 6f70c49)\n\n<b>2017-03-15:</b> Stencil's default Cornerstone theme now supports [Google AMP](https://www.ampproject.org/learn/overview/) to accelerate the mobile display of product and category pages, via alternate template files provided in the theme's `.../templates/pages/amp` folder. This is a beta feature for certain users who have opted in, and BigCommerce must specifically enable it for your store. If you would like request to opt into the beta, please contact [Community [at] bigcommerce [dot] com](mailto:Community:::at:::bigcommerce.com). (STENCIL-2944; PR # 946, commit # d3af229)\n\n<b>2017-03-13:</b> Contributors can now open, and comment on, <a href=\"https://github.com/bigcommerce/cornerstone/issues\" target=\"_blank\">issues</a> on the Cornerstone (formerly Stencil) GitHub repo.\n\n<b>2017-03-09:</b> Stencil's `schema.json` and `config.json` files now support a `text` data type. Store administrators can use this Theme Editor type to enter brief text strings, such as customized labels, badge text, and other storefront messaging. (STENCIL-2924)\n\n<b>2017-03-06:</b> Stencil CLI now displays specific error details when an npm module is missing, or when other Webpack errors occur. (PR # 950, commit # 586fb47)\n\n<b>2017-03-06:</b> Fixed a Stencil CLI bug that caused category links to unexpectedly point to the theme's live store, rather than to corresponding `localhost` pages. (STENCIL-3213)\n\n<b>2017-03-05:</b> We have renamed the former \"thank-you\" page to \"order confirmation.\" For themes based on Cornerstone, the corresponding template's new path/file name is: \n`<theme-name>/templates/pages/order-confirmation.html.` This also changes the customer-facing URL route from `.../checkout/thank-you` to: `.../checkout/order-confirmation`.\n\n<b>2017-03-01:</b> Our Stencil documentation includes new workarounds for customizing [printable invoices](/docs/customizing-printable-invoices), [printable&#160;packing slips](/docs/customizing-printable-packing-slips), and [email templates](/docs/customizing-email-templates).\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"New Cornerstone Repo Name and Default Path Name\",\n  \"body\": \"As of 2017-03-01, BigCommerce has renamed the GitHub repository for Stencil's base Cornerstone theme from `https://github.com/bigcommerce/stencil` to [`https://github.com/bigcommerce/cornerstone`](). This&#160;change is intended to clarify the distinction between the Cornerstone theme and the underlying Stencil&#160;framework. Earlier links to `https://github.com/bigcommerce/stencil` and its subdirectories should automatically redirect to [`https://github.com/bigcommerce/cornerstone`]().\\n\\nThis change also means that, by default, the Cornerstone theme now installs to a local directory named `/cornerstone/` rather than `/stencil/`.\\n\\nWe have updated the Stencil developer documentation to reflect both changes.\"\n}\n[/block]\n<b>2017-02-28:</b> Version 1.5.3 of Stencil's default Cornerstone theme is now available. (Release notes updated [here](/docs/release-notes-cornerstone-15-theme#153).) For stores that have enabled Optimized One-Page Checkout, this release adds options for customizing discount banners' colors via Theme Editor. It also corrects several bugs affecting review links and other aspects of storefront display and behavior.\n\n<b>2017-02-27:</b> Our documentation on [Downloading/Customizing Marketplace Themes](/docs/downloading-and-customizing-marketplace-themes) now covers required setup steps for BitBucket SSH keys. We also document a new, streamlined setup option for Marketplace themes versioned `1.10.0` and above. (These newer theme versions replace the jspm JavaScript build system with Webpack, allowing a leaner setup flow as with Stencil's base Cornerstone theme.)\n\n<b>2017-02-24:</b> We have expanded our documentation on [uninstalling/reinstalling Stencil and Node.js](/docs/uninstall-reinstall), to include Windows-specific instructions.\n\n<b>2017-02-23:</b> We have upgraded the Autoprefixer CSS library to version 6.7.3. This upgrade will remove the deprecation warnings that have recently appeared in Stencil CLI's console. (STENCIL-3125)\n\n<b>2017-02-23:</b> For themes that enable [Optimized One-Page Checkout](https://support.bigcommerce.com/articles/Public/Optimized-Single-Page-Checkout), local changes to a theme's `checkout.html` file now render in the browser. The preconditions are: You must [install](/docs/installing-stencil-cli-1) the current Stencil CLI version; ensure that your `config.json` file's [`meta` > `features` array](/docs/configjson-reference#config-var-meta) includes the `customized_checkout` value; and then [run `stencil bundle` and upload your zipped theme](/docs/bundling-submitting) to a live BigCommerce store. (STENCIL-3192)\n\n<b>2017-02-21:</b> New Theme Editor settings enable store administrators to customize colors in Optimized Checkout discount banners. (CHECKOUT-1459; PR # 924, commits # a13f887, ac74e8d, 4f9fd31)\n\n<b>2017-02-14:</b> Version 1.5.2 of Stencil's default Cornerstone theme is now available. (Release notes updated [here](/docs/release-notes-cornerstone-15-theme#152).) This release adds a Theme Editor check box to toggle the display of a GeoTrust SSL Seal in the footer. It also corrects carousel display/cropping on wide viewports, clarifies the usage of Theme Editor's `Social Media Icons` controls, and corrects a bug that displayed `Sign Up` links even when store-account creation had been disabled in the control panel.\n\n<b>2017-02-07:</b> Version 1.5.1 of Stencil's default Cornerstone theme is now available. (Release notes updated [here](/docs/release-notes-cornerstone-15-theme#151).) This maintenance release corrects a duplicate Quick Search close box in mobile viewports, a redundant Theme&#160;Editor horizontal scroll bar in smaller viewports, and a bug that displayed Gift Certificates options even when gift certificates had been disabled in the control panel. \n\n<b>2017-02-07:</b> The public repository for Stencil's default Cornerstone theme now has its own changelog, at \n[https://github.com/bigcommerce/cornerstone/blob/master/CHANGELOG.md](https://github.com/bigcommerce/cornerstone/blob/master/CHANGELOG.md). (Stencil-3000; PR # 919)\n\n<b>2017-02-02:</b> Version 1.5.0 of Stencil's default Cornerstone theme is now available. This release adds several new options for store owners to customize their store's appearance via Theme Editor. These options include displaying sale badges, displaying \"as low as $x\" pricing, and requiring customer logins for pricing and cart access. This release also corrects the behavior of hashbang links (`#!`), as described [below](#hashbang) in these framework release notes, and corrects the display of product options in Quick View modals. For details, please see the [Cornerstone 1.5.x release notes](/docs/release-notes-cornerstone-15-theme).\n\n<b>2017-01-20:</b> We have deprecated the global [`template_file` property](/docs/template-file-property) and replaced it with a new \n[`template` property](/docs/template-property), which returns correct page types for custom templates files. These return values will be of the form: `pages/custom/brand/...html`, `pages/custom/category/...html`, `pages/custom/product/...html`, and `pages/custom/page/...html`. To pick up this correction, you must [update your Stencil CLI installation](/docs/installing-stencil-cli-1). (STENCIL-2919; PR # 265, commit # 29c039f)\n\n<b>2017-01-19:</b> We have upgraded our webpack (JavaScript build system) version from 1.12.14 to 1.14.0, to fix a bug with babel source maps. (PR # 906, commit # 62acced)\n\n<span id=\"hashbang\"> <b>2017-01-11:</b> Fixed a bug that prevented the proper loading of pages/resources with hashbang links (links of the form: `http://somedomain.com/#!tag/`). We have corrected this in the source JavaScript by removing the history.js shim and swapping in the HTML5 History API shim. (MERC-1272, STENCIL-2466; PR # 879, 902; commits # 3eaf205, 23fa089) </span>\n\n<b>2017-01-10:</b> Version 1.4.2 of Stencil's default Cornerstone theme is now available. (Release notes updated [here](/docs/cornerstone-14x-theme-release-notes#142).) This release replaces the Contact form template's CAPTCHA challenge with a Google reCAPTCHA v1 challenge, to deter spam submissions. (MERC-1637; PR # 901, commit # 9fae25a)\n\n<b>2016-12-22:</b> The [Common Product Card Model](/docs/common-product-card-model) now includes a `ratings` property, representing the number of customer reviews that contributed to a product's `rating` value. (MERC-1207; PR # 16508, commit # 00c436d)\n\n<b>2016-12-20:</b> The Stencil documentation now includes several new examples of [adding custom JavaScript](/docs/js-api) to your theme – whether your own JavaScript, or third-party modules.\n\n<b>2016-12-20:</b> The Stencil documentation now includes instructions on [using and updating a theme's icons](/docs/updating-icons).\n\n<b>2016-12-19:</b> The Stencil framework now supports [Optimized One-Page Checkout](https://support.bigcommerce.com/articles/Public/Optimized-Single-Page-Checkout). To enable this option, you must first [update your Stencil CLI installation](/docs/installing-stencil-cli-1), and then ensure that your `config.json` file's [`meta` > `features` array](/docs/configjson-reference#config-var-meta) includes the `customized_checkout` value. For Stencil-specific styling of the Optimized One-Page Checkout page, please see [this entry](/docs/optimized-checkout-customization). (MERC-1553, MERC-1555, MERC-1579; PR # 261, commit # b9e1329)\n\n<b>2016-12-19:</b> To enable <a href=\"https://support.bigcommerce.com/articles/Public/Optimized-Single-Page-Checkout\" target=\"_blank\">Optimized One-Page Checkout</a> in your theme, you can now add the new `customized_check_out` value to your [`config.json` file](/docs/configjson-reference#config-theme-meta)'s `meta` > `features` array. (MERC-1579, PR # 261, commit # b9e1329)\n\n<b>2016-12-19:</b> The Stencil documentation now includes instructions on enabling and styling the [Apple Pay button](https://stencil.bigcommerce.com/docs/apple-pay-styling) as a checkout alternative.\n\n<b>2016-12-05:</b> Version 1.4.1 of Stencil's default Cornerstone theme is now available. (Release notes updated [here](/docs/cornerstone-14x-theme-release-notes#141).) This release corrects a bug that allowed JavaScript to execute in a Cornerstone storefront's search box. (MERC-1537; PR # 883, commit # 143767f)\n\n<b>2016-11-21:</b> Version 1.4.0 of Stencil's default Cornerstone theme is now available. This release adds support for Apple Pay, BigCommerce Optimized One-Page Checkout, and other features. For details, please see the [Cornerstone 1.4.x release notes](/docs/cornerstone-14x-theme-release-notes).  We have updated the framework's <span class=\"inline-code\"><a href=\"/docs/configjson-reference\">config.json</a></span> and <span class=\"inline-code\"><a href=\"/schemajson-metadata-for-theme-editor\">schema.json</a></span> documentation to cover new options exposed in this Cornerstone refresh. For Optimized Checkout customization options, please see [this new documentation](/docs/optimized-checkout-customization).\n\n<b>2016-10-27:</b> Fixed a bug that prevented the display or hiding of SKUs on product cards from obeying the user's control-panel selection at `Store Setup` > `Store Settings` > `Display` > `Product Settings` > `Show Product's SKU?`. (MERC-1206)\n\n<b>2016-10-25:</b> For easier navigation within the Stencil documentation, we have promoted the former Attributes/Objects Reference section's contents to five new top-level sections: \n  * [Front-Matter Attributes](/docs/using-yaml-front-matter) \n  * [Handlebars Syntax](/docs/syntax-handlebars)\n  * [Stencil Object Model Reference](/docs/stencil-object-model)\n  * [Event Hooks](/docs/the-stencil-utils-package)\n  * [Conditional-Logic Examples](/docs/conditional-logic-examples)\n\n<b>2016-10-24:</b> To troubleshoot Windows-specific issues, we have updated the [Node.js prerequisite's recommended Windows version](/docs/prerequisites-windows#Node+npm_Win) from 0.12.7 to 4.6.1. This change also appears on our [Troubleshooting Your Setup](/docs/troubleshooting#Troubleshooting) page.\n\n<b>2016-10-21:</b> Fixed a bug that blocked JavaScript bundling on [downloaded Marketplace themes](/docs/downloading-and-customizing-marketplace-themes), which in turn caused the [`stencil init` command](/docs/initializing-stencil) to fail. (MERC-1238)\n\n<b>2016-10-04:</b> Version 1.3.4 of Stencil's default Cornerstone theme is now available. This maintenance release standardizes the IE11 and Edge browsers' display behavior with out-of-stock product options/SKUs. For details, please see the [Cornerstone 1.3.x release notes](/docs/release-notes-cornerstone-13-theme#133).\n\n<b>2016-09-27:</b> Version 1.3.3 of Stencil's default Cornerstone theme is now available. This maintenance release standardizes the alignment of payment buttons, and provides a workaround for the IE11 and Edge browsers' display behavior with out-of-stock product options/SKUs. For details, please see the [Cornerstone 1.3.x release notes](/docs/release-notes-cornerstone-13-theme#133).\n\n<b>2016-09-23:</b> For faster navigation, we have broken out separate documentation sections for [basic installation](/docs/installing-and-launching-stencil-1) versus [advanced installation options](/docs/advanced-installation-options). In the basic section, we have promoted [store-token instructions](/docs/preparing-your-store-tokens) to a multi-page subsection, and added a new page showing how to [enable Stencil on Blueprint stores](/docs/blueprint-to-stencil) launched before Jan. 26, 2016. In the advanced section, we have added a [visual overview](/docs/stencil-setup-illustrated) of all supported setup flows.\n\n<b>2016-09-21:</b> The [common product card object](/docs/common-product-card-model) now exposes a `custom_fields` array. You can use custom fields for purposes like: alternate brand names, merchandising titles for products, product types, \"gift idea\" indicators, etc. (MERC-785; PR # 15224, commit # bb3e9d4)\n\n<b>2016-09-19:</b> Fixed a bug that caused Brands pages to sort by brand ID, rather than alphabetically. (MERC-1105; PR&#160;# 15204, commit # ce7a1f4)\n\n<b>2016-09-19:</b> The [Cart Items object](/docs/cart-resources#Cart_Items) now includes an `rrp` property. You can use this to display strikeout pricing, as explained [here](/docs/cart-resources#strikeout). (MERC-786; PR # 15221, commit # 5c8dcb8)\n\n<b>2016-09-19:</b> The [common product card object](/docs/common-product-card-model) now provides `stock_level` and `low_stock_level` properties. If you use inventory tracking, you could (hypothetically) build conditional logic to display \"limited availability\" indicators/badges on your storefront when the `stock_level` value falls below the `low_stock_level` threshold. (MERC-918; PR # 15180, commit # ac445c1)\n\n<b>2016-09-19:</b> Fixed a bug that caused brands to sort by ID, rather than alphabetically as intended. (MERC-1105; PR # 15204, commit # ce7a1f4)\n\n<b>2016-09-16:</b> The [common product card object](/docs/common-product-card-model) now provides a `sku` property. (MERC-784; PR # 15181, \ncommit # 8c342dc)\n\n<b>2016-09-15:</b> The Settings common object's [`{{urls.checkout}}` property](/docs/settings-object) now includes a `multiple_address` key that support multiple shipping addresses. (EAT-1871)\n\n<b>2016-09-12:</b> Fixed a bug that prevented Stencil from returning products' [`non_sale_price_without_tax`](/docs/catalog-price-common-object) property. We have also added a new <a href=\"/docs/price-object-properties\">documentation page</a>) outlining how this property interacts with other catalog price properties, and with control-panel price options. (MERC-951, MERC-947; PR # 15111, commit # d2081a3)\n\n<b>2016-09-07:</b> Fixed a bug that caused shoppers' `My Account > Your Recent Items` section to appear empty for stores using Shared SSL. MERC-833; PR # 14814)\n[block:html]\n{\n  \"html\": \"<b>2016-09-06:</b> Version 1.3.2 of Stencil's default Cornerstone theme is now available. This maintenance release corrects the display of YouTube videos under sitewide HTTPS, and corrects the Cornerstone Bold variation's display of featured products. For details, please see the <a href=\\\"/docs/release-notes-cornerstone-13-theme#132\\\">Cornerstone 1.3.x release notes</a>.<br><br>\\n\\n<b>2016-08-31:</b> You can now reference Stencil Handlebars variables &ndash; and all corresponding <a href=\\\"/docs/stencil-object-model\\\">Stencil objects and properties</a> &ndash; in scripts injected into a store’s global footer. You access this feature through the control panel’s <span class=\\\"inline-code\\\">Storefront Design &gt; Design Options &gt; Scripts</span> tab, as illustrated in <a href=\\\"https://support.bigcommerce.com/articles/Public/Adding-Custom-Scripts-to-Stencil-Themes\\\">this Knowledge Base article</a>. (MERC-902)<br><br>\\n\\n<b>2016-08-31:</b> <a href=\\\"/docs/custom-layout-templates\\\">Custom templates</a> are now generally available for authoring and assignment on all Stencil stores.\\n<br><br>\\n\\n<b>2016-08-22:</b> We have updated our <a href=\\\"/docs/custom-layout-templates\\\">custom templates</a> <strike>(beta feature)</strike> documentation to clarify Stencil versus Blueprint options, and to add details and troubleshooting tips on assigning templates to pages.\\n<br><br>\\n\\n<b>2016-08-12:</b> Version 1.3.1 of Stencil's default Cornerstone theme is now available. This maintenance release adjusts some image-size defaults that might have displayed blurry or undersized images on some storefronts. For details, please see the <a href=\\\"/docs/release-notes-cornerstone-13-theme#131e\\\">Cornerstone 1.3.x release notes</a>.<br><br>\\n\\n<b>2016-08-08:</b> We have added a new <a href=\\\"/docs/download-and-build-scenarios\\\">documentation subsection</a> to cover three new installation scenarios: downloading a refreshed Cornerstone theme, downloading other Theme Marketplace themes for customization, and configuring a custom build system. We have also updated our <a href=\\\"/docs/installing-and-launching-stencil-1\\\">Installing Stencil</a> overview, and our <NOBR><a href=\\\"/docs/staging-and-submitting-a-theme\\\">Submitting a Theme</a></nobr> page, to help guide you through these new scenarios.<br><br>\\n\\n<b>2016-08-04:</b> We have added documentation on using <a href=\\\"/docs/using-custom-fonts\\\">custom fonts</a> in your theme.<br><br>\\n\\n<b>2016-08-04:</b> We have updated our <a href=\\\"//docs/custom-layout-templates\\\">custom templates</a> (beta feature) documentation. Key names within the <span class=\\\"inline-code\\\">.stencil</span> file are now corrected from plural to singular, and subdirectory names now match those in the <NOBR><span class=\\\"inline-code\\\">.stencil</span> file</nobr>.\\n<br><br>\\n\\n<b>2016-08-03:</b> Version 1.3 of Stencil's default Cornerstone theme is now available. This update adds image-resizing options, enhanced faceted/filtered search, and several bug fixes. For details, please see the <a href=\\\"/docs/release-notes-cornerstone-13-theme\\\">Cornerstone 1.3.x release notes</a>. We have updated the framework's <span class=\\\"inline-code\\\"><a href=\\\"/docs/configjson-reference\\\">config.json</a></span> and <span class=\\\"inline-code\\\"><a href=\\\"/schemajson-metadata-for-theme-editor\\\">schema.json</a></span> documentation to cover new options exposed in this Cornerstone refresh.<br><br>\\n\\n<b>2016-08-03:</b> Fixed a bug that disabled buttons in the Quick View overlay that shoppers launch from home-page product images. (MERC-893; PR # 820, commit # edb65eb)<br><br>\\n\\n<b>2016-08-03:</b> For shoppers performing faceted searches, the Cornerstone theme can now display up to 500 values per facet, through the \\\"More+\\\" link. (MERC-75; PR&nbsp;# 794, commit #'s  92a62fa, fc7bad1)<br><br> \\n\\n<b>2016-08-03:</b> Merchants can now use Theme Editor to resize logo and product images. (MERC-608, MERC-616; PR&nbsp;#797, commit #'s 247a133, 0e9ac23, f963775, 6798423)<br><br>\\n\\n<b>2016-08-03:</b> The <a href=\\\"/docs/front-matter-variables#Front-ref-brandlist\\\">brands</a> front-matter parameter now limits the Brands list to a maximum of 50 brands. Also, the <span class=\\\"inline-code\\\">&lt;theme-name&gt;/templates/pages/brands.html</span> template now paginates the displayed Brands list; the default pagination value is also 50 brands per page. (MERC-725; PR&nbsp;#813, commit # 816c7fa)<br><br>\\n\\n<b>2016-08-03:</b> Fixed a bug that displayed a A blank white page with an \\\"Array\\\" message, rather than a standard 404 page, in response to URLs for brands missing from a store. (MERC-767<!--; PR # #13783, commit #'s 40c121e, f05d791-->)<br><br>\\n\\n<b>2016-08-03:</b> Fixed a bug that stretched small product images to fill the allotted display area, leading to blurry product images on the product details page and in product galleries. (MERC-888; PR&nbsp;# 817, commit # 697334e)<br><br>\\n\\n<b>2016-07-29:</b> We have consolidated the <span class=\\\"inline-code\\\">Price</span>, <span class=\\\"inline-code\\\">Catalog Price</span>, <span class=\\\"inline-code\\\">Stencil Image</span>, and <span class=\\\"inline-code\\\">Common Product Card Model</span> documentation in a new <a href=\\\"/docs/common-object-formats\\\">Common Objects</a> subsection. We have also clarified how these objects can be accessed within the Stencil framework; and we have updated the descriptions of certain properties on the <a href=\\\"/docs/global-objects\\\">Global Objects</a> and <NOBR><a href=\\\"/docs/cart-resources\\\">Cart Objects</a></nobr> pages.<br><br>\\n\\n<b>2016-07-26:</b> Fixed a bug that caused the <span class=\\\"inline-code\\\">theme_settings</span> context variable to fail to carry over from developers' local environments to production stores. (MERC-891<!--, PR # 14281, 14421; commit # fd6c25d, 35a9e63, 780024d, 1143f41, \\t9f7360d, c7c2b0c, 1e25c55M-->)<br><br>\\n\\n<b>2016-07-26:</b> We have updated several documentation pages to clarify that <a href=\\\"/docs/using-yaml-front-matter\\\">front matter</a> can be invoked only on templates in a theme's <span class=\\\"inline-code\\\"><a href=\\\"/docs/pages-subdirectory\\\">/templates/pages/</a></span> subdirectory.<br><br>\\n\\n<b>2016-07-26:</b>: Fixed a faceted-search bug that prevented the sidebar's <NOBR>\\\"Selected Facets\\\"</nobr> block from refreshing to show filters that a shopper has newly selected from the <span class=\\\"inline-code\\\">More+</span> modal window. (MERC-875; PR #'s 14460, 14495, commit #'s 9866762, 20dc6de, 5849869, 77cd541) <br><br>\\n\\n<b>2016-07-21:</b>: Fixed a bug that caused logo images to be resized upon upload, even when users de-selected the <span class=\\\"inline-code\\\">Yes, automatically resize my logo...</span> option. (MERC-771; PR&nbsp;# 14301, commit # f9b7fb1) <br><br>\\n\\n<b>2016-06-15:</b> Updated Stencil CLI's <span class=\\\"inline-code\\\">package.json</span> file to correct references to the <span class=\\\"inline-code\\\">angular-gettext</span> dependency. (PR&nbsp;# 231, commit # f521043)<br><br>\\n\\n<b>2016-06-07:</b> Fixed a bug that, for themes bundled on Windows, caused front-matter statements to display on store pages. (MERC-710; PR&nbsp;# 344, commit #'s f88854c, 4a816f2)<br><br>\\n\\n<b>2016-05-27:</b> Fixed a bug that prevented themes from properly bundling on Windows. This caused the resulting theme .zip files to fail uploading via the control panel. (MERC-683' PR #'s 223, 224; commit #'s ae4d5c3, 3e15416, 779d684, 8cc4668)<br><br>\\n\\n<b>2016-05-27:</b> Fixed a bug that blocked Theme Editor users from recording changes to variations. The symptom was that clicking the <nobr><span class=\\\"inline-code\\\">Save Changes</span></nobr> or <nobr><span class=\\\"inline-code\\\">Apply Theme</span></nobr> button displayed the error message: \\\"There was an error with your request.\\\" (MERC-700)<br><br>\\n\\n<b>2016-05-27:</b> Fixed a bug that blocked Theme Editor from loading after a merchant disabled site-wide HTTPS. (MERC-641)<br><br>\\n\\n<b>2016-05-27:</b> Fixed a bug that prevented the <span class=\\\"inline-code\\\">cart.suggestions</span> <nobr><a href=\\\"https://stencil.bigcommerce.com/docs/front-matter-variables#Front-ref-cart\\\">front-matter attribute</a></nobr> and the <span class=\\\"inline-code\\\">suggested_products</span> <nobr><a href=\\\"https://stencil.bigcommerce.com/docs/cart-resources#Suggested\\\">Cart object</a></nobr> from properly displaying suggested products, based on current cart contents. Also, we are deprecating the duplicate <span class=\\\"inline-code\\\">suggestive_products</span> object previously listed in the <nobr><a href=\\\"https://stencil.bigcommerce.com/docs/cart-resources\\\">Cart objects</a></nobr> documentation, although this object is still supported in the Stencil framework. (MERC-722)<br><br>\\n\\n<b>2016-05-12:</b> Version 1.2 of the Stencil Cornerstone theme is now available, adding a new logo-positioning option. For details, please see <a href=\\\"https://developer.bigcommerce.com/blog/changelog/themes-stencil-cornerstone-1-2\\\">this changelog entry</a>.<br><br>\\n\\n<b>2016-05-12:</b> Fixed a bug that prevented the home-page carousel from displaying a left navigation arrow. (MERC-691)<br><br>\\n\\n<b>2016-05-12:</b> Fixed a bug that prevented the top-left hamburger menu from opening on mobile displays. (MERC-662)<br><br>\\n\\n<b>2016-05-12:</b> Fixed a bug that prevented shoppers from increasing the quantity of cart items on mobile displays. (MERC-684)<br><br>\\n\\n<b>2016-05-06:</b> Custom/private theme uploads are now available. For details, please see <a href =\\\"https://support.bigcommerce.com/articles/Public/Custom-Theme-Upload\\\">this Knowledge Base article</a> and <a href =\\\"/docs/uploading-a-custom-theme\\\">this troubleshooting page</a>.<br><br>\\n\\n<b>2016-04-27:</b> Fixed a bug where enabling faceted search caused only one product to display on listing pages like Categories and Brands. The single-product display occurred regardless of the actual number of products, and regardless of the display configuration. (MERC-670)<br><br>\\n\\n<b>2016-04-22:</b> A new <a href =\\\"/docs/front-matter-variables#Front-ref-global\\\">front-matter attribute</a> named <span class=\\\"inline-code\\\">categories:description</span> is available. This boolean's value indicates whether to dynamically retrieve category descriptions.<br><br>\\n\\n<b>2016-04-19:</b> BigCommerce has simplified installation of the Stencil framework: We no longer require the jspm package manager as a dependency. We have made corresponding updates to our installation <a href=\\\"/docs/prerequisites\\\">prerequisites</a> and <a href=\\\"/docs/javascript-utilities\\\">instructions</a>, related <a href=\\\"/docs/troubleshooting\\\">troubleshooting</a> info, and related examples.<br><br>\\n\\n<b>2016-04-16:</b> When a merchant switched from a Blueprint theme, some Stencil themes incorrectly reported that product filtering was unsupported. This incorrect notification no longer appears. (MERC-406)<br><br>\\n\\n<b>2016-04-14:</b> A new <a href =\\\"/docs/front-matter-variables#Front-ref-global\\\">front-matter attribute</a> named <span class=\\\"inline-code\\\">categories</span> is available. This boolean's value indicates whether to retrieve the category tree during an AJAX request.<br><br>\\n\\n<b>2016-04-14:</b> A new <a href =\\\"/docs/custom-handlebars-helpers\\\">custom Handlebars helper</a> named <span class=\\\"inline-code\\\">or</span> is available. It accepts parameters of different types, and renders a Handlebars block if at least one passed parameter evaluates to true.<br><br>\\n\\n<b>2016-04-04:</b> Fixed a bug that caused oversized date fields on checkout pages. (MERC-414)<br><br>\\n\\n<b>2016-04-01:</b> A new <a href =\\\"/docs/custom-handlebars-helpers\\\">custom Handlebars helper</a> named <span class=\\\"inline-code\\\">all</span> is available. It accepts parameters of different types, and renders a Handlebars block if all passed parameters evaluate to true.<br><br>\\n\\n<b>2016-03-29:</b> Fixed a bug where Stencil stores displayed an HTTP <span class=\\\"inline-code\\\">500 Internal Server Error</span> page, instead of storefront pages, when an invalid country locale was configured. (MERC-491)<br><br>\\n\\n<b>2016-03-29:</b> The global <a href=\\\"/docs/settings-object\\\">Settings</a> object now provides a <span class=\\\"inline-code\\\">{{blog_enabled}}</span> property. Its boolean value indicates whether the blog is visible for this store. (MERC-393)<br><br>\\n\\n<b>2016-03-22:</b> Within the <a href =\\\"/docs/cart-resources#Cart_Items\\\">Cart Items</a> object's bulk_pricing <span class=\\\"inline-code\\\">bulk_pricing</span> child object, the <span class=\\\"inline-code\\\">discount_amount</span> and <span class=\\\"inline-code\\\">discount_percentage</span> properties are now mutually exclusive, as designed. Merchants can set either a discount amount or a discount percentage on a product. If an <span class=\\\"inline-code\\\">amount</span> is set, the <span class=\\\"inline-code\\\">percentage</span> will be null, and vice versa. (MERC-147)<br><br>\\n\\n<b>2016-03-04:</b> When creating a theme bundle, Stencil CLI will now detect cyclical dependencies between templates, and will display a corresponding error message. (MERC-96)<br><br>\\n\\n<b>2016-03-22:</b> Theme developers can now customize the style of a theme's Thank You page, using the <span class=\\\"inline-code\\\">checkout.scss</span> stylesheet described <a href=\\\"/docs/checkout-header-customization\\\">here</a>. (MERC-366)<br><br>\\n\\n<b>2016-03-22:</b> Fixed a bug where disabling gift certificates in a theme left a valueless radio button visible on the storefront, even if the merchant later re-enabled gift certificates. (MERC-415)<br><br>\\n\\n<b>2016-03-22:</b> Fixed a bug where selecting certain faceted-search filters broke search results, with symptoms like spurious zero results or hidden filters. The affected filters included <span class=\\\"inline-code\\\">has free shipping</span>, <span class=\\\"inline-code\\\">is featured</span>, and <NOBR><span class=\\\"inline-code\\\">in stock</span>.</nobr> (MERC-420)<br><br>\\n\\n<b>2016-03-15:</b> The Stencil framework, and its default theme, now respect control-panel selections to hide out-of-stock products and options from the storefront. (MERC-295)<br><br> \\n\\n<b>2016-03-09:</b> Faceted-search results now correctly reflect a shopper's selected product ratings. (MERC-162)<br><br> \\n\\n<b>2016-03-08:</b> Faceted-search results now correctly reflect a shopper's selected Shop by Price range, and correctly display that selection in the faceted-search panel. (MERC-103)<br><br>\\n\\n<b>2016-03-07:</b> The <a href=\\\"/docs/category-resources#Category\\\">Category</a> object's <span class=\\\"inline-code\\\">{{category.subcategories}}</span> child object now includes a <span class=\\\"inline-code\\\">product_count</span> property. This property's value matches the number of products in the subcategory (at the current level only, with no recursive counting of nested levels). (MERC-320)<br><br>\\n\\n<b>2016-03-03:</b> Fixed a bug that prevented some store pages from loading when certain strings were passed to the <span class=\\\"inline-code\\\"><a href=\\\"/docs/invoking-translation-keys\\\">lang</a></span> Handlebars helper. (MERC-382)<br><br>\\n\\n<b>2016-03-01:</b> Fixed a checkout bug where a shopper could be sent through the multi-step checkout path, instead of the single-page checkout path. (MERC-65)<br><br>\\n\\n<b>2016-02-29:</b> The BigCommerce control panel's <span class=\\\"inline-code\\\">Enable Mobile Theme</span> check box applies only to Blueprint themes. Fixed a bug where Stencil themes did not display the responsive checkout page when this flag was checked. (BIG-26312)<br><br>\\n\\n<b>2016-02-29:</b> A new <span class=\\\"inline-code\\\">config.Email</span> <a href=\\\"/docs/checkout-objects#cfg.Email\\\">variable</a> contains a logged-in customer's email address. You can use this value for checkout-page personalization, analytics, abandoned-cart messages, and other marketing campaigns. (MERC-322)<br><br>\\n\\n<b>2016-02-29:</b> The <a href =\\\"/docs/cart-resources#Cart_Items\\\">Cart Items</a> object now exposes a <span class=\\\"inline-code\\\">bulk_pricing</span> child object to manage <NOBR><a href =\\\"https://support.bigcommerce.com/articles/Public/How-do-I-create-bulk-discount-pricing-for-my-products\\\">bulk discounts</a>.</nobr> This new object provides properties representing a cart item's base price, bulk discount amount, and bulk discount percentage. (MERC-147)<br><br>\\n\\n<b>2016-02-26:</b> Merchants can now display any Web page as the store's home page, by using the control panel's <span class=\\\"inline-code\\\">Content</span> > <NOBR><span class=\\\"inline-code\\\">Web Pages</span></nobr> > UI to access and select that page's <span class=\\\"inline-code\\\">Display as Home Page</span> option. (MERC-291)<br><br>\\n\\n<b>2016-02-22:</b> We have updated the <a href =\\\"/docs/product-resources#Product\\\">Product</a> object's <span class=\\\"inline-code\\\">{{product.customizations}}</span> child object to better match configurable fields in the BigCommerce control panel. This object's numeric properties (available when <span class=\\\"inline-code\\\">{{product.customizations.type}}</span> value = <span class=\\\"inline-code\\\">NumbersOnlyText</span>) can now pass minimum and maximum values; and can now accept floating-point/decimal and zero values, in addition to positive integer values. (MERC-159 and MERC-160)<br><br>\\n\\n<b>2016-02-22:</b> The <a href=\\\"/docs/category-resources#Category\\\">Category</a> object's <span class=\\\"inline-code\\\">{{category.subcategories}}</span> child object now provides three new properties: <span class=\\\"inline-code\\\">id</span>, <span class=\\\"inline-code\\\">description</span>, and <span class=\\\"inline-code\\\">image</span>. These correspond to the identically named properties of the parent <span class=\\\"inline-code\\\">{{category}}</span> object, allowing your themes to access similar data at the <span class=\\\"inline-code\\\">subcategories</span> level. (MERC-268)<br><br>\\n\\n<b>2016-02-22:</b> The <a href=\\\"/docs/product-resources#Product\\\">Product</a> object now provides a <span class=\\\"inline-code\\\">{{product.options}}</span> child object. This object's properties allow themes to access colors, patterns, display names, and other aspects of swatches that represent product options. Also, maximum swatch dimensions have been expanded to 150 x 150 pixels. (MERC-81)<br><br>\\n\\n<b>2016-02-15:</b> The global <a href=\\\"/docs/settings-object\\\">Settings</a> object now provides a <span class=\\\"inline-code\\\">{{settings.client_ip_address}}</span> property, which fetches the IP address of the shopper browsing the store. (MERC-232)<br><br>\\n\\n<b>2016-02-12:</b> The shipping estimator for cart items now properly displays a merchant-customized Out of Delivery Zone Message, rather than a generic message. (MERC-112)<br><br>\\n\\n<b>2016-02-10:</b> The global <a href=\\\"/docs/catalog-price-common-object\\\">Catalog Price</a> object now contains <span class=\\\"inline-code\\\">{{non_sale_price_with_tax}}</span> and <span class=\\\"inline-code\\\">{{non_sale_price_without_tax}}</span>  properties. During sale events, these can be used to display a store's standard prices, alongside the sale and list prices. (MERC-63)<br><br>\\n\\n<b>2016-02-10:</b> The global <a href=\\\"/docs/settings-object\\\">Settings</a> object now contains a <span class=\\\"inline-code\\\">{{settings.measurements}}</span> object. Its child <span class=\\\"inline-code\\\">{{length}}</span> and <span class=\\\"inline-code\\\">{{weight}}</span> properties define units of measure, corresponding to control-panel options. (MERC-66)<br><br>\\n\\n<b>2016-02-10:</b> The <a href=\\\"/docs/cart-resources#Cart\\\">Cart</a> object now has a <span class=\\\"inline-code\\\">{{cart.selected_city}}</span> property, for the city/town that a customer selects for shipping estimates. In Stencil's default Cornerstone theme, the shipping-estimator step now prompts the shopper for the shipping city. (BIG-25579)<br><br>\\n\\n<b>2016-02-02:</b> You can now access the Customer Group Name and Customer ID through the <a href=\\\"/docs/customer-resources#Customer\\\">Customer</a> object's <span class=\\\"inline-code\\\">{{customer.customer_group_name}}</span> and <span class=\\\"inline-code\\\">{{customer.customer_group_id}}</span> properties. (BIG-25631)<br><br>\\n\\n<b>2016-01-28:</b> When setting a Date Range in the control panel, merchants can now freely specify their intended earliest and latest dates or ranges, including years. (BIG-25712)<br><br>\\n\\n<b>2016-01-28:</b> Stencil themes now support images up to 4096 x 4096 pixels. (BIG-25388)<br><br>\\n\\n<b>2016-01-28:</b> You can now access the SKU for items in the cart through the <a href =\\\"/docs/cart-resources#Cart_Items\\\">Cart Items</a> object's <NOBR><span class=\\\"inline-code\\\">{{cart.items.sku}}</span> property.</nobr> (BIG-25758)\"\n}\n[/block]","excerpt":"These release notes for the Stencil platform (and related components) are intended for theme and application developers. The notes are cumulative, with the newest entries at the top. (Please also see the release notes for the Cornerstone base theme, which follow this page.)","slug":"release-notes","type":"basic","title":"Stencil Framework – Release Notes"}

Stencil Framework – Release Notes

These release notes for the Stencil platform (and related components) are intended for theme and application developers. The notes are cumulative, with the newest entries at the top. (Please also see the release notes for the Cornerstone base theme, which follow this page.)

[block:html] { "html": "<!-- PENDING FOR CORNERSTONE 1.9.1:\nFoundation/Citadel fix, via PR. See 1.9.x notes.\n\nCorrect `{{template_file}}` glitches:\n Roll back https://github.com/bigcommerce/cornerstone/pull/1032:\nhttps://github.com/bigcommerce/cornerstone/pull/1049/files\n\nhttps://jira.bigcommerce.com/browse/STENCIL-2922\n ^ Fix issue of JavaScript not running on custom template pages, by changing Cornerstone to use `page_type` instead of `template_file`\\/ \nhttps://github.com/bigcommerce/cornerstone/pull/1050\n-->\n\n<!-- BYPASSED:\n<b>2017-04-25:</b> We have upgraded Cornerstone's [Citadel](/docs/componentsdesign-patterns#Patterns) SCSS pattern library to version 2.15.1. This upgrade corrects the conditional import of the Clear Sans Web font, and corrects the behavior of active tabs. (PR #999, commit # 562bdf6)\n\nExperimental fix for using the API to assign custom template files to products on Stencil stores. (https://jira.bigcommerce.com/browse/STENCIL-2999)\n\n<b>2017-02-03:</b> Theme Editor in Stencil CLI updated, was outdated. (STENCIL-2489)\n\n<b>2017-02-03:</b> Resizing elements didn't work in Theme Editor after save. (STENCIL-2971)\n\n<b>2017-01-30:</b> We have updated Stencil's [Citadel pattern library](/docs/componentsdesign-patterns#Patterns) to remove warnings that were previously present about utility classes. (UI-143)\n\nDuplicate title tags on multiple pages (https://jira.bigcommerce.com/browse/STENCIL-2463)\n\n[SEO] Canonical tags for category pages not pointing to first page of results (https://jira.bigcommerce.com/browse/BIG-29031)\n\nSpam, spam (STENCIL-2475)\n\nSKIP, KB ONLY (Stencil-2514): <b>2017-01-06:</b> Within the Edit Theme Files editor, using a Search keyboard shortcut (Cmd-F or Ctrl-F) now properly opens the Search box on each edited file. The Search box supports regular expressions, case-sensitive search, and whole-word search. (https://jira.bigcommerce.com/browse/STENCIL-2783)\n\nSKIP: <b>2017-01-06:</b> Fixed a bug that prevented storefronts with \"www.\" domains from loading after users made changes in Theme Editor. (STENCIL-2724, was MERC-1513)\n\nSKiP: <b>2017-01-06:</b> Fixed a bug that prevented newly created stores from being assigned Stencil's Cornerstone base theme by default. (STENCIL-2382, was EAT-2382; PR # 16707, commit # c382104)\n-->" } [/block] [block:callout] { "type": "info", "body": "You can choose to manually merge certain individual updates from the [Cornerstone GitHub repo](https://github.com/bigcommerce/cornerstone) using their displayed PR (pull-request) numbers or commit hashes. However, if you are building a custom theme, you might encounter conflicts that you will need to resolve by editing the affected files.", "title": "Selective Updates" } [/block] <b>2017-07-21:</b> We have published instructions on ensuring that your theme incorporates [reCAPTCHA v2 challenges](/docs/recaptcha-2) to deter spam submission through storefront forms. BigCommerce encourages all theme developers to incorporate this upgraded spam deterrent. (STENCIL-2934) <b>2017-07-21:</b> Our documentation includes a new overview of [localizing themes and stores](/docs/localizing-stores) for languages/regions beyond the U.S. English defaults defined within the Cornerstone base theme. We have also documented a new [option to automatically translate](/docs/multi-language-checkout#places) the `Country`/`State` names displayed on the checkout page. <b>2017-07-20:</b> Version 1.9.0 of Stencil's default Cornerstone theme is now available. This release provides two new region tags (see next entry below); provides a new Theme Editor check box to toggle on/off the display of `Shop by Price` facets; and reduces the size of theme bundles by minifying two JavaScript libraries. It also corrects several display bugs. For details, please see the [Cornerstone 1.9.x release notes](/docs/cornerstone-19x-theme-release-notes#182). <b>2017-07-20:</b> Two template files include new _region tags_ to support the placement of payments banners. The&#160;`.../templates/components/common/header.html` template now includes a `header_bottom` region tag, and the `.../templates/components/products/product-view.html` template now includes a `product_below_price` region tag. (MERC-2436; PR # [1023](https://github.com/bigcommerce/cornerstone/pull/1023); commit # [2328e7a](https://github.com/bigcommerce/cornerstone/pull/1023/commits/2328e7a78c47cee59feb80326acfb9f653bbb930)) <b>2017-07-18:</b> Version 1.8.2 of Stencil's default Cornerstone theme is now available. This release provides several new options for displaying products, enables the use of third-party gift certificates (see next entry below), and corrects the "Down for Maintenance" page's styling. For details, please see the [Cornerstone 1.8.2 release notes](/docs/cornerstone-18x-theme-release-notes#182). <b>2017-07-18:</b> We have relaxed gift certificates' format validation. This allows imported third-party gift certificates, in arbitrary formats, to be valid on BigCommerce storefronts. (STENCIL-3533; PR # [1026](https://github.com/bigcommerce/cornerstone/pull/1026), commit # [2cc4bde](https://github.com/bigcommerce/cornerstone/pull/1026/commits/2cc4bde25b0ef047ee7bc9debca3f78b5367aff5)) <b>2017-07-18:</b> `Quick View` links can now be displayed over products in list view. As in grid view, these links' visibility will now toggle on/off according to the storewide control-panel setting. (PR # [1033](https://github.com/bigcommerce/cornerstone/pull/1033); commit # [769b9b5](https://github.com/bigcommerce/cornerstone/pull/1033/commits/769b9b5cc3b485b45b02f4d23ee54ea39db63d7f)) <b>2017-07-14:</b> Stencil CLI's new [`stencil push`](/docs/bundling-submitting#push) command allows theme developers (with appropriate OAuth tokens and scopes) to upload bundled themes directly to a BigCommerce store from the command line. This command bypasses the BigCommerce control panel. For detailed prerequisites and usage instructions, please see our documentation on [Uploading Your Theme](/docs/bundling-submitting#upload). <b>2017-07-14:</b> The [`stencil push`](/docs/bundling-submitting#push) command (see the entry above) relies on BigCommerce's new Themes API. For&#160;details on using this API to programmatically manage store themes, please see our [API documentation](https://developer.bigcommerce.com/api/v3/openapi-v3.html#a-name-themes-a-themes-api). <b>2017-06-16:</b> We have added new documentation on best practices for [synchronizing custom themes with updates ](/docs/theme-updates-sync)in Stencil's Cornerstone reference theme. <b>2017-06-15:</b> For developers who must still rely on Legacy API accounts (Basic Authentication) instead of the OAuth&#160;tokens that we now recommend, we have enabled workarounds for [creating](/docs/creating-an-api-account), [copying](/docs/copying-a-token-to-initialize-stencil), and [authenticating](docs/initializing-stencil) Legacy&#160;API accounts/tokens. <b>2017-06-08:</b> Our documentation now includes a [Getting Started/Transition Guide](/docs/getting-started-guide) for theme developers migrating to Stencil from other theming platforms (including Blueprint) and for designers used to working directly in HTML/CSS. This Guide includes a basic mapping of [Blueprint to Stencil features](/docs/getting-started-guide#map). <b>2017-05-31:</b> As of Stencil CLI version 1.10.0, the [`stencil init`](/docs/initializing-stencil) command requires that you generate any new API accounts/tokens as OAuth. For details on this new procedure, please see our revised documentation starting at [Creating an API Account](/docs/creating-an-api-account). (For themes that you have already initialized/authorized, the [`stencil start`](/docs/running-stencil-locally) command still supports [Legacy API accounts/tokens](https://support.bigcommerce.com/articles/Public/Legacy-API-Accounts) that rely on Basic Auth.) <b>2017-05-10:</b> Version 1.8.1 of Stencil's default Cornerstone theme is now available. This release adds a new "administrative bar" to Theme Editor, and to the store owner's view of a pre-launched store. These administrative bars offer faster, more consistent navigation, along with less-obstructed views of the storefront. For details, please see the [Cornerstone 1.8.x release notes](/docs/cornerstone-18x-theme-release-notes). <b>2017-05-09:</b> Our documentation on [Multi-Language Checkout](/docs/multi-language-checkout) configuration options has been expanded and moved to its own page. (These options apply to the Optimized One-Page Checkout and order confirmation templates.) <b>2017-05-04:</b> We have added a new `images` property to the [Common Product Card Model](/docs/common-product-card-model), plus a corresponding new `product.images` [front-matter attribute](https://stencil.bigcommerce.com/docs/front-matter-variables#Front-ref-prod). You can use `images` to define an array of up to five product images, to support rollovers. (MERC-783) <b>2017-04-28:</b> Version 1.7.0 of Stencil's default Cornerstone theme is now available. This release adds support for webpack 2 (see below), and also corrects several bugs that affected page display and customers' submission of product reviews. For details, please see the [Cornerstone 1.7.x release notes](/docs/cornerstone-17x-theme-release-notes). <b>2017-04-28:</b> Stencil now supports the <a href="https://medium.com/webpack/webpack-2-and-beyond-40520af9067f" target="_blank">webpack 2</a> JavaScript build system. By more efficiently excluding unused JavaScript, this webpack upgrade allows store pages to load faster for customers. (STENCIL-3250, STENCIL-3243; PR #964, 961; commits # f7e5d49, 41e6bf7f) <b>2017-04-27:</b> We have added [new documentation](#/docs/optimized-checkout-prereqs) that covers all the steps involved in _Preparing Stencil Themes for Optimized One-Page Checkout_. <b>2017-04-26:</b> In response to partner feedback, the Stencil framework now supports more than 100 new <a href="http://handlebarsjs.com/" target="_blank">Handlebars helpers</a>. These new helpers offer more power in handling strings, arrays, and dates, and in performing calculations within page templates. You can see our complete set of supported helpers on [this newly combined documentation page](/docs/handlebars-helpers-reference). (STENCIL-3323; PR #110, 114, 115, 294; commits # 71b8562, 777179e, 93cee82, 517f681) <b>2017-04-19:</b> We have added new [documentation](/docs/checkout-injection) on how to customize your theme's Optimized One-Page Checkout and order confirmation templates with options like injecting custom JavaScript, injecting scripts for trust seals and ecommerce apps, and applying storewide styling and headers/footers. <b>2017-03-29:</b> Version [1.6.3](/docs/cornerstone-16x-theme-release-notes#163) of Stencil's default Cornerstone theme is now available. This release opens up the Order&#160;Confirmation page for certain editing options. It also corrects the escaping of HTML in product list views, and corrects several display/rendering details for Google AMP (beta) templates. <b>2017-03-23:</b> We have added demonstration videos to the following Stencil documentation pages: [config.json Metadata](https://stencil.bigcommerce.com/docs/configjson-reference), [Navigating the Templates Directory](https://stencil.bigcommerce.com/docs/about-the-templates-directory), [Custom Templates (overview)](https://stencil.bigcommerce.com/docs/custom-layout-templates), [Navigating Stencil Design Assets](https://stencil.bigcommerce.com/docs/css-resources), [Using Custom Fonts](https://stencil.bigcommerce.com/docs/using-custom-fonts), [Using and Updating Icons](https://stencil.bigcommerce.com/docs/updating-icons), and [Invoking Translation Keys](https://stencil.bigcommerce.com/docs/invoking-translation-keys). <b>2017-03-16:</b> Version [1.6.2](/docs/cornerstone-16x-theme-release-notes#162) of Stencil's default Cornerstone theme is now available. This release fixes a 1.6.1 bug that prevented price and weight values on product pages from updating when shoppers selected an option/variant. (STENCIL-3277; PR # 963, commit # 07c684d) <b>2017-03-15:</b> Version 1.6.1 of Stencil's default Cornerstone theme is now available. This release adds support for Google reCAPTCHA v2 and for the Google AMP beta (see the next two entries below). Other enhancements include category menus up to eight levels deep, a new option to switch product display between list view/grid view, and faster loading of images within the active viewport. For details, please see the [Cornerstone 1.6.x release notes](/docs/cornerstone-16x-theme-release-notes). <b>2017-03-15:</b> To deter automated spam submission through storefront pages, Stencil now supports Google [reCAPTCHA v2](https://support.google.com/recaptcha/?hl=en). (STENCIL-2934; PR # 951, commit # 6f70c49) <b>2017-03-15:</b> Stencil's default Cornerstone theme now supports [Google AMP](https://www.ampproject.org/learn/overview/) to accelerate the mobile display of product and category pages, via alternate template files provided in the theme's `.../templates/pages/amp` folder. This is a beta feature for certain users who have opted in, and BigCommerce must specifically enable it for your store. If you would like request to opt into the beta, please contact [Community [at] bigcommerce [dot] com](mailto:Community@bigcommerce.com). (STENCIL-2944; PR # 946, commit # d3af229) <b>2017-03-13:</b> Contributors can now open, and comment on, <a href="https://github.com/bigcommerce/cornerstone/issues" target="_blank">issues</a> on the Cornerstone (formerly Stencil) GitHub repo. <b>2017-03-09:</b> Stencil's `schema.json` and `config.json` files now support a `text` data type. Store administrators can use this Theme Editor type to enter brief text strings, such as customized labels, badge text, and other storefront messaging. (STENCIL-2924) <b>2017-03-06:</b> Stencil CLI now displays specific error details when an npm module is missing, or when other Webpack errors occur. (PR # 950, commit # 586fb47) <b>2017-03-06:</b> Fixed a Stencil CLI bug that caused category links to unexpectedly point to the theme's live store, rather than to corresponding `localhost` pages. (STENCIL-3213) <b>2017-03-05:</b> We have renamed the former "thank-you" page to "order confirmation." For themes based on Cornerstone, the corresponding template's new path/file name is: `<theme-name>/templates/pages/order-confirmation.html.` This also changes the customer-facing URL route from `.../checkout/thank-you` to: `.../checkout/order-confirmation`. <b>2017-03-01:</b> Our Stencil documentation includes new workarounds for customizing [printable invoices](/docs/customizing-printable-invoices), [printable&#160;packing slips](/docs/customizing-printable-packing-slips), and [email templates](/docs/customizing-email-templates). [block:callout] { "type": "info", "title": "New Cornerstone Repo Name and Default Path Name", "body": "As of 2017-03-01, BigCommerce has renamed the GitHub repository for Stencil's base Cornerstone theme from `https://github.com/bigcommerce/stencil` to [`https://github.com/bigcommerce/cornerstone`](). This&#160;change is intended to clarify the distinction between the Cornerstone theme and the underlying Stencil&#160;framework. Earlier links to `https://github.com/bigcommerce/stencil` and its subdirectories should automatically redirect to [`https://github.com/bigcommerce/cornerstone`]().\n\nThis change also means that, by default, the Cornerstone theme now installs to a local directory named `/cornerstone/` rather than `/stencil/`.\n\nWe have updated the Stencil developer documentation to reflect both changes." } [/block] <b>2017-02-28:</b> Version 1.5.3 of Stencil's default Cornerstone theme is now available. (Release notes updated [here](/docs/release-notes-cornerstone-15-theme#153).) For stores that have enabled Optimized One-Page Checkout, this release adds options for customizing discount banners' colors via Theme Editor. It also corrects several bugs affecting review links and other aspects of storefront display and behavior. <b>2017-02-27:</b> Our documentation on [Downloading/Customizing Marketplace Themes](/docs/downloading-and-customizing-marketplace-themes) now covers required setup steps for BitBucket SSH keys. We also document a new, streamlined setup option for Marketplace themes versioned `1.10.0` and above. (These newer theme versions replace the jspm JavaScript build system with Webpack, allowing a leaner setup flow as with Stencil's base Cornerstone theme.) <b>2017-02-24:</b> We have expanded our documentation on [uninstalling/reinstalling Stencil and Node.js](/docs/uninstall-reinstall), to include Windows-specific instructions. <b>2017-02-23:</b> We have upgraded the Autoprefixer CSS library to version 6.7.3. This upgrade will remove the deprecation warnings that have recently appeared in Stencil CLI's console. (STENCIL-3125) <b>2017-02-23:</b> For themes that enable [Optimized One-Page Checkout](https://support.bigcommerce.com/articles/Public/Optimized-Single-Page-Checkout), local changes to a theme's `checkout.html` file now render in the browser. The preconditions are: You must [install](/docs/installing-stencil-cli-1) the current Stencil CLI version; ensure that your `config.json` file's [`meta` > `features` array](/docs/configjson-reference#config-var-meta) includes the `customized_checkout` value; and then [run `stencil bundle` and upload your zipped theme](/docs/bundling-submitting) to a live BigCommerce store. (STENCIL-3192) <b>2017-02-21:</b> New Theme Editor settings enable store administrators to customize colors in Optimized Checkout discount banners. (CHECKOUT-1459; PR # 924, commits # a13f887, ac74e8d, 4f9fd31) <b>2017-02-14:</b> Version 1.5.2 of Stencil's default Cornerstone theme is now available. (Release notes updated [here](/docs/release-notes-cornerstone-15-theme#152).) This release adds a Theme Editor check box to toggle the display of a GeoTrust SSL Seal in the footer. It also corrects carousel display/cropping on wide viewports, clarifies the usage of Theme Editor's `Social Media Icons` controls, and corrects a bug that displayed `Sign Up` links even when store-account creation had been disabled in the control panel. <b>2017-02-07:</b> Version 1.5.1 of Stencil's default Cornerstone theme is now available. (Release notes updated [here](/docs/release-notes-cornerstone-15-theme#151).) This maintenance release corrects a duplicate Quick Search close box in mobile viewports, a redundant Theme&#160;Editor horizontal scroll bar in smaller viewports, and a bug that displayed Gift Certificates options even when gift certificates had been disabled in the control panel. <b>2017-02-07:</b> The public repository for Stencil's default Cornerstone theme now has its own changelog, at [https://github.com/bigcommerce/cornerstone/blob/master/CHANGELOG.md](https://github.com/bigcommerce/cornerstone/blob/master/CHANGELOG.md). (Stencil-3000; PR # 919) <b>2017-02-02:</b> Version 1.5.0 of Stencil's default Cornerstone theme is now available. This release adds several new options for store owners to customize their store's appearance via Theme Editor. These options include displaying sale badges, displaying "as low as $x" pricing, and requiring customer logins for pricing and cart access. This release also corrects the behavior of hashbang links (`#!`), as described [below](#hashbang) in these framework release notes, and corrects the display of product options in Quick View modals. For details, please see the [Cornerstone 1.5.x release notes](/docs/release-notes-cornerstone-15-theme). <b>2017-01-20:</b> We have deprecated the global [`template_file` property](/docs/template-file-property) and replaced it with a new [`template` property](/docs/template-property), which returns correct page types for custom templates files. These return values will be of the form: `pages/custom/brand/...html`, `pages/custom/category/...html`, `pages/custom/product/...html`, and `pages/custom/page/...html`. To pick up this correction, you must [update your Stencil CLI installation](/docs/installing-stencil-cli-1). (STENCIL-2919; PR # 265, commit # 29c039f) <b>2017-01-19:</b> We have upgraded our webpack (JavaScript build system) version from 1.12.14 to 1.14.0, to fix a bug with babel source maps. (PR # 906, commit # 62acced) <span id="hashbang"> <b>2017-01-11:</b> Fixed a bug that prevented the proper loading of pages/resources with hashbang links (links of the form: `http://somedomain.com/#!tag/`). We have corrected this in the source JavaScript by removing the history.js shim and swapping in the HTML5 History API shim. (MERC-1272, STENCIL-2466; PR # 879, 902; commits # 3eaf205, 23fa089) </span> <b>2017-01-10:</b> Version 1.4.2 of Stencil's default Cornerstone theme is now available. (Release notes updated [here](/docs/cornerstone-14x-theme-release-notes#142).) This release replaces the Contact form template's CAPTCHA challenge with a Google reCAPTCHA v1 challenge, to deter spam submissions. (MERC-1637; PR # 901, commit # 9fae25a) <b>2016-12-22:</b> The [Common Product Card Model](/docs/common-product-card-model) now includes a `ratings` property, representing the number of customer reviews that contributed to a product's `rating` value. (MERC-1207; PR # 16508, commit # 00c436d) <b>2016-12-20:</b> The Stencil documentation now includes several new examples of [adding custom JavaScript](/docs/js-api) to your theme – whether your own JavaScript, or third-party modules. <b>2016-12-20:</b> The Stencil documentation now includes instructions on [using and updating a theme's icons](/docs/updating-icons). <b>2016-12-19:</b> The Stencil framework now supports [Optimized One-Page Checkout](https://support.bigcommerce.com/articles/Public/Optimized-Single-Page-Checkout). To enable this option, you must first [update your Stencil CLI installation](/docs/installing-stencil-cli-1), and then ensure that your `config.json` file's [`meta` > `features` array](/docs/configjson-reference#config-var-meta) includes the `customized_checkout` value. For Stencil-specific styling of the Optimized One-Page Checkout page, please see [this entry](/docs/optimized-checkout-customization). (MERC-1553, MERC-1555, MERC-1579; PR # 261, commit # b9e1329) <b>2016-12-19:</b> To enable <a href="https://support.bigcommerce.com/articles/Public/Optimized-Single-Page-Checkout" target="_blank">Optimized One-Page Checkout</a> in your theme, you can now add the new `customized_check_out` value to your [`config.json` file](/docs/configjson-reference#config-theme-meta)'s `meta` > `features` array. (MERC-1579, PR # 261, commit # b9e1329) <b>2016-12-19:</b> The Stencil documentation now includes instructions on enabling and styling the [Apple Pay button](https://stencil.bigcommerce.com/docs/apple-pay-styling) as a checkout alternative. <b>2016-12-05:</b> Version 1.4.1 of Stencil's default Cornerstone theme is now available. (Release notes updated [here](/docs/cornerstone-14x-theme-release-notes#141).) This release corrects a bug that allowed JavaScript to execute in a Cornerstone storefront's search box. (MERC-1537; PR # 883, commit # 143767f) <b>2016-11-21:</b> Version 1.4.0 of Stencil's default Cornerstone theme is now available. This release adds support for Apple Pay, BigCommerce Optimized One-Page Checkout, and other features. For details, please see the [Cornerstone 1.4.x release notes](/docs/cornerstone-14x-theme-release-notes). We have updated the framework's <span class="inline-code"><a href="/docs/configjson-reference">config.json</a></span> and <span class="inline-code"><a href="/schemajson-metadata-for-theme-editor">schema.json</a></span> documentation to cover new options exposed in this Cornerstone refresh. For Optimized Checkout customization options, please see [this new documentation](/docs/optimized-checkout-customization). <b>2016-10-27:</b> Fixed a bug that prevented the display or hiding of SKUs on product cards from obeying the user's control-panel selection at `Store Setup` > `Store Settings` > `Display` > `Product Settings` > `Show Product's SKU?`. (MERC-1206) <b>2016-10-25:</b> For easier navigation within the Stencil documentation, we have promoted the former Attributes/Objects Reference section's contents to five new top-level sections: * [Front-Matter Attributes](/docs/using-yaml-front-matter) * [Handlebars Syntax](/docs/syntax-handlebars) * [Stencil Object Model Reference](/docs/stencil-object-model) * [Event Hooks](/docs/the-stencil-utils-package) * [Conditional-Logic Examples](/docs/conditional-logic-examples) <b>2016-10-24:</b> To troubleshoot Windows-specific issues, we have updated the [Node.js prerequisite's recommended Windows version](/docs/prerequisites-windows#Node+npm_Win) from 0.12.7 to 4.6.1. This change also appears on our [Troubleshooting Your Setup](/docs/troubleshooting#Troubleshooting) page. <b>2016-10-21:</b> Fixed a bug that blocked JavaScript bundling on [downloaded Marketplace themes](/docs/downloading-and-customizing-marketplace-themes), which in turn caused the [`stencil init` command](/docs/initializing-stencil) to fail. (MERC-1238) <b>2016-10-04:</b> Version 1.3.4 of Stencil's default Cornerstone theme is now available. This maintenance release standardizes the IE11 and Edge browsers' display behavior with out-of-stock product options/SKUs. For details, please see the [Cornerstone 1.3.x release notes](/docs/release-notes-cornerstone-13-theme#133). <b>2016-09-27:</b> Version 1.3.3 of Stencil's default Cornerstone theme is now available. This maintenance release standardizes the alignment of payment buttons, and provides a workaround for the IE11 and Edge browsers' display behavior with out-of-stock product options/SKUs. For details, please see the [Cornerstone 1.3.x release notes](/docs/release-notes-cornerstone-13-theme#133). <b>2016-09-23:</b> For faster navigation, we have broken out separate documentation sections for [basic installation](/docs/installing-and-launching-stencil-1) versus [advanced installation options](/docs/advanced-installation-options). In the basic section, we have promoted [store-token instructions](/docs/preparing-your-store-tokens) to a multi-page subsection, and added a new page showing how to [enable Stencil on Blueprint stores](/docs/blueprint-to-stencil) launched before Jan. 26, 2016. In the advanced section, we have added a [visual overview](/docs/stencil-setup-illustrated) of all supported setup flows. <b>2016-09-21:</b> The [common product card object](/docs/common-product-card-model) now exposes a `custom_fields` array. You can use custom fields for purposes like: alternate brand names, merchandising titles for products, product types, "gift idea" indicators, etc. (MERC-785; PR # 15224, commit # bb3e9d4) <b>2016-09-19:</b> Fixed a bug that caused Brands pages to sort by brand ID, rather than alphabetically. (MERC-1105; PR&#160;# 15204, commit # ce7a1f4) <b>2016-09-19:</b> The [Cart Items object](/docs/cart-resources#Cart_Items) now includes an `rrp` property. You can use this to display strikeout pricing, as explained [here](/docs/cart-resources#strikeout). (MERC-786; PR # 15221, commit # 5c8dcb8) <b>2016-09-19:</b> The [common product card object](/docs/common-product-card-model) now provides `stock_level` and `low_stock_level` properties. If you use inventory tracking, you could (hypothetically) build conditional logic to display "limited availability" indicators/badges on your storefront when the `stock_level` value falls below the `low_stock_level` threshold. (MERC-918; PR # 15180, commit # ac445c1) <b>2016-09-19:</b> Fixed a bug that caused brands to sort by ID, rather than alphabetically as intended. (MERC-1105; PR # 15204, commit # ce7a1f4) <b>2016-09-16:</b> The [common product card object](/docs/common-product-card-model) now provides a `sku` property. (MERC-784; PR # 15181, commit # 8c342dc) <b>2016-09-15:</b> The Settings common object's [`{{urls.checkout}}` property](/docs/settings-object) now includes a `multiple_address` key that support multiple shipping addresses. (EAT-1871) <b>2016-09-12:</b> Fixed a bug that prevented Stencil from returning products' [`non_sale_price_without_tax`](/docs/catalog-price-common-object) property. We have also added a new <a href="/docs/price-object-properties">documentation page</a>) outlining how this property interacts with other catalog price properties, and with control-panel price options. (MERC-951, MERC-947; PR # 15111, commit # d2081a3) <b>2016-09-07:</b> Fixed a bug that caused shoppers' `My Account > Your Recent Items` section to appear empty for stores using Shared SSL. MERC-833; PR # 14814) [block:html] { "html": "<b>2016-09-06:</b> Version 1.3.2 of Stencil's default Cornerstone theme is now available. This maintenance release corrects the display of YouTube videos under sitewide HTTPS, and corrects the Cornerstone Bold variation's display of featured products. For details, please see the <a href=\"/docs/release-notes-cornerstone-13-theme#132\">Cornerstone 1.3.x release notes</a>.<br><br>\n\n<b>2016-08-31:</b> You can now reference Stencil Handlebars variables &ndash; and all corresponding <a href=\"/docs/stencil-object-model\">Stencil objects and properties</a> &ndash; in scripts injected into a store’s global footer. You access this feature through the control panel’s <span class=\"inline-code\">Storefront Design &gt; Design Options &gt; Scripts</span> tab, as illustrated in <a href=\"https://support.bigcommerce.com/articles/Public/Adding-Custom-Scripts-to-Stencil-Themes\">this Knowledge Base article</a>. (MERC-902)<br><br>\n\n<b>2016-08-31:</b> <a href=\"/docs/custom-layout-templates\">Custom templates</a> are now generally available for authoring and assignment on all Stencil stores.\n<br><br>\n\n<b>2016-08-22:</b> We have updated our <a href=\"/docs/custom-layout-templates\">custom templates</a> <strike>(beta feature)</strike> documentation to clarify Stencil versus Blueprint options, and to add details and troubleshooting tips on assigning templates to pages.\n<br><br>\n\n<b>2016-08-12:</b> Version 1.3.1 of Stencil's default Cornerstone theme is now available. This maintenance release adjusts some image-size defaults that might have displayed blurry or undersized images on some storefronts. For details, please see the <a href=\"/docs/release-notes-cornerstone-13-theme#131e\">Cornerstone 1.3.x release notes</a>.<br><br>\n\n<b>2016-08-08:</b> We have added a new <a href=\"/docs/download-and-build-scenarios\">documentation subsection</a> to cover three new installation scenarios: downloading a refreshed Cornerstone theme, downloading other Theme Marketplace themes for customization, and configuring a custom build system. We have also updated our <a href=\"/docs/installing-and-launching-stencil-1\">Installing Stencil</a> overview, and our <NOBR><a href=\"/docs/staging-and-submitting-a-theme\">Submitting a Theme</a></nobr> page, to help guide you through these new scenarios.<br><br>\n\n<b>2016-08-04:</b> We have added documentation on using <a href=\"/docs/using-custom-fonts\">custom fonts</a> in your theme.<br><br>\n\n<b>2016-08-04:</b> We have updated our <a href=\"//docs/custom-layout-templates\">custom templates</a> (beta feature) documentation. Key names within the <span class=\"inline-code\">.stencil</span> file are now corrected from plural to singular, and subdirectory names now match those in the <NOBR><span class=\"inline-code\">.stencil</span> file</nobr>.\n<br><br>\n\n<b>2016-08-03:</b> Version 1.3 of Stencil's default Cornerstone theme is now available. This update adds image-resizing options, enhanced faceted/filtered search, and several bug fixes. For details, please see the <a href=\"/docs/release-notes-cornerstone-13-theme\">Cornerstone 1.3.x release notes</a>. We have updated the framework's <span class=\"inline-code\"><a href=\"/docs/configjson-reference\">config.json</a></span> and <span class=\"inline-code\"><a href=\"/schemajson-metadata-for-theme-editor\">schema.json</a></span> documentation to cover new options exposed in this Cornerstone refresh.<br><br>\n\n<b>2016-08-03:</b> Fixed a bug that disabled buttons in the Quick View overlay that shoppers launch from home-page product images. (MERC-893; PR # 820, commit # edb65eb)<br><br>\n\n<b>2016-08-03:</b> For shoppers performing faceted searches, the Cornerstone theme can now display up to 500 values per facet, through the \"More+\" link. (MERC-75; PR&nbsp;# 794, commit #'s 92a62fa, fc7bad1)<br><br> \n\n<b>2016-08-03:</b> Merchants can now use Theme Editor to resize logo and product images. (MERC-608, MERC-616; PR&nbsp;#797, commit #'s 247a133, 0e9ac23, f963775, 6798423)<br><br>\n\n<b>2016-08-03:</b> The <a href=\"/docs/front-matter-variables#Front-ref-brandlist\">brands</a> front-matter parameter now limits the Brands list to a maximum of 50 brands. Also, the <span class=\"inline-code\">&lt;theme-name&gt;/templates/pages/brands.html</span> template now paginates the displayed Brands list; the default pagination value is also 50 brands per page. (MERC-725; PR&nbsp;#813, commit # 816c7fa)<br><br>\n\n<b>2016-08-03:</b> Fixed a bug that displayed a A blank white page with an \"Array\" message, rather than a standard 404 page, in response to URLs for brands missing from a store. (MERC-767<!--; PR # #13783, commit #'s 40c121e, f05d791-->)<br><br>\n\n<b>2016-08-03:</b> Fixed a bug that stretched small product images to fill the allotted display area, leading to blurry product images on the product details page and in product galleries. (MERC-888; PR&nbsp;# 817, commit # 697334e)<br><br>\n\n<b>2016-07-29:</b> We have consolidated the <span class=\"inline-code\">Price</span>, <span class=\"inline-code\">Catalog Price</span>, <span class=\"inline-code\">Stencil Image</span>, and <span class=\"inline-code\">Common Product Card Model</span> documentation in a new <a href=\"/docs/common-object-formats\">Common Objects</a> subsection. We have also clarified how these objects can be accessed within the Stencil framework; and we have updated the descriptions of certain properties on the <a href=\"/docs/global-objects\">Global Objects</a> and <NOBR><a href=\"/docs/cart-resources\">Cart Objects</a></nobr> pages.<br><br>\n\n<b>2016-07-26:</b> Fixed a bug that caused the <span class=\"inline-code\">theme_settings</span> context variable to fail to carry over from developers' local environments to production stores. (MERC-891<!--, PR # 14281, 14421; commit # fd6c25d, 35a9e63, 780024d, 1143f41, \t9f7360d, c7c2b0c, 1e25c55M-->)<br><br>\n\n<b>2016-07-26:</b> We have updated several documentation pages to clarify that <a href=\"/docs/using-yaml-front-matter\">front matter</a> can be invoked only on templates in a theme's <span class=\"inline-code\"><a href=\"/docs/pages-subdirectory\">/templates/pages/</a></span> subdirectory.<br><br>\n\n<b>2016-07-26:</b>: Fixed a faceted-search bug that prevented the sidebar's <NOBR>\"Selected Facets\"</nobr> block from refreshing to show filters that a shopper has newly selected from the <span class=\"inline-code\">More+</span> modal window. (MERC-875; PR #'s 14460, 14495, commit #'s 9866762, 20dc6de, 5849869, 77cd541) <br><br>\n\n<b>2016-07-21:</b>: Fixed a bug that caused logo images to be resized upon upload, even when users de-selected the <span class=\"inline-code\">Yes, automatically resize my logo...</span> option. (MERC-771; PR&nbsp;# 14301, commit # f9b7fb1) <br><br>\n\n<b>2016-06-15:</b> Updated Stencil CLI's <span class=\"inline-code\">package.json</span> file to correct references to the <span class=\"inline-code\">angular-gettext</span> dependency. (PR&nbsp;# 231, commit # f521043)<br><br>\n\n<b>2016-06-07:</b> Fixed a bug that, for themes bundled on Windows, caused front-matter statements to display on store pages. (MERC-710; PR&nbsp;# 344, commit #'s f88854c, 4a816f2)<br><br>\n\n<b>2016-05-27:</b> Fixed a bug that prevented themes from properly bundling on Windows. This caused the resulting theme .zip files to fail uploading via the control panel. (MERC-683' PR #'s 223, 224; commit #'s ae4d5c3, 3e15416, 779d684, 8cc4668)<br><br>\n\n<b>2016-05-27:</b> Fixed a bug that blocked Theme Editor users from recording changes to variations. The symptom was that clicking the <nobr><span class=\"inline-code\">Save Changes</span></nobr> or <nobr><span class=\"inline-code\">Apply Theme</span></nobr> button displayed the error message: \"There was an error with your request.\" (MERC-700)<br><br>\n\n<b>2016-05-27:</b> Fixed a bug that blocked Theme Editor from loading after a merchant disabled site-wide HTTPS. (MERC-641)<br><br>\n\n<b>2016-05-27:</b> Fixed a bug that prevented the <span class=\"inline-code\">cart.suggestions</span> <nobr><a href=\"https://stencil.bigcommerce.com/docs/front-matter-variables#Front-ref-cart\">front-matter attribute</a></nobr> and the <span class=\"inline-code\">suggested_products</span> <nobr><a href=\"https://stencil.bigcommerce.com/docs/cart-resources#Suggested\">Cart object</a></nobr> from properly displaying suggested products, based on current cart contents. Also, we are deprecating the duplicate <span class=\"inline-code\">suggestive_products</span> object previously listed in the <nobr><a href=\"https://stencil.bigcommerce.com/docs/cart-resources\">Cart objects</a></nobr> documentation, although this object is still supported in the Stencil framework. (MERC-722)<br><br>\n\n<b>2016-05-12:</b> Version 1.2 of the Stencil Cornerstone theme is now available, adding a new logo-positioning option. For details, please see <a href=\"https://developer.bigcommerce.com/blog/changelog/themes-stencil-cornerstone-1-2\">this changelog entry</a>.<br><br>\n\n<b>2016-05-12:</b> Fixed a bug that prevented the home-page carousel from displaying a left navigation arrow. (MERC-691)<br><br>\n\n<b>2016-05-12:</b> Fixed a bug that prevented the top-left hamburger menu from opening on mobile displays. (MERC-662)<br><br>\n\n<b>2016-05-12:</b> Fixed a bug that prevented shoppers from increasing the quantity of cart items on mobile displays. (MERC-684)<br><br>\n\n<b>2016-05-06:</b> Custom/private theme uploads are now available. For details, please see <a href =\"https://support.bigcommerce.com/articles/Public/Custom-Theme-Upload\">this Knowledge Base article</a> and <a href =\"/docs/uploading-a-custom-theme\">this troubleshooting page</a>.<br><br>\n\n<b>2016-04-27:</b> Fixed a bug where enabling faceted search caused only one product to display on listing pages like Categories and Brands. The single-product display occurred regardless of the actual number of products, and regardless of the display configuration. (MERC-670)<br><br>\n\n<b>2016-04-22:</b> A new <a href =\"/docs/front-matter-variables#Front-ref-global\">front-matter attribute</a> named <span class=\"inline-code\">categories:description</span> is available. This boolean's value indicates whether to dynamically retrieve category descriptions.<br><br>\n\n<b>2016-04-19:</b> BigCommerce has simplified installation of the Stencil framework: We no longer require the jspm package manager as a dependency. We have made corresponding updates to our installation <a href=\"/docs/prerequisites\">prerequisites</a> and <a href=\"/docs/javascript-utilities\">instructions</a>, related <a href=\"/docs/troubleshooting\">troubleshooting</a> info, and related examples.<br><br>\n\n<b>2016-04-16:</b> When a merchant switched from a Blueprint theme, some Stencil themes incorrectly reported that product filtering was unsupported. This incorrect notification no longer appears. (MERC-406)<br><br>\n\n<b>2016-04-14:</b> A new <a href =\"/docs/front-matter-variables#Front-ref-global\">front-matter attribute</a> named <span class=\"inline-code\">categories</span> is available. This boolean's value indicates whether to retrieve the category tree during an AJAX request.<br><br>\n\n<b>2016-04-14:</b> A new <a href =\"/docs/custom-handlebars-helpers\">custom Handlebars helper</a> named <span class=\"inline-code\">or</span> is available. It accepts parameters of different types, and renders a Handlebars block if at least one passed parameter evaluates to true.<br><br>\n\n<b>2016-04-04:</b> Fixed a bug that caused oversized date fields on checkout pages. (MERC-414)<br><br>\n\n<b>2016-04-01:</b> A new <a href =\"/docs/custom-handlebars-helpers\">custom Handlebars helper</a> named <span class=\"inline-code\">all</span> is available. It accepts parameters of different types, and renders a Handlebars block if all passed parameters evaluate to true.<br><br>\n\n<b>2016-03-29:</b> Fixed a bug where Stencil stores displayed an HTTP <span class=\"inline-code\">500 Internal Server Error</span> page, instead of storefront pages, when an invalid country locale was configured. (MERC-491)<br><br>\n\n<b>2016-03-29:</b> The global <a href=\"/docs/settings-object\">Settings</a> object now provides a <span class=\"inline-code\">{{blog_enabled}}</span> property. Its boolean value indicates whether the blog is visible for this store. (MERC-393)<br><br>\n\n<b>2016-03-22:</b> Within the <a href =\"/docs/cart-resources#Cart_Items\">Cart Items</a> object's bulk_pricing <span class=\"inline-code\">bulk_pricing</span> child object, the <span class=\"inline-code\">discount_amount</span> and <span class=\"inline-code\">discount_percentage</span> properties are now mutually exclusive, as designed. Merchants can set either a discount amount or a discount percentage on a product. If an <span class=\"inline-code\">amount</span> is set, the <span class=\"inline-code\">percentage</span> will be null, and vice versa. (MERC-147)<br><br>\n\n<b>2016-03-04:</b> When creating a theme bundle, Stencil CLI will now detect cyclical dependencies between templates, and will display a corresponding error message. (MERC-96)<br><br>\n\n<b>2016-03-22:</b> Theme developers can now customize the style of a theme's Thank You page, using the <span class=\"inline-code\">checkout.scss</span> stylesheet described <a href=\"/docs/checkout-header-customization\">here</a>. (MERC-366)<br><br>\n\n<b>2016-03-22:</b> Fixed a bug where disabling gift certificates in a theme left a valueless radio button visible on the storefront, even if the merchant later re-enabled gift certificates. (MERC-415)<br><br>\n\n<b>2016-03-22:</b> Fixed a bug where selecting certain faceted-search filters broke search results, with symptoms like spurious zero results or hidden filters. The affected filters included <span class=\"inline-code\">has free shipping</span>, <span class=\"inline-code\">is featured</span>, and <NOBR><span class=\"inline-code\">in stock</span>.</nobr> (MERC-420)<br><br>\n\n<b>2016-03-15:</b> The Stencil framework, and its default theme, now respect control-panel selections to hide out-of-stock products and options from the storefront. (MERC-295)<br><br> \n\n<b>2016-03-09:</b> Faceted-search results now correctly reflect a shopper's selected product ratings. (MERC-162)<br><br> \n\n<b>2016-03-08:</b> Faceted-search results now correctly reflect a shopper's selected Shop by Price range, and correctly display that selection in the faceted-search panel. (MERC-103)<br><br>\n\n<b>2016-03-07:</b> The <a href=\"/docs/category-resources#Category\">Category</a> object's <span class=\"inline-code\">{{category.subcategories}}</span> child object now includes a <span class=\"inline-code\">product_count</span> property. This property's value matches the number of products in the subcategory (at the current level only, with no recursive counting of nested levels). (MERC-320)<br><br>\n\n<b>2016-03-03:</b> Fixed a bug that prevented some store pages from loading when certain strings were passed to the <span class=\"inline-code\"><a href=\"/docs/invoking-translation-keys\">lang</a></span> Handlebars helper. (MERC-382)<br><br>\n\n<b>2016-03-01:</b> Fixed a checkout bug where a shopper could be sent through the multi-step checkout path, instead of the single-page checkout path. (MERC-65)<br><br>\n\n<b>2016-02-29:</b> The BigCommerce control panel's <span class=\"inline-code\">Enable Mobile Theme</span> check box applies only to Blueprint themes. Fixed a bug where Stencil themes did not display the responsive checkout page when this flag was checked. (BIG-26312)<br><br>\n\n<b>2016-02-29:</b> A new <span class=\"inline-code\">config.Email</span> <a href=\"/docs/checkout-objects#cfg.Email\">variable</a> contains a logged-in customer's email address. You can use this value for checkout-page personalization, analytics, abandoned-cart messages, and other marketing campaigns. (MERC-322)<br><br>\n\n<b>2016-02-29:</b> The <a href =\"/docs/cart-resources#Cart_Items\">Cart Items</a> object now exposes a <span class=\"inline-code\">bulk_pricing</span> child object to manage <NOBR><a href =\"https://support.bigcommerce.com/articles/Public/How-do-I-create-bulk-discount-pricing-for-my-products\">bulk discounts</a>.</nobr> This new object provides properties representing a cart item's base price, bulk discount amount, and bulk discount percentage. (MERC-147)<br><br>\n\n<b>2016-02-26:</b> Merchants can now display any Web page as the store's home page, by using the control panel's <span class=\"inline-code\">Content</span> > <NOBR><span class=\"inline-code\">Web Pages</span></nobr> > UI to access and select that page's <span class=\"inline-code\">Display as Home Page</span> option. (MERC-291)<br><br>\n\n<b>2016-02-22:</b> We have updated the <a href =\"/docs/product-resources#Product\">Product</a> object's <span class=\"inline-code\">{{product.customizations}}</span> child object to better match configurable fields in the BigCommerce control panel. This object's numeric properties (available when <span class=\"inline-code\">{{product.customizations.type}}</span> value = <span class=\"inline-code\">NumbersOnlyText</span>) can now pass minimum and maximum values; and can now accept floating-point/decimal and zero values, in addition to positive integer values. (MERC-159 and MERC-160)<br><br>\n\n<b>2016-02-22:</b> The <a href=\"/docs/category-resources#Category\">Category</a> object's <span class=\"inline-code\">{{category.subcategories}}</span> child object now provides three new properties: <span class=\"inline-code\">id</span>, <span class=\"inline-code\">description</span>, and <span class=\"inline-code\">image</span>. These correspond to the identically named properties of the parent <span class=\"inline-code\">{{category}}</span> object, allowing your themes to access similar data at the <span class=\"inline-code\">subcategories</span> level. (MERC-268)<br><br>\n\n<b>2016-02-22:</b> The <a href=\"/docs/product-resources#Product\">Product</a> object now provides a <span class=\"inline-code\">{{product.options}}</span> child object. This object's properties allow themes to access colors, patterns, display names, and other aspects of swatches that represent product options. Also, maximum swatch dimensions have been expanded to 150 x 150 pixels. (MERC-81)<br><br>\n\n<b>2016-02-15:</b> The global <a href=\"/docs/settings-object\">Settings</a> object now provides a <span class=\"inline-code\">{{settings.client_ip_address}}</span> property, which fetches the IP address of the shopper browsing the store. (MERC-232)<br><br>\n\n<b>2016-02-12:</b> The shipping estimator for cart items now properly displays a merchant-customized Out of Delivery Zone Message, rather than a generic message. (MERC-112)<br><br>\n\n<b>2016-02-10:</b> The global <a href=\"/docs/catalog-price-common-object\">Catalog Price</a> object now contains <span class=\"inline-code\">{{non_sale_price_with_tax}}</span> and <span class=\"inline-code\">{{non_sale_price_without_tax}}</span> properties. During sale events, these can be used to display a store's standard prices, alongside the sale and list prices. (MERC-63)<br><br>\n\n<b>2016-02-10:</b> The global <a href=\"/docs/settings-object\">Settings</a> object now contains a <span class=\"inline-code\">{{settings.measurements}}</span> object. Its child <span class=\"inline-code\">{{length}}</span> and <span class=\"inline-code\">{{weight}}</span> properties define units of measure, corresponding to control-panel options. (MERC-66)<br><br>\n\n<b>2016-02-10:</b> The <a href=\"/docs/cart-resources#Cart\">Cart</a> object now has a <span class=\"inline-code\">{{cart.selected_city}}</span> property, for the city/town that a customer selects for shipping estimates. In Stencil's default Cornerstone theme, the shipping-estimator step now prompts the shopper for the shipping city. (BIG-25579)<br><br>\n\n<b>2016-02-02:</b> You can now access the Customer Group Name and Customer ID through the <a href=\"/docs/customer-resources#Customer\">Customer</a> object's <span class=\"inline-code\">{{customer.customer_group_name}}</span> and <span class=\"inline-code\">{{customer.customer_group_id}}</span> properties. (BIG-25631)<br><br>\n\n<b>2016-01-28:</b> When setting a Date Range in the control panel, merchants can now freely specify their intended earliest and latest dates or ranges, including years. (BIG-25712)<br><br>\n\n<b>2016-01-28:</b> Stencil themes now support images up to 4096 x 4096 pixels. (BIG-25388)<br><br>\n\n<b>2016-01-28:</b> You can now access the SKU for items in the cart through the <a href =\"/docs/cart-resources#Cart_Items\">Cart Items</a> object's <NOBR><span class=\"inline-code\">{{cart.items.sku}}</span> property.</nobr> (BIG-25758)" } [/block]