Develop Storefront

The official Storefront development blog

New blog location — January 16, 2018

New blog location

From now on, we will be posting Storefront announcements to the WooCommerce core blog. This will be the last post to be published on this blog.

Storefront is the official theme for WooCommerce and this change should increase the visibility of the project.

By the way, Storefront 2.2.6 was just released. ūüėČ

Storefront 2.2.5 — August 21, 2017

Storefront 2.2.5

Storefront 2.2.5 has been tagged for release and uploaded to

Here’s what’s changed¬†pulled directly from the changelog:

  • New¬†– Add access to submenus from touchscreen devices. Kudos¬†@mikeyarce.
  • New¬†– Add styles for keyboard navigation on focus items. Kudos¬†@mikeyarce.
  • Fix¬†– Fix hero image positioning when page has RTL direction.
  • Tweak¬†– Remove non-minified vendor script:¬†rgbaster.js.
  • Tweak¬†– Enqueue non-minified versions of scripts when¬†SCRIPT_DEBUG¬†is defined.
  • Dev¬†– New hook to filter sidebar regions:¬†storefront_sidebar_args.
  • Dev¬†– Adds¬†grunt-contrib-compress¬†to the build process.
  • Fix¬†– Remove 4th parameter being passed to¬†remove_action, it only accepts 3. Kudos¬†@ashfame.
  • Fix¬†– Limit product name cell to¬†300px¬†in the order review table.
  • Fix¬†– Check header cart contents length on¬†mouseover¬†to dynamically check if the height needs to be limited.
  • Tweak¬†– Removed Structured Data. See¬†this comment.
  • Fix¬†– Header cart dropdown padding.
  • Fix¬†– Updated demo store notice¬†z-index¬†value to¬†9999¬†to prevent conflicts with other elements. Kudos¬†@iamdharmesh.
  • Tweak¬†– Replace WooThemes with WooCommerce.
Storefront 2.2.4 — June 27, 2017

Storefront 2.2.4

Storefront 2.2.4 has been tagged for release and uploaded to

Here’s what’s changed¬†pulled directly from the changelog:

  • Fix – Notice styling in the payment section of the checkout.
  • Fix – Fix several typos in the theme description and customizer controls.
  • Fix – Remove :hover¬†and :active¬†states on .screen-reader-text.
  • Fix – Hide logo section from structured data if there’s no image.
  • Dev – New hook after body tag: storefront_before_site.
  • Fix – Fix modular scale negative values not being compiled correctly.
  • Tweak – Open documentation links in a new window.
  • Fix – Translatable labels in the 404 template.
  • Fix – Localize all aria labels.
  • Dev – Remove wp_kses_post()¬†from shortcodes output.
  • Fix – Amend support link in admin header to link to the support forum.
Storefront 2.2.0 is now available to download — May 22, 2017

Storefront 2.2.0 is now available to download


Storefront 2.2.0 has just been tagged for release an uploaded to That means it should be available to download very soon! This is a major release, you should not update live sites without adequate testing.

What’s in the box

Please read the previous 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 – Adding a featured image to the homepage template will now create a ‘hero’ component.
  • New – Improved new user experience; WooCommerce installation prompted and added starter content to set up the homepage template, menus, widgets and add some demo products.
  • New – Guided tour in the Customizer.
  • Fix¬†– Remove unnecessary button styling in WooCommerce Quick View extension.
  • Fix – Only make the order review on checkout sticky of the address column is tall enough to make it worthwhile.
  • Tweak¬†– Improved the Bookings calendar styles.
  • Tweak – :focus borders now dotted.
  • Tweak – Default header background color is now white and header text color defaults updated accordingly.
  • Tweak – Various typographical adjustments to match updated header design.
  • Dev – Added actions; storefront_jetpack_infinite_scroll_before, storefront_jetpack_infinite_scroll_after, storefront_jetpack_product_infinite_scroll_before and storefront_jetpack_product_infinite_scroll_after.
  • Dev – Added filters; storefront_footer_widget_rows and storefront_footer_widget_columns to easily control the number of widget rows / columns in the footer.
  • Dev – FontAwesome and icon styles are now enqueued separately to make removing FontAwesome trivial.
  • Dev – Updated FontAwesome to 4.7.0
  • Dev – Upsells columns filterable via storefront_upsells_columns.
  • Dev – Added a column wrapper to product loops. To adjust the layout you now only need to filter storefront_loop_columns.
  • Dev – Homepage product sections only display if products are returned.
  • Tweak – Escape background content color before output. Kudos @pdewouters.
  • Dev – Updated package versions. You’ll need to npm install next time you try to build.
  • Dev – Adds grunt-postcss + autoprefixer to the build process to reduce reliance on Bourbon.
  • Tweak – Doctype in lowercase. Kudos @B-07.
  • Fix – Only output background-image styles for the header and homepage content sections if an image exists.
  • Fix – Translatable aria labels in the homepage sections. Kudos @andreaskian.


You can download Storefront now from your dashboard or from


If you’re updating an existing store to Storefront 2.2.0, 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.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 Hamburger Menu 1.1.0 & Storefront Homepage Contact Section 1.0.1 — March 7, 2016

Storefront Hamburger Menu 1.1.0 & Storefront Homepage Contact Section 1.0.1

A new version of Storefront Hamburger Menu and Storefront Homepage Contact Section is now available.

Here’s the list of tweaks and bug fixes:

Storefront Hamburger Menu 1.1.0

  • Close button inside the off-screen menu.
  • Overlay on top of the content making what is the menu more obvious.
  • Storefront 2.0 compatibility.

Here’s how it looks like with the upcoming Storefront 2.0 Р

Storefront Homepage Contact Section 1.0.1

  • Improvements to the Google Maps Static API call.