Develop Storefront

The official Storefront development blog

Storefront 2.1.1 — September 2, 2016

Storefront 2.1.1

Storefront 2.1.1 has been tagged for release and will be available to download from very soon.

2.1.1 is a minor release that includes the following fixes / improvements;

  • Fix – Changed some customizer settings transport from postMessage to refresh for live preview of changes.
  • Fix – Secondary navigation dropdown styling.
  • Dev – Restructured the way objects are initiated. Objects are now initiated into an accessible global $storefront for access to hooks. Kudos @jtsternberg.

The biggest change is how we now initiate objects. You can easily access hooks inside objects using the $storefront global. You can find a practical example here.

Storefront 2.1.0 is now available to download — August 24, 2016

Storefront 2.1.0 is now available to download

Screen Shot 2016-08-24 at 12.32.38

Storefront 2.1.0 has just been tagged for release an uploaded to That means it should be available to download very soon!

2.1.0 is a major release and comes roughly 3 months after our last major release 2.0.0. It’s a significantly ‘lighter’ release (although still packed with flavour) which should mean less bugs and less potential for breakage. That said, I’d like to remind everyone that this is a major release. You should not update live sites without adequate testing.

What’s in the box

Rather than repeat myself I’d suggest you read the original 2.1.0 outline post which includes all of the details of this release. For the condensed version, here’s the relevant info pulled directly from the changelog;

  • New – Lots of SEO enhancements.
  • New – Selective refresh on site title, tag line, logo and widgets.
  • New – Integration with Advanced Product Labels extension.
  • New – Integration with WooCommerce Mix and Match extension.
  • New – Integration with WooCommerce Quick View extension.
  • Fix – Product thumbnail size on cart page.
  • Fix – Sticky order review position on RTL stores.
  • Dev – Restructured scss; removed components/typography and added main styles to `assets/sass/base/_base.scss`. Layout styles then added to `assets/sass/base/_layout.scss`. Moved WooCommerce extension integration styles to `assets/sass/woocommerce/extensions/`.

I’m particularly excited about the SEO enhancements we’ve made (major Kudos to Clément) and am keen to see the results. You can read more about what how we’ve improved Storefront SEO in this post.


You can download Storefront now from your dashboard or from


If you’re updating an existing store to Storefront 2.1, as mentioned previously; please test the update in a development environment first. If you are using any additional Storefront products (child themes and/or extensions) be sure to check for updates for them before updating Storefront and test everything in your development environment.

I’ll say it one more time; test the update(s) in a development environment. 🙂

I found a bug

If you find a bug then as always, please be sure to report it on github. If you have any other problems with Storefront please post on the support forum, or contact us if you’re a WooCommerce customer.

Storefront 2.1.0 beta — August 15, 2016

Storefront 2.1.0 beta


TL;DR – Storefront 2.1 beta is here. You can download it here. Please open issues on github.

Storefront 2.1.0 has been tagged for testing on github! At ~60 commits we’ve kept the next major iteration of the Storefront theme a third of the size of the last release. Whilst 2.0.0 was a great release, we’re still keen to streamline our major releases and keep them focused on fewer new features.

The highlights reel of 2.1 looks like this;

  • Lots of SEO enhancements
  • Selective refresh
  • New integrations with extensions

Each of these features is discussed in more detail in the 2.1 outline post.

Things to look out for

As I said, we’ve kept the feature list small to reduce the likelihood of breakage when you update. There is however one change which could potentially cause issues.

Header layout

We’ve tweaked the markup for the site title / tagline / logo so that component is now always wrapped in a the .site-branding div. Previously if a logo was present it wasn’t wrapped. This seemingly minor change improves consistency but can potentially cause issues with your header layout if you’ve added custom css or are using a third party child theme/plugin.

Many of our child themes were affected by this so we’ve released updates for those that were. Before testing this release I highly recommend checking if there’s a child theme update available (if you’re using one of our child themes).


You can download the 2.1 beta here.

I found a bug

As always, please open an issue on github. Assuming this beta goes smoothly we’ll probably go straight to an RC and release fairly quickly.

Storefront 2.1 development begins — August 2, 2016

Storefront 2.1 development begins

Storefront 2.1 development begun last week. Whilst a major release, 2.1 won’t be anywhere near the scale of 2.0. Moving forwards we’d like to keep our major releases smaller, more focused and more regular. That means fewer (potentially) breaking changes per release and more predictability in terms of release dates.

This post outlines the areas we’re planning to work on and improve.

SEO enhancements

Originally, Storefront templates were based almost entirely on the Underscores equivalents which themselves were based on standards in and around the WordPress development community. Much of this is, and has been a good foundation. However, we’d already made many tweaks that should have a positive impact on Storefronts SEO performance. Here’s what we’re doing/have done for 2.1;

Structural outline

Ensure we’re using appropriate tags for content layout. This applies mainly to Storefront specific templates, posts and pages. As a part of this tag review we’ve majorly adjusted widget markup and content wrappers on single posts / pages.

Heading level outline

The headings in Storefront are a little messy to say the least. We’re of the opinion that most stores will want product titles / content to be the most heavily weighted for search so we’re working to ensure that’s the case!

Ergo, lots of content that is currently wrapped in headings such as navigation / widget titles are being wrapped in plain old divs and spans instead. We’ll also be making sure that all pages adhere to the expected heading structure.

By and by this will all make Storefront perform better from an SEO perspective and give Storefront shops a leg-up over the competitors!

New extension integrations

One of the best features of Storefront is the unique integrations with many WooCommerce extensions it provides. In 2.1 we’ll be adding integrations for;

Sass refinement

Finally we plan to tidy up our Sass. This will come in two parts;

Part 1; simplify

We have a lot of .scss files in Storefront. Arguably too many with one for each structural component. This also leads to confusion as each component stylesheet includes a media query providing styles to desktop browsers for that component. But we also have a layout stylesheet which is performing a similar role. To simplify, we’ll be rolling those component stylesheets (most of which are very small) into a single stylesheet and moving the desktop styles for those components into the main layout stylesheet.

Part 2; Dynamize the modular scale

Dynamize is a word, who knew? Anyway, all the values used in Storefront typography and layout are based on a Modular Scale. That’s all those seemingly random instances of 1.618em etc that you will have no doubt noticed if you’ve worked with Storefront before. We plan to introduce modularscale-sass which will allow the use of variables for our entire typographical scale and layout. It will also provide 100% accuracy in values and allow developers to quickly and easily try different scales without doing big find/replaces.

All-in-all these changes will make the Storefront sass much more intuitive to work with.

When will it be ready?

As we did with 2.0 we’ll likely run a short beta for 2.1. Overall we’re aiming for a Q3 release.

As always, if you’re keen to help out with Storefront dev, please get involved on github!

Storefront 2.0.7 — July 28, 2016
Storefront 2.0.6 — July 22, 2016

Storefront 2.0.6

It’s time for another minor Storefront release, 2.0.6 has landed. The main fix in this releases addresses a quirk in the menus on handheld devices where if no menu is assigned to the primary menu location, all page links would appear along with the handheld specific menu.

Full details below;

2016.07.22 – 2.0.6

  • Fix – Added missing laser card icon.
  • Fix – Additional menu displayed on handheld when a menu isn’t assigned to the ‘primary’ location.
  • Fix – Structured data sanitization.
  • Fix – Photography extension layout on handheld devices.
  • Tweak – Product Bundles integration tweaks.
  • Tweak – Updated all docs links to point to
  • Dev – Made storefront_primary_navigation_wrapper() andstorefront_primary_navigation_wrapper_close() pluggable.
Storefront 2.0.5 — July 5, 2016

Storefront 2.0.5

Storefront 2.0.5 has arrived! Once again it’s a small release containing a few minor fixes. Updates should run very smoothly.

The main things we’ve fixed are some styling issues on the checkout. In particular saved payment methods and credit card input fields.

We’ve also tweaked the secondary navigation markup so that it’s wrapper is no longer output if a menu isn’t assigned to that location.

Finally we’ve fixed the styling of product loops displayed in widgets which were adopting underlined links which was inconsistent with product display through the rest of the theme.

Storefront 2.0.4 — June 14, 2016

Storefront 2.0.4

Earlier today we uploaded Storefront 2.0.4 and it should be available for download very soon.

2.0.4 is a minor release including a few bug fixes and tweaks. The most important fix is for an issue we accidentally introduced in 2.0.2. A function was removed but not deprecated which meant that child themes overriding a particular template (in this case header.php) were seeing fatal errors. storefront_html_tag_schema() has now been correctly deprecated which resolves this issue.

Another fix in this release is for an edge case where folks were using the secondary nav as their primary navigation. The issue was that they were assigning an empty menu to the primary location (to hide it on desktop), but this was hiding the handheld navigation as well.

There’s also fixes for credit card input labels on the checkout, the $content_width declaration and tweaks for the footer / handheld nav bar.

2016.06.14 – 2.0.4

  • Fix – Credit card input label styling.
  • Fix$content_width declaration.
  • Fix – Mobile menu when using an empty menu in the primary menu location.
  • Tweak – Minor style fixes / improvements for various WooCommerce extensions.
  • Tweak – Account / Cart links in the handheld nav bar will only appear if the pages are set in WooCommerce.
  • Tweak – Footer padding on handheld devices.
  • Tweakpre background color to ensure legibility when displayed in messages.
  • Dev – Deprecate storefront_html_tag_schema().


Storefront 2.0.3 — June 2, 2016

Storefront 2.0.3

Today we had to release a minor patch for yesterday’s 2.0.2 release. Say hello to Storefront 2.0.3!

We quickly discovered an issue with our data structure refactor that caused a fatal error if you were using Storefront without WooCommerce. Whilst we feel that this affects a vast minority of users we still wanted to release a patch asap.

2.0.3 has been uploaded to and will be available for download very soon.

2016.06.02 – 2.0.3

  • Fix – Fatal error when using Storefront without WooCommerce.
Storefront 2.0.2 — June 1, 2016

Storefront 2.0.2

Storefront 2.0.2 has been tagged for release and will be available to download from very soon.

2.0.2 is a minor release that includes the following fixes / improvements;

  • Fix – Correct CSS property applied to the header if no background image is present.
  • Fix – Sticky order review + Checkout Add-ons compatibility.
  • Fix – Active link color when using the Custom Menu widget in the sidebar.
  • Fix – Store notice no longer hidden by the handheld nav bar.
  • Fix – Some errors in structured data. Kudos @opportus.
  • Dev – Added storefront_sticky_order_review filter.
  • Dev – Added storefront_structured_data filter for structured data customisation.

The biggest change is how we apply structured data. It’s now all put in one place using JSON-LD. This provides a better structure for the data (duh) and consequently cleans up markup for posts / pages etc. This data can also be filtered using the storefront_structured_data filter.

In addition to this there are just a few minor fixes including compatibility between our sticky order review feature and the Checkout Add-ons extension, as well as compatibility between the store notice and the handheld nav bar.