You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
If your storefront uses templates for common content pages, start from the closest match instead of an empty page — see [Content model overview](/merchants/quick-start/content-model/). Labels, block settings, spacing, scheduling, and which blocks appear on a page are all author tasks done in Document Authoring without code. Visual design and behavior inside a drop-in (colors, layout, how buttons work) belongs to a developer.
11
+
If your storefront uses templates for common content pages, start from the closest match instead of an empty page — see [Page Designers and Content Authors](/merchants/quick-start/content-model/). Labels, block settings, spacing, scheduling, and which blocks appear on a page are all author tasks done in Document Authoring without code. Visual design and behavior inside a drop-in (colors, layout, how buttons work) belongs to a developer.
12
12
13
13
## What you can change without code
14
14
@@ -59,7 +59,7 @@ Every Commerce Storefront page stacks three layers:
59
59
- <Termterm="Commerce blocks">Commerce block</Term> — A <Term>Block table</Term> in your document with the block name (for example, `product-details` or `commerce-cart`) and any settings that block needs. See [Block table structure](/merchants/blocks/block-tables/) for the table shape.
60
60
- Page — The document that holds your Commerce blocks and any content blocks (marketing copy, images, breadcrumbs, Product Recommendations).
61
61
62
-
Most Commerce blocks live on a page you author yourself, such as your cart or sign-in page. If your storefront uses templates for common content pages, like a landing page or category page, start from the closest match instead of an empty page — see [Content model overview](/merchants/quick-start/content-model/) for how that works. The product page (PDP) is the exception. One document at `/products/default` is the template layout for every product URL, so a change there updates all product pages at once. Names, prices, and images still come from your catalog, not from that document. See [Product Details](/merchants/blocks/product-details/) for how this template works.
62
+
Most Commerce blocks live on a page you author yourself, such as your cart or sign-in page. If your storefront uses templates for common content pages, like a landing page or category page, start from the closest match instead of an empty page — see [Page Designers and Content Authors](/merchants/quick-start/content-model/) for how that works. The product page (PDP) is the exception. One document at `/products/default` is the template layout for every product URL, so a change there updates all product pages at once. Names, prices, and images still come from your catalog, not from that document. See [Product Details](/merchants/blocks/product-details/) for how this template works.
63
63
64
64
#### Roles at a glance
65
65
@@ -70,7 +70,7 @@ Most Commerce blocks live on a page you author yourself, such as your cart or si
70
70
71
71
On a small team, one person may cover two roles. Name the role you need on a ticket so the request reaches the right person faster.
72
72
73
-
For why this split exists, and how layout options get built before a Content Author can pick them, see [Content model overview](/merchants/quick-start/content-model/).
73
+
For why this split exists, and how layout options get built before a Content Author can pick them, see [Page Designers and Content Authors](/merchants/quick-start/content-model/).
74
74
75
75
For developer-facing vocabulary (containers, slots, events), see [Introduction to drop-in components](/dropins/all/introduction/).
Copy file name to clipboardExpand all lines: src/content/docs/merchants/blocks/block-tables.mdx
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -69,5 +69,5 @@ To add any Commerce block to a page, create a block table in Document Authoring
69
69
70
70
</TaskSection>
71
71
72
-
For an end-to-end example that covers metadata, a cart block, and section styling, work through [Your first page](/merchants/quick-start/your-first-page/).
72
+
For an end-to-end example that covers metadata, a commerce block, and section styling, work through [Create your first commerce page](/merchants/quick-start/your-first-page/).
Copy file name to clipboardExpand all lines: src/content/docs/merchants/blocks/content-commerce-blocks.mdx
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,7 +11,7 @@ Content blocks and Commerce blocks are the two types of building blocks on every
11
11
12
12
Content blocks are pre-built UI components for static page content — buttons, images, galleries, navigation, and text layouts. They come from Edge Delivery Services and the AEM block collection. You add a content block to a page with the same document table pattern you use for Commerce blocks.
13
13
14
-
For the full list and how to author them, see the <Linkhref="https://www.aem.live/developer/block-collection"text="Block Collection documentation" /> and the <Linkhref="https://www.aem.live/docs/authoring"text="content blocks tutorial" />. For why the set of available blocks and variations is fixed rather than something you design freely, see [Content model overview](/merchants/quick-start/content-model/).
14
+
For the full list and how to author them, see the <Linkhref="https://www.aem.live/developer/block-collection"text="Block Collection documentation" /> and the <Linkhref="https://www.aem.live/docs/authoring"text="content blocks tutorial" />. For why the set of available blocks and variations is fixed rather than something you design freely, see [Page Designers and Content Authors](/merchants/quick-start/content-model/).
Copy file name to clipboardExpand all lines: src/content/docs/merchants/quick-start/index.mdx
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,5 @@
1
1
---
2
-
title: Quick start
2
+
title: Start Here
3
3
description: Learn how to create pages, add commerce blocks, and configure your storefront using document authoring tools.
4
4
---
5
5
@@ -14,11 +14,11 @@ Get started by learning what Commerce Storefront is and how block tables work, t
14
14
|**Get oriented**||
15
15
|[What is Commerce Storefront?](/merchants/quick-start/create-content/)| Learn about the Commerce Storefront platform and the tools you use to build storefront pages |
16
16
|[Author and developer tasks](/merchants/blocks/author-and-developer-tasks/)| Drop-ins, blocks, and pages as three layers; what you can change without code; when to hand off to a developer |
17
-
|[Content model overview](/merchants/quick-start/content-model/)| Why content and layout are separate, and why layout options are fixed |
17
+
|[Page Designers and Content Authors](/merchants/quick-start/content-model/)| Why content and layout are separate, and why layout options are fixed |
18
18
|[Block table structure](/merchants/blocks/block-tables/)| How document tables map to blocks (name row, key-value settings, and merged full-width content rows) |
19
19
|**Build a page**||
20
20
|[Using the Document Authoring tool](/merchants/quick-start/document-authoring/)| Learn the document-based authoring interface for creating and editing page content |
21
-
|[Your first page](/merchants/quick-start/your-first-page/)| Step-by-step tutorial: create a cart page with page metadata, a commerce block, and section metadata |
21
+
|[Create your first commerce page](/merchants/quick-start/your-first-page/)| Step-by-step tutorial: create a category page with page metadata, a commerce block, and section metadata |
22
22
|**Refine and go deeper**||
23
23
|[Using the Universal Editor](/merchants/quick-start/universal-editor/)| Edit storefront content visually, directly on the rendered page |
24
24
|[Using Content and Commerce blocks](/merchants/blocks/content-commerce-blocks/)| Add pre-built content blocks and commerce functionality to your pages |
Create a complete commerce page in minutes by building a shopping cart page. This hands-on tutorial introduces you to the three essential building blocks—page metadata, commerce blocks, and section styling—by using them to build a real page.
10
+
Create a complete commerce page in minutes by building a category page. This hands-on tutorial introduces you to the three essential building blocks—page metadata, commerce blocks, and section styling—by using them to build a real page.
11
11
12
-
## Tutorial: Create a cart page
12
+
## Tutorial: Create a category page
13
13
14
14
<Tasks>
15
15
16
16
<Task>
17
17
18
18
### Create a new document
19
19
20
-
In the Document Authoring tool, create a new document named `cart`.
20
+
In the Document Authoring tool, create a new document named `dresses`.
21
21
22
22
</Task>
23
23
@@ -37,55 +37,47 @@ Create a metadata table at the top of your document:
<tdstyle="width: 50%; padding: 0.75rem; border: 1px solid var(--sl-color-gray-5);">Shop women's dresses in the latest styles, from casual to formal.</td>
These settings prevent search engines from indexing the cart and ensure the page is never cached (since cart contents change frequently).
54
+
These settings give the page a clear title and description for search results, and let it stay cached since a category listing doesn't change on every request.
55
55
56
56
</Task>
57
57
58
58
<Task>
59
59
60
-
### Add the Commerce Cart block
60
+
### Add the Product List Page block
61
61
62
-
**Commerce blocks** are pre-built components that add shopping functionality to your pages (like carts, product lists, and checkout). You add them using tables where the table name identifies the block and the rows configure its behavior. (See [all commerce blocks](/merchants/blocks/) for the complete list.)
62
+
**Commerce blocks** are pre-built components that add shopping functionality to your pages (like product listings, carts, and checkout). You add them using tables where the table name identifies the block and the rows configure its behavior. (See [all commerce blocks](/merchants/blocks/) for the complete list.)
63
63
64
-
Create a table with the Commerce Cart block and essential configuration:
64
+
Create a table with the Product List Page block and the category it should display:
This configuration limits the cart display to 10 items, enables shipping estimation, and provides a checkout link.
80
+
This tells the block which category from your catalog to show on this page. Replace `/women/dresses` with a real category path from your own catalog — the block still renders with the placeholder path, but shows zero results if it doesn't match a category you actually have.
89
81
90
82
</Task>
91
83
@@ -95,7 +87,7 @@ This configuration limits the cart display to 10 items, enables shipping estimat
95
87
96
88
**Section metadata** controls the visual styling of page sections (like background colors and layouts). You add a section metadata table after the content you want to style. (See [all section metadata styles](/merchants/blocks/section-metadata/) for layout options.)
97
89
98
-
Below the Commerce Cart block, add a section metadata table:
90
+
Below the Product List Page block, add a section metadata table:
**Block not appearing?** Verify the block name is `commerce-cart` (kebab-case) and configuration keys match exactly.
132
+
**Block not appearing?** Verify the block name is `product-list-page` (kebab-case).
141
133
142
-
**Changes not visible?**Wait a moment for cache to clear, then hard refresh the page (Cmd+Shift+R on Mac, Ctrl+Shift+R on Windows).
134
+
**Page loads but shows zero results?**Check that `urlPath` matches a real category path in your catalog — the block renders normally either way, but has nothing to display if the path doesn't match.
143
135
136
+
**Changes not visible?** Wait a moment for cache to clear, then hard refresh the page (Cmd+Shift+R on Mac, Ctrl+Shift+R on Windows).
0 commit comments