Product Grid Sections

A Product Grid section shows products from your WooCommerce store as cards, with image, name, price, sale badge, star rating and an add-to-cart button. Products are read from the store when the page loads, so price and stock changes appear without editing the page. In the editor’s section list it is called WooCommerce.

When to use it

A few products on a marketing page: new arrivals on the home page, or the products a campaign page is about.
One category’s products on a landing page that explains that category.

The WooCommerce shop, category and product pages still handle browsing the full catalogue. To list posts or other content, use Post Grid Sections.

Content

The Content tab holds the standard section fields: Eyebrow Heading, Heading, Body Content, buttons, and Outro Content (shown after the products). A button such as “Shop all” below the grid is a common way to point to the full catalogue.

Choosing what to show

These are in the Query tab.

Control	What it does	Default
Number of Products	How many products to show, 1–50. There is no pagination.	6
Product Category	One WooCommerce product category, or All Products.	All Products
Order By	Date (Newest), Title, Price, Popularity (sales), Rating, Menu Order (the order set in WooCommerce) or Random.	Date (Newest)
Sort Order	Descending (highest or newest first) or Ascending.	Descending

Only published products are listed. To show two categories, use two sections.

What each card shows

Under Product Display in the same tab:

Control	What it does	Default
Price	The product’s price, including the sale price when it is on sale.	Show
Star Rating	The average review rating. Products with no reviews show no stars.	Hide
Add to Cart Button	The purchase button (see below).	Show
Sale Badge	A “Sale” label on products that are on sale.	Show

The button depends on the product:

Product	Button
Simple product, in stock	Add to Cart, which adds one to the cart
Variable or grouped product	Select Options, which opens the product page
External or affiliate product	The product’s own button text (or Buy Now), opening the external site in a new window
Out of stock or not purchasable	Read More, which opens the product page

A product without an image shows WooCommerce’s placeholder image.

Layouts and display styles

In the Layout tab, Display Style is Grid or Carousel.

Grid places the cards in rows. Set Products Per Row to 2, 3 or 4 (default 3).
Carousel places them on a horizontal rail, with Slides Per View (Auto (size-driven), 2, 3 or 4), Peek Next Card, Arrows, Dots, Loop, and Autoplay with an Autoplay Interval of 3–8 seconds. Autoplay adds a pause button and never runs for visitors who ask for reduced motion.

Options

Option	What it does	Default
Card Style	Cards (background and border) or Minimal (neither).	Cards
Product Image Aspect Ratio	Wide (16:9), Standard (4:3) or Square (1:1).	Square
Card Alignment	Left or Center.	Left
Button Position	Where the section’s own buttons go: After Body or After Outro.	After Outro
Layout Variant	Left, Center or Right: where the heading content sits relative to any section media.	Center

Cards use your Global Settings for corner radius, buttons, card style and dark sections, so they match your other cards. The section also has the shared controls: Theme Variant, colour palette, Scroll Animation, background, section media, Image Styling, heading size and the Advanced tab. See Working with Sections.

Limits and common problems

“No products found.” No published product matches. Check the category, and that the category has published products.
The section is missing from the editor’s list. WooCommerce is not active on this site.
No filter bar, no pagination. Product Grid shows a fixed selection. For browsing and filtering, use the WooCommerce shop pages.
Popularity and rating order need data. They sort by WooCommerce’s sales count and average rating, so a new store’s order may look arbitrary.

For more on using Promptless WP with WooCommerce, see WooCommerce Integration.