Products
| Field | Value |
|---|---|
| Audience | public |
| Page type | reference |
| Area | sg-admin |
| Updated | 2026-05-14 |
The SG-Admin Products module — administer products, variants, inventory, pricing.
The Products module in the admin is the per-site surface for administering the store catalog. Operators create, update, organize, and price products here; SG-Builder Ecommerce blocks consume the records on store pages. This page is the Reference definition.
What is this for?
Read this page when you want the structural definition of the Products module — what records it administers, how variants and inventory work, and how the module pairs with Ecommerce blocks.
Good use cases
- You are scoping a new store and need the product model.
- You are explaining to a stakeholder how SGEN handles product administration.
- You hit a "where do I add a variant?" question and want the model laid out.
What NOT to use this for
- Step-by-step procedures — open the relevant Guide.
- How products surface on pages — open Ecommerce Blocks Reference.
- Per-release shipped change — open What's New or Changelog.
How this connects to other features
- SG-Admin Overview — parent surface (STORE MANAGEMENT pillar).
- Orders — sibling that records transactions on these products.
- Coupons — sibling that applies discount rules to these products.
- Ecommerce Blocks — consumer surface.
Where to find it
Open SG-Admin for the active site. Products is in the sidebar under the store management group. The product list, add-new action, inventory summary, and category management are reachable from this section. Editor and Admin access can manage products; Admins control category and variant structure.
Definition
The Products module administers the per-site store catalog. Each product carries identifying metadata (name, slug, SKU), commercial metadata (price, currency, inventory state), structural metadata (variants, attributes, categories, images), and content (description body, edited via SG-Builder where applicable).
The defining property is store-shaped administration. Products carry pricing and inventory semantics that page or post records don't.
Purpose
The purpose of this page is to define the Products module as a Reference layer rather than a configuration walkthrough.
Scope
This page covers Products at the Reference level.
The page covers:
- The product record model.
- Variants and inventory.
- Categorization.
- The producer relationship to Ecommerce blocks.
- Per-step procedures — Guides.
- Ecommerce blocks consumption — Ecommerce Blocks Reference.
- Per-release shipped change — What's New or Changelog.
The product record model
Each product carries:
- Name — public-facing product name.
- Slug — URL fragment for the product detail page.
- SKU — operator-side identifier.
- Price — base price in the store's currency.
- Inventory state — in stock, low stock, out of stock, unlimited.
- Variants — per-variant pricing and inventory (size, color, etc.).
- Categories — structured taxonomy.
- Tags — free-text taxonomy.
- Images — product images, primary + gallery.
- Description — body content (visual composition via SG-Builder where applicable).
Site · SG-Admin · Products
Catalog
| Name | SKU | Price | Variants | Inventory |
|---|---|---|---|---|
| Product A | SKU-001 | USD 49.00 | 3 (S/M/L) | In stock |
| Product B | SKU-002 | USD 89.00 | none | In stock |
| Product C | SKU-003 | USD 19.00 | 5 (colors) | Low (3) |
| Product D | SKU-004 | USD 129.00 | none | Out |
Variants and inventory
Variants
Per-product variants represent product variations (size, color, finish). Each variant carries its own SKU, price (or price-modifier), and inventory state.
Inventory tracking
Inventory state per variant: in stock with count, low-stock indicator at configured threshold, out of stock, or unlimited where the product has no inventory cap.
Inventory updates
Inventory updates from successful checkout transactions (Orders) and from operator manual adjustments.
Producer to Ecommerce blocks
Products produces records that Ecommerce blocks consume:
- Product grid reads filtered by category or tag.
- Product card displays one product.
- Product hero displays one featured product.
- Add-to-cart writes back to the order pipeline.
Constraints and boundaries
Products is a Reference area for the product record model.
Use this Reference for:
- Understanding the product record and inventory model.
- Confirming the producer relationship to Ecommerce blocks.
- Order processing — Orders Reference.
- Discount logic — Coupons Reference.
- Per-step procedures — Guides.
Public boundary
This page is intentionally public-safe.
Examples
Example 1 — Operator adds a product with variants
Operator clicks Add new product, fills name + base price, adds 3 size variants each with own SKU and inventory count. Saves and publishes.
Example 2 — Inventory drops to low-stock
A successful checkout reduces inventory to the low-stock threshold. The Products list surfaces the low-stock badge. The operator restocks via inventory update.
Example 3 — Operator categorizes products for store landing
Operator categorizes products into "Featured", "Sale", "New". Ecommerce blocks on the store homepage filter by category to surface the right product set per section.
Documentation guidance
Use this page as the structural definition for the Products module.
Reading order
Open this page when scoping store administration. Pair with Orders for the transaction record and Ecommerce Blocks for the consumer surface.
Related reading
- SG-Admin Overview — parent surface.
- Orders — transaction records.
- Coupons — discount rules.
- Ecommerce Blocks — consumer surface.
Vocabulary cross-reference
- Product record is one row in the Products inventory.
- SKU is the operator-side identifier.
- Variant is a per-product variation with own SKU + inventory.
- Inventory state is one of in stock / low / out / unlimited.
- Category is the structured taxonomy used for store-page filtering.
Maintenance discipline
When the Products module changes across releases (new field, new variant model, new inventory state), update this Reference and log the change in Changelog.
Related reading
| Topic |
|---|
| SG-Admin |
| Orders |
| Coupons |
| Ecommerce Blocks |