# Commerce blocks

> Commerce blocks in the editor: Product hero, Shop grid, Product card, Price, Billing toggle, Countdown, Variant link and Resource hero.

Source: https://docs.personacart.com/editor/blocks/commerce-blocks

In short: {"Commerce blocks in the editor: Product hero, Shop grid, Product card, Price, Billing toggle, Countdown, Variant link and Resource hero."}

- Commerce blocks put your products on a page and let buyers act: a product hero with the buy box, a grid of products from your catalog, a single product card, prices that follow the product, a monthly or yearly switch, and a countdown that creates urgency.
- They read your real products, so a price you change in Commerce → Products changes here too.

1. Open a page in the editor, hover inside a section and press **Add**.
2. Choose **Component** and pick the block.
3. Click it on the canvas and change its settings in the inspector on the right.

## Where to find it

Open a page in the editor (Sidebar → STOREFRONT → Pages), then:

- **Product hero**: press **Add**, choose **Section**, and use the **Product & Commerce** chip. A product page already carries one; the inspector's **Product** field says which product it follows.
- **Shop grid, Product card, Price, Countdown, Billing toggle, Variant link**: press **Add**, **Component**, then the **Coach tools** shelf (it holds Shop grid, Price, Billing toggle and Variant link), or search by name.
- Whole pricing sections (plans, compare plans, single offer, price list) are in the **Pricing & Plans** chip. See [Add a section or a block](/editor/add-section-and-templates).

## The blocks

## Product hero

- The top of a product page: photos, title, price, buy buttons and details.
- If it is not connected to a product it shows "Product hero — select a product"; bind it in the inspector.
- If the bound product was deleted or belongs to another store you see "Product not found" and can pick another.
- The right rail has a **This hero** panel with these groups:

| Group | What it holds |
| --- | --- |
| **What shows** | Switches for **Show SKU**, **Show rating**, **Price (with sale strike-through)**, **Show description** (**Short** and **Long**), **Stock status badge**, **Urgency strip ("only N left")**, **Smart pricing**, **Add to cart button**, **Quantity selector**, **Buy Now button**, **Share button**, **Wishlist button**, **Show features list**, **Show guarantee card**, **Trust badges**, **Context strip (delivery, returns)**, **Social proof (review count)**. |
| **Photos** | **Photo side** (left or right), **Image aspect ratio**, **Photo max height**, **Photo corners**, **Photo border** (color, width), **Thumbnails** and **Phone thumbnails**, **Gallery thumbnail size**. |
| **Title & text** | **Show eyebrow label** and **Eyebrow text**, **Title size**, **Title weight**, **Title case**, **Description size**, **Detailed description width**, **Divider above the description**. |
| **Price & buy** | **Price size**, **Price weight**, **Savings line**, **Button height**, **Button label size**, **Button corners**, **Buy button width**, **Buttons in one row or two**, **Options shown as**, **Mobile sticky buy bar** (**Use storefront default**, **Always on** or **Always off**). |
| **Details & trust** | **Features list** (**Heading**, feature items), **Guarantee** (**Guarantee period (days)**, **Guarantee text**), **Trust badges**, and the details for the product type below. |
| **Layout** | **Sticky info column** (keeps the info column in view while scrolling), **Background style** (**Plain**, **Soft**, **Brand**, **Custom**). |

- Details change with the product type.
- A **course** hero offers **Instructor**, **Prerequisites**, **Curriculum preview** and **Syllabus / Preview lesson at the top**; an **event** offers **Countdown to event date**, **Venue / location** and **Capacity**; a **membership** offers **Benefits list** and **Member count**; **digital** products offer **File preview** and **File names list**; **subscriptions** offer a **Free trial badge** and **Cancellation policy**; **bookings** offer **Schedule** and **Availability**, plus a **Coach picker** with tile size and photo shape.

The hero also adapts for the buyer: it shows **Go to Course** for someone who owns the course, **Active Member** or **Manage Subscription** for a member, **Already purchased** for something they own, and **Members only** with a **View membership** button when the product is for members.

## Shop grid

A grid (or list) of products pulled from your catalog, with search, filters, badges and paging. Its panel is split into these groups:

| Group | Settings |
| --- | --- |
| **Which products show** | **This shop shows** (**Products** or **Collections**), **Featured collection**, **Featured products** with **Pick from** and **Show as** (**Grid** or **Carousel**), **Pinned products** (always first), **Product types to show**, **Hide price on these products**. |
| **Layout** | **Show products as** (**Grid** or **List**), columns (a separate **Phone** setting), **Card size** (**S** to **3X**: "Bigger means fewer cards in a row"), **Space between cards** (**Flush**, **Tight**, **Normal**, **Loose**), **Page width**. |
| **Product card** | **Card design** (one look for all, or by product type), **Proportions**, **Photo corners** (**Theme default**, **Rounded rectangle**, **Square (sharp)**, **Circle**, **Dome (arch top)**), **Photo background**, **Text on the card** (name size and boldness, price size and boldness), **Card surface**, **Hover effect**, **What's shown on the card** (**Price**, **Rating**, **Extra info line**, **Event date**, **Product label**, **Add-to-cart button**). |
| **Badges** | **Sale**, **New**, **Low stock** (**Show when stock drops below**), **Bestseller** (**After this many sales**, **Lasts this many days**) with your own **badge text**, **Badge style** (**None**, **Subtle**, **Bold**, **Decorative**), **Badge size**, colors, and **Show how many are left**. |
| **Search and filters** | **Search bar**, **Filters shoppers can use**, **Where filters appear** (**Top bar** or **Sidebar**), toolbar layouts (**Compact**, **Floating**, **Roomy**, **Big search**), **Keep visible while scrolling**, **Default sort**. |
| **Quick filters** | **Browse tabs**: **Make tabs from** Category, Collection, Tag, Product type or your own labels; **Tab style** (**Pills**, **Segmented**, **Underline**), **Tab placement**, **Show product counts**, **Show, hide & reorder tabs**. |
| **Banners** | A picture above the products: one banner, or two or more as a swipeable slideshow (**Auto-play slideshow**), each with **Heading**, **Subheading**, **Link URL** and **Height**. |
| **Loading** | **How products load**: **Numbered pages**, **Load more (button)** or **Load more (link)**; **Products per page**. Numbered pages are not available while the grid is split into sections. |
| **Collections** | **Collection and category pages** options: **Category pages** (**Original** or **Same as shop**), **Banner inside a collection**. |

Also: **When there are no products** sets what visitors see when nothing matches. Button words ("Add-to-cart button text") can differ per product type.

## Product card

- One product card (image, name, price, quick add) used inside a Shop grid or alone on a landing page.
- Alone, choose the **Product** it shows.
- Switches: **Price**, **Quick-add button** (**Hidden**, **Below image**, **Center overlay**, **Bottom slide-up**), **Wishlist heart**, **Badges (sale / new / low-stock)**, **Variant swatches**, **Rating stars**, **Stock status pill**, **Urgency pill**, plus an **Aspect ratio (override)**.
- **Card design** choices include **Clean**, **Compact**, **Cover** (the photo is the card), **Spotlight** (text beside a photo), **Ticket** (a stub with the key fact), **Headline**, **Hover details**, **Editorial**, **Detailed**, **Wide row**, **List row**, **Bold** and **Video**.

## Price, Billing toggle and Variant link

- **Price** follows its product and has the settings described in [Text blocks](/editor/blocks/text).
- **Billing toggle** is a Monthly / Yearly switch.
  - **Starts on** chooses which prices visitors see first, a savings tag such as "Save 20%" is typed by you (it does not check your prices), and the inspector tells you how many prices in the section follow the switch ("This switch changes nothing yet" until a price has both a Monthly and a Yearly amount).
  - **Width**: **Fit**, **Fixed** or **Full**.
- **Variant link** shows the shareable link of the product variant the buyer has selected, with a copy button: **Show the link box**, **Button text**, **Show the variation name**. It follows the product on the page and shows nothing without a product that has variants.

## Countdown

- A live timer to a date: **Target date / time** or **Where the date comes from** (**I pick a date**, **This sale**, **Next class**), **Caption (optional)**, **Expired label**, **Size**, **Align**, **Numbers style**, **Unit words style**, **Kind of timer** (**Counts to a date** or **Repeats**), **When it ends** (**Show a message** or **Hide it**), **Use my store's time zone**, **Hide days cell when fewer than 24 hours remain**, **Hide when the date has passed**.
- Visitors see the time in their own time zone unless you choose your store's.
- A date that has already passed shows a warning.

## Resource hero

The top of a coach or resource page: **Show photo**, **Show role**, **Show bio**, **Offerings heading**, **Show other products**, **Photo size** and **Offerings per row**. It reads the person from **Resources**; **Open Resources** takes you there.

## Steps: show one product

  Press Add, choose Section, open the Product & Commerce chip and pick a product hero design.
  In the inspector, choose the Product it follows. Name, price and photos fill in at once.
  Open This hero → What shows and switch off anything you do not want (SKU, Share button, and so on).
  Check the phone view; set Mobile sticky buy bar to Always on if the buy button should stay in view.

## What happens, and what doesn't

- Names, prices, photos and stock come from your product. Edit them on the product (the inspector links to **Edit this product's details**); the block updates itself.
- A product page keeps one hero. A product can have up to 5 pages, but only one is the primary page buyers see at the product's address.
- The theme's **This page** group and a page's own settings can add or hide Reviews and related products. See [Buttons, photos and page defaults](/editor/theme/components) and [Page settings and SEO](/editor/page-settings-and-seo).
- Popups and urgency tools that sit near the buy button (sticky add-to-cart bar, trust badges, sale countdown) are in [Popups and urgency tools](/editor/conversion-tools).

## Questions
