storefront customization

Storefront Hook Reference: A Complete List of Hooks & Filters for the Storefront Theme

Customize Storefront Theme without touching any code

Why not spend less time on designing WooCommerce stores?
Download FREE

Storefront theme provides various hooks so that other developers can easily extend or modify the theme. The concept of hooks is confusing for users who are starting out with WordPress development. There are 2 types of hooks that can be found on WordPress:

  • Action Hook: allows you to add extra functionality at various points.
  • Filter Hook: allows you to modify the data.

Here is a simple explainer: Actions do stuff, filters change stuff.

At last count (Version: 2.2.5), Storefront has around 48 Action Hooks & 61 Filter Hooks. Here is a complete list of Storefront WooCommerce theme hooks, hope this guide will save you many hours of trouble when developing a WooCommerce project using Storefront.

Header Hooks

TypeHookFunctions HookedWhat It Does
Actionstorefront_before_siteEmptyAdd content after body opening
Actionstorefront_before_headerEmptyAdd content before header tag
Actionstorefront_headerstorefront_skip_linksDisplays content between header tags
storefront_social_icons
storefront_site_branding
storefront_secondary_navigation
storefront_product_search
storefront_primary_navigation_wrapper
storefront_primary_navigation
storefront_header_cart
storefront_primary_navigation_wrapper_close
Actionstorefront_before_contentstorefront_header_widget_regionDisplays content after header tags
Actionstorefront_content_topwoocommerce_breadcrumbAdds content at the top of site content div

Homepage Template

TypeHookFunctions Hooked
What It Does
Actionhomepagestorefront_homepage_contentAdd sections to Homepage Template
storefront_product_categories
storefront_recent_products
storefront_featured_products
storefront_popular_products
storefront_on_sale_products
storefront_best_selling_products
Actionstorefront_homepagestorefront_homepage_headerOutputs page content in template-homepage.php
storefront_page_content
Actionstorefront_homepage_before_product_categoriesEmptyAdd content before Homepage Product Category section title
Actionstorefront_homepage_after_product_categories_titleEmptyAdd content after Homepage Product Category section title
Actionstorefront_homepage_after_product_categoriesEmptyAdd content after Homepage Featured Products section title
Actionstorefront_homepage_before_recent_productsEmptyAdd content before Homepage Recent Products section title
Actionstorefront_homepage_after_recent_products_titleEmptyAdd content after Homepage Recent Products section title
Actionstorefront_homepage_after_recent_productsEmptyAdd content after Homepage Recent Products
Actionstorefront_homepage_before_featured_productsEmptyAdd content before Homepage Featured Products section title
Actionstorefront_homepage_after_featured_products_titleEmptyAdd content after Homepage Featured Products section title
Actionstorefront_homepage_after_featured_productsEmptyAdd content after Homepage Featured Products
Actionstorefront_homepage_before_popular_productsEmptyAdd content before Homepage Popular Products section title
Actionstorefront_homepage_after_popular_products_titleEmptyAdd content after Homepage Popular Products section title
Actionstorefront_homepage_after_popular_productsEmptyAdd content after Homepage Popular Products
Actionstorefront_homepage_before_on_sale_productsEmptyAdd content before Homepage On-sale Products section title
Actionstorefront_homepage_after_on_sale_products_titleEmptyAdd content after Homepage On-sale Products section title
Actionstorefront_homepage_after_on_sale_productsEmptyAdd content after Homepage On-sale Products
Actionstorefront_homepage_before_best_selling_productsEmptyAdd content before Homepage Best Selling Products section title
Actionstorefront_homepage_after_best_selling_products_titleEmptyAdd content after Homepage Best Selling Products section title
Actionstorefront_homepage_after_best_selling_productsEmptyAdd content after Homepage Best Selling Products
Filterstorefront_homepage_content_stylesHomepage styles
Filterstorefront_product_categories_argslimit, columns, child_categories, orderby, titleDefines number of category to display, category per column, sort by & parent status of homepage Product Category section
Filterstorefront_product_categories_shortcode_argsnumber, columns, orderby, parentDefines number of category to display, category per column, sort by & parent status of homepage Product Category section
Filterstorefront_recent_products_argslimit, columns, titleDefines number of produts to display, product per column & title for homepage Recent products section
Filterstorefront_recent_products_shortcode_argsper_page, columnsDefines number of produts to display and product per column for homepage Recent products section
Filterstorefront_featured_products_argslimit, columns, titleDefines number of produts to display, product per column & title for homepage Featured Products section
Filterstorefront_featured_products_shortcode_argsper_page, columnsDefines number of produts to display and product per column for homepage Featured Products section
Filterstorefront_popular_products_argslimit, columns, titleDefines number of produts to display, product per column & title for homepage Popular Products section
Filterstorefront_popular_products_shortcode_argsper_page, columnsDefines number of produts to display and product per column for homepage Popular Products section
Filterstorefront_on_sale_products_argslimit, columns, titleDefines number of produts to display, product per column & title for homepage On-Sale Products section
Filterstorefront_on_sale_products_shortcode_argsper_page, columnsDefines number of produts to display and product per column for homepage On-Sale Products section
Filterstorefront_best_selling_products_argslimit, columns, titleDefines number of produts to display, product per column & title for homepage Best selling section
Filterstorefront_best_selling_products_shortcode_argsper_page, columnsDefines number of produts to display and product per column for homepage Best selling section

Post Archive/ Blog Post Hooks

TypeHookFunctions HookedWhat It Does
Actionstorefront_post_content_beforestorefront_post_thumbnailAdds Content before post
Actionstorefront_post_content_afterEmptyAdds Content after post
Actionstorefront_loop_poststorefront_post_headerHook used to display post content
storefront_post_meta
storefront_post_content
Actionstorefront_loop_beforeEmptyAdds Content before post loop
Actionstorefront_loop_afterEmptyAdds Content after post loop

Single Post Hooks

TypeHookFunctions HookedWhat It Does
Actionstorefront_single_post_topEmptyDisplay content before Single Post Header
Actionstorefront_single_poststorefront_post_headerOutputs single post content (title, meta, post content)
storefront_post_meta
storefront_post_content
Actionstorefront_single_post_bottomstorefront_post_navOutputs additional single post elements (Next / Previous posts, Comments)
storefront_display_comments
Actionstorefront_single_post_beforeEmptyAdds content before single post content
Actionstorefront_single_post_afterEmptyAdds Content After single post content
Filterstorefront_single_post_posted_on_htmlSingle post published date markup

Page Hooks

TypeHookFunctions HookedWhat It Does
Actionstorefront_pagestorefront_page_headerdisplay page content in page.php
storefront_page_content
Actionstorefront_page_beforeEmptyAdd content before page content
Actionstorefront_page_afterEmptyAdds content after page content

Sidebar & Widget Hooks

TypeHookFunctions HookedWhat It Does
Actionstorefront_sidebarstorefront_get_sidebarOutputs Left & Right Sidebar contents (widgets)
Filterstorefront_footer_widget_rowsDefine number of footer widget rows
Filterstorefront_footer_widget_columnsDefine number of footer widget columns
Filterstorefront_sidebar_argsDefines sidebar arguments

Footer Hooks

TypeHookFunctions HookedWhat It Does
Actionstorefront_after_footerEmptyAdd content after footer tags
Actionstorefront_before_footerEmptyAdd content before footer tags
Actionstorefront_footerstorefront_footer_widgetsAdd content between footer tags
storefront_credit
storefront_handheld_footer_bar
Filterstorefront_copyright_textModify storefront copyright text
Filterstorefront_credit_linkModify Storefront credit link
Filterstorefront_handheld_footer_bar_linksDisplay a menu intended for use on handheld devices

WooCommerce Hooks

TypeHookFunctions HookedWhat It Does
Filterstorefront_customizer_woocommerce_extension_cssStyle for Booking, Product Reviews & Smart Coupon extensions
Filterstorefront_loop_columnsnumber of product per row
Filterstorefront_page_option_namesWooCommerce page ids
Filterstorefront_product_thumbnail_columnsProduct gallery thumbnail columns
Filterstorefront_products_per_pageWooCommerce products per page
Filterstorefront_related_products_argsChange related products number & column
Filterstorefront_sticky_order_reviewenqueue sticky payment script
Filterstorefront_upsells_columnsdefault upsell number of columns

Storefront Jetpack Hooks

TypeHookFunctions HookedWhat It Does
Actionstorefront_jetpack_infinite_scroll_afterEmptyAdd content after infinite post loop
Actionstorefront_jetpack_infinite_scroll_beforeEmptyAdd content before infinite post loop
Actionstorefront_jetpack_product_infinite_scroll_afterEmptyAdd content after infinite WooCommerce product loop
Actionstorefront_jetpack_product_infinite_scroll_beforeEmptyAdd content before infinite WooCommerce product loop
Filterstorefront_jetpack_infinite_scroll_argsInfinite Scroll arguments

Storefront Customizer Hooks

TypeHookWhat It Does
Filterstorefront_custom_header_argsCustom header arguments
Filterstorefront_customizer_moreloads More_Storefront_Control customizer custom control
Filterstorefront_default_accent_colorLink Color
Filterstorefront_default_button_alt_background_colorAlternate Button background color
Filterstorefront_default_button_alt_text_colorAlternate Button text color
Filterstorefront_default_button_background_colorButton background color
Filterstorefront_default_button_text_colorButton text color
Filterstorefront_default_footer_background_colorFooter background color
Filterstorefront_default_footer_heading_colorFooter title color
Filterstorefront_default_footer_link_colorFooter link color
Filterstorefront_default_footer_text_colorFooter text color
Filterstorefront_default_header_background_colorHeader Color
Filterstorefront_default_header_link_colorHeader link color
Filterstorefront_default_header_text_colorHeader text color
Filterstorefront_default_heading_colorheading color
Filterstorefront_default_layoutLayout
Filterstorefront_default_text_colorText color
Filterstorefront_setting_default_valuesReturns an array of the default Storefront Customizer Settings

Storefront Other Hooks

TypeHookWhat It Does
Filterstorefront_custom_background_argsDefines Custom background color & image arguments
Filterstorefront_default_background_colorCustom background color
Filterstorefront_comment_form_argsWrap comment reply content between span
Filterstorefront_google_font_familiesGoogle font family
Filterstorefront_make_me_cuteEnables Comic Sans Font
Filterjetpack_the_site_logoJetpack site logo markup
Filterstorefront_menu_toggle_textStorefront menu toggle text
Filterstorefront_navigation_markup_templatenavigation markup template
Filterstorefront_starter_contentStarter content
Filterstorefront_starter_content_productsStarter content products
Filterstorefront_valid_tour_tasksValidates and sanitizes a given tasks list
Filterstorefront_header_stylesHeader styles

Leave a Reply