Skip to content
weLabsweLabsStorefront Playbook
Live demoQuickstart

Features

Home page

Fourteen merchandising sections — hero slider, deals countdown, best sellers, testimonials and more — composed per store and edited in wp-admin.

The home page is your shop window. It is built from fourteen ready-made sections that fill themselves from your catalogue or from content you write in wp-admin. Each deployment chooses which sections appear and in what order, and any section with nothing to show quietly steps aside.

Where it shows
/
Configure in
Content in StoreFront → Settings → Home page; which sections exist and their order in the HOME_SECTIONS environment variable
Requires
WooCommerce products; the Companion plugin for slider, banners, promo cards and testimonials
Try it in Demo Mode
All fourteen sections, with placeholder campaign content

A home page that feels curated, not templated: a campaign hero, live deals with a countdown, rails of new and best-selling products, brand and category entry points, social proof and fresh journal posts. On phones every rail scrolls sideways and has a View all link.

The table lists the sections in their default order, with the identifier used in HOME_SECTIONS.

Section What it shows Where its content comes from
hero A full-width slider with badge, heading, text and button on each slide. With the slider off or empty, a branded built-in hero shows instead. wp-admin: Home page › Slider
categories “Shop by category” — the categories with the most products. Automatic from WooCommerce
new-arrivals A rail of your newest products. Automatic
season-sale A sale banner beside a grid of products currently on sale. Banner copy in Home page › Sale Banner; products automatic
best-sellers A rail with Best sellers and Top rated tabs. Automatic
todays-deals Products whose scheduled sale ends today, with a countdown to midnight and an optional banner. Wording in Home page › Today’s Deals; products from WooCommerce sale schedules
brands A logo wall of brands, featured brands first. Automatic; Featured brand checkbox on each brand
trending “Trending now” category cards, ranked by what is actually selling. Automatic, refreshed daily
callout A wide call-to-action panel, such as a limited-time offer. Home page › CTA banner
recently-viewed The products this shopper looked at recently. Automatic, per browser
promo-banners Up to six promo cards, each with badge, heading, discount label, button and image. Home page › Promo cards
daily-essentials Your WooCommerce Featured products. The Featured star in WooCommerce
reviews “What Our Customers Are Saying” — hand-picked testimonials with names, photos and linked products. Home page › Testimonials
blog Your latest journal posts. WordPress posts

Two people shape the home page, at two different levels.

The developer who deploys the storefront decides which sections exist and in what order, with one environment variable:

HOME_SECTIONS=hero,new-arrivals,todays-deals,best-sellers,callout,reviews

Leave it unset to get all fourteen in the default order. Sections left out are never rendered and never fetch their data, which makes the page lighter. Unknown names are ignored with a warning in the server log. Two companion variables cap the rails: HOME_PRODUCT_CAROUSEL_LIMIT (products per rail, default 12) and HOME_CATEGORIES_LIMIT (categories in the category row, default 12).

The Store Owner fills and switches the sections in wp-admin, with no redeploy. The slider, CTA banner, promo cards, sale banner, Today’s Deals and testimonials each have their own card with an on/off toggle. Everything else follows the catalogue: mark a product as Featured and it joins Daily essentials; schedule a sale that ends today and it joins Today’s Deals.

A section in HOME_SECTIONS still hides itself when it has nothing to show — a switched-off banner, no deals ending today, no featured products.

Today’s Deals runs itself. A product appears when it has a sale price with a Schedule end date of today and the sale is still running. The countdown ends at midnight in your store’s timezone (WordPress Settings → General → Timezone). Up to 12 deals show, soonest-ending first. To feature a deal, give a product a sale that ends today.

  1. Ask your developer which sections the deployment includes, or set HOME_SECTIONS yourself — see Environment variables.
  2. In wp-admin, open StoreFront → Settings → Home page and fill in and switch on the sections you want — see Home page.
  3. Mark featured products and featured brands in WooCommerce — see Products.
  • Changes made in wp-admin reach the live site within about five minutes, because the storefront caches these reads briefly.
  • Today’s Deals leaves out variable products: WooCommerce schedules their sales per variation.
  • On promo cards from wp-admin, the fixed “Save” word before the discount label shows in English in every language for now; the rest of the card shows exactly what you type.
  • Demo Mode shows its own placeholder campaign content; wp-admin settings apply only when the storefront is connected to WooCommerce.
  • The look of the sections comes from the deployment’s Template Family; see Theming and layout.
Storefront Playbook · Built by weLabsFeaturesFAQTalk to us