Ecommerce Blocks
| Field | Value |
|---|---|
| Audience | public |
| Page type | reference |
| Area | sg-builder |
| Updated | 2026-05-14 |
SG-Builder blocks for store composition — products archive, product detail blocks, and add-to-cart.
Ecommerce Blocks is the SG-Builder component category for store composition. Where the admin → STORE MANAGEMENT administers products, orders, and coupons, SG-Builder Ecommerce blocks surface those records on pages and provide the buy-flow components customers interact with. This page is the Reference definition.
What is this for?
Read this page when you want the structural definition of the Ecommerce block set — what each block does and how it pairs with the Store Management pillar.
Good use cases
- You are scoping a store homepage or category page.
- You are explaining to a stakeholder how SGEN handles store composition.
- You hit a "where is the add-to-cart button?" question and want the model laid out.
What NOT to use this for
- Step-by-step procedures — open the relevant Guide.
- Product administration — open the admin Products Reference.
- Per-release shipped change — open What's New or Changelog.
How this connects to other features
- Components — parent Reference.
- Basic Blocks — foundational blocks Ecommerce blocks compose with.
- Posts Blocks — sibling category.
- Extra Blocks — sibling category.
Definition
Ecommerce Blocks are the SG-Builder components that surface store-side records and provide the buy-flow on pages. The category covers archive blocks (Products Archive for multi-product listing pages), individual product detail blocks (Product Title, Product Price, Product Description, Product Gallery, Product Badges), buy-flow blocks (Cart Button, Related Products), and the Add to Cart action.
The defining property is store-shaped consumption. Ecommerce blocks read from the admin Store Management pillar (Products, Coupons) and write to the order pipeline (via cart and checkout flow).
Purpose
The purpose of this page is to define the Ecommerce block set as a Reference layer. It enumerates the blocks and explains how each pairs with Store Management.
Scope
This page covers Ecommerce Blocks at the Reference level.
The page covers:
- The block inventory in the Ecommerce category.
- Per-block role.
- The relationship to the admin Store Management pillar.
- Per-trait configuration — Components Reference.
- Product / order administration — SG-Admin Store Management Reference.
- Per-release shipped change — What's New or Changelog.
Block inventory
Products Archive
Multi-product listing block. Displays a collection of products in a grid; configurable column count, product count, sort order, and filter (by category, by tag, by stock state). This is the block for shop / category pages. Labeled "Products Archive" in the live block library (not "Product grid").
Product Title
Displays the current product's title. Used on individual product detail pages.
Product Price
Displays the current product's price (including sale price when active). Used on individual product detail pages.
Product Description
Displays the current product's description body. Used on individual product detail pages.
Product Gallery
Displays the current product's image gallery (primary image + additional images). Used on individual product detail pages.
Product Badges
Displays status badges for the current product (e.g. "Sale", "New", "Out of Stock"). Used on individual product detail pages.
Add to Cart
The action block that lets a customer add the current product to their cart. Carries quantity input and add behavior.
Cart Button
A cart-link button — typically placed in header or navigation templates. Opens the customer's cart.
Related Products
Displays products related to the current product. Configurable count and relationship rule.
Note: During the 2026-05-20 editor verify, two additional block categories were observed in the block library on the docs-staging environment: a client-specific category (5 blocks) and a Locations category (1 block). These categories are not part of the standard Ecommerce block set documented here and are excluded from this Reference.
SG-Builder · Ecommerce blocks · Rendered
Product grid (3-card)
Product A
USD 49.00
Product B
USD 89.00
Product C
USD 19.00
Pairing with Store Management
Ecommerce blocks read from the admin Store Management modules:
- Products module: Products Archive, Product Title, Product Price, Product Description, Product Gallery, Product Badges, Related Products, and Add to Cart all read from product records here.
- Orders module: the receiving end of the buy flow — Add to Cart and the cart / checkout flow produce order records here.
- Coupons module: coupon validation occurs through the cart / checkout flow using coupons configured in this module.
Constraints and boundaries
Ecommerce Blocks is a Reference area for the store-composition block set.
Use this Reference for:
- Understanding what Ecommerce blocks exist.
- Confirming the relationship to Store Management.
- Product / order / coupon administration — SG-Admin Store Management Reference.
- Per-trait configuration — Components Reference.
- Step-by-step procedures — Guides.
Public boundary
This page is intentionally public-safe.
Examples
Example 1 — Operator builds a store category page
Section → Products Archive (8 products, filter by category). The archive block surfaces the matching products from the admin Store Management; new products tagged to that category appear automatically.
Example 2 — Operator builds a product detail page
Section → Product Gallery → Product Title → Product Price → Product Description → Product Badges → Add to Cart → Related Products. All blocks pull from the current product record.
Example 3 — Operator adds a Cart Button to the header
Cart Button lives in the header template. Customers see it on every page and can navigate to their cart from anywhere.
Documentation guidance
Use this page as the structural definition for the Ecommerce block set. Per-component configuration detail lives in the Components Reference.
Reading order
Open this page when scoping store composition. Pair with SG-Admin Store Management Reference for the producing/consuming surface.
Related reading
- Components — parent Reference.
- Basic Blocks — foundational blocks.
- Posts Blocks — sibling category.
- Extra Blocks — sibling category.
Vocabulary cross-reference
- Products Archive is the multi-product listing block (labeled "Products Archive" in the block library).
- Product detail block is any block that surfaces a single product's data (Product Title, Product Price, Product Description, Product Gallery, Product Badges).
- Buy-flow block is a component the customer interacts with to move toward purchase (Add to Cart, Cart Button).
- Related Products is the block that surfaces products associated with the current product.
- Cart Button is the header-friendly cart-link block.
Maintenance discipline
When Ecommerce Blocks change across releases (new block, new buy-flow surface, new pairing with Store Management), update this Reference and log the change in Changelog.
Related reading
| Topic |
|---|
| Components |
| Basic Blocks |
| Posts Blocks |
| Extra Blocks |