@endora-commerce/mod-cms 0.108.0 → 0.109.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (227) hide show
  1. package/README.md +1 -0
  2. package/dist/admin/api/cms-client.d.ts +19 -3
  3. package/dist/admin/api/cms-client.d.ts.map +1 -1
  4. package/dist/admin/api/cms-client.js +23 -2
  5. package/dist/admin/api/cms-client.js.map +1 -1
  6. package/dist/admin/components/AdminCatalogPreviewProvider.d.ts.map +1 -1
  7. package/dist/admin/components/AdminCatalogPreviewProvider.js +51 -0
  8. package/dist/admin/components/AdminCatalogPreviewProvider.js.map +1 -1
  9. package/dist/admin/components/BackgroundFields.d.ts +16 -0
  10. package/dist/admin/components/BackgroundFields.d.ts.map +1 -1
  11. package/dist/admin/components/BackgroundFields.js +58 -11
  12. package/dist/admin/components/BackgroundFields.js.map +1 -1
  13. package/dist/admin/components/BrandFontFields.d.ts +17 -0
  14. package/dist/admin/components/BrandFontFields.d.ts.map +1 -0
  15. package/dist/admin/components/BrandFontFields.js +39 -0
  16. package/dist/admin/components/BrandFontFields.js.map +1 -0
  17. package/dist/admin/components/BrandPreview.d.ts +29 -0
  18. package/dist/admin/components/BrandPreview.d.ts.map +1 -0
  19. package/dist/admin/components/BrandPreview.js +130 -0
  20. package/dist/admin/components/BrandPreview.js.map +1 -0
  21. package/dist/admin/components/CarouselAddSlideMenu.d.ts +5 -0
  22. package/dist/admin/components/CarouselAddSlideMenu.d.ts.map +1 -0
  23. package/dist/admin/components/CarouselAddSlideMenu.js +84 -0
  24. package/dist/admin/components/CarouselAddSlideMenu.js.map +1 -0
  25. package/dist/admin/components/CarouselFields.d.ts +6 -0
  26. package/dist/admin/components/CarouselFields.d.ts.map +1 -0
  27. package/dist/admin/components/CarouselFields.js +55 -0
  28. package/dist/admin/components/CarouselFields.js.map +1 -0
  29. package/dist/admin/components/ContentSliderActionBarExtras.d.ts.map +1 -1
  30. package/dist/admin/components/ContentSliderActionBarExtras.js +13 -6
  31. package/dist/admin/components/ContentSliderActionBarExtras.js.map +1 -1
  32. package/dist/admin/components/HeroFields.d.ts +47 -0
  33. package/dist/admin/components/HeroFields.d.ts.map +1 -0
  34. package/dist/admin/components/HeroFields.js +92 -0
  35. package/dist/admin/components/HeroFields.js.map +1 -0
  36. package/dist/admin/components/ListingFields.d.ts +6 -0
  37. package/dist/admin/components/ListingFields.d.ts.map +1 -0
  38. package/dist/admin/components/ListingFields.js +54 -0
  39. package/dist/admin/components/ListingFields.js.map +1 -0
  40. package/dist/admin/components/NewsletterSignupFields.d.ts +18 -0
  41. package/dist/admin/components/NewsletterSignupFields.d.ts.map +1 -0
  42. package/dist/admin/components/NewsletterSignupFields.js +38 -0
  43. package/dist/admin/components/NewsletterSignupFields.js.map +1 -0
  44. package/dist/admin/components/PageBuilderActionBar.d.ts.map +1 -1
  45. package/dist/admin/components/PageBuilderActionBar.js +1 -6
  46. package/dist/admin/components/PageBuilderActionBar.js.map +1 -1
  47. package/dist/admin/components/PageBuilderEditor.d.ts +43 -2
  48. package/dist/admin/components/PageBuilderEditor.d.ts.map +1 -1
  49. package/dist/admin/components/PageBuilderEditor.js +207 -121
  50. package/dist/admin/components/PageBuilderEditor.js.map +1 -1
  51. package/dist/admin/components/PageNavigationFields.d.ts +6 -0
  52. package/dist/admin/components/PageNavigationFields.d.ts.map +1 -0
  53. package/dist/admin/components/PageNavigationFields.js +29 -0
  54. package/dist/admin/components/PageNavigationFields.js.map +1 -0
  55. package/dist/admin/components/PreviewBrandTokens.d.ts +25 -0
  56. package/dist/admin/components/PreviewBrandTokens.d.ts.map +1 -0
  57. package/dist/admin/components/PreviewBrandTokens.js +68 -0
  58. package/dist/admin/components/PreviewBrandTokens.js.map +1 -0
  59. package/dist/admin/components/SectionBlockFields.d.ts +44 -0
  60. package/dist/admin/components/SectionBlockFields.d.ts.map +1 -0
  61. package/dist/admin/components/SectionBlockFields.js +114 -0
  62. package/dist/admin/components/SectionBlockFields.js.map +1 -0
  63. package/dist/admin/components/SectionPresetsPanel.d.ts +11 -0
  64. package/dist/admin/components/SectionPresetsPanel.d.ts.map +1 -0
  65. package/dist/admin/components/SectionPresetsPanel.js +82 -0
  66. package/dist/admin/components/SectionPresetsPanel.js.map +1 -0
  67. package/dist/admin/components/SliderPreviewActionBarExtras.d.ts +1 -1
  68. package/dist/admin/components/SliderPreviewActionBarExtras.d.ts.map +1 -1
  69. package/dist/admin/components/SliderPreviewActionBarExtras.js +1 -5
  70. package/dist/admin/components/SliderPreviewActionBarExtras.js.map +1 -1
  71. package/dist/admin/components/admin-catalog-preview-map.d.ts +9 -0
  72. package/dist/admin/components/admin-catalog-preview-map.d.ts.map +1 -1
  73. package/dist/admin/components/admin-catalog-preview-map.js +10 -0
  74. package/dist/admin/components/admin-catalog-preview-map.js.map +1 -1
  75. package/dist/admin/components/page-builder-i18n.d.ts +24 -2
  76. package/dist/admin/components/page-builder-i18n.d.ts.map +1 -1
  77. package/dist/admin/components/page-builder-i18n.js +102 -9
  78. package/dist/admin/components/page-builder-i18n.js.map +1 -1
  79. package/dist/admin/editors/PageEditor.d.ts.map +1 -1
  80. package/dist/admin/editors/PageEditor.js +270 -38
  81. package/dist/admin/editors/PageEditor.js.map +1 -1
  82. package/dist/admin/index.d.ts +1 -1
  83. package/dist/admin/index.d.ts.map +1 -1
  84. package/dist/admin/index.js +21 -1
  85. package/dist/admin/index.js.map +1 -1
  86. package/dist/admin/pages/BrandPage.d.ts +19 -0
  87. package/dist/admin/pages/BrandPage.d.ts.map +1 -0
  88. package/dist/admin/pages/BrandPage.js +316 -0
  89. package/dist/admin/pages/BrandPage.js.map +1 -0
  90. package/dist/admin/pages/PagesListPage.d.ts.map +1 -1
  91. package/dist/admin/pages/PagesListPage.js +4 -1
  92. package/dist/admin/pages/PagesListPage.js.map +1 -1
  93. package/dist/backend/cli/block-names.d.ts +2 -1
  94. package/dist/backend/cli/block-names.d.ts.map +1 -1
  95. package/dist/backend/cli/block-names.js.map +1 -1
  96. package/dist/backend/entities/cms-brand-tokens.entity.d.ts +20 -0
  97. package/dist/backend/entities/cms-brand-tokens.entity.d.ts.map +1 -0
  98. package/dist/backend/entities/cms-brand-tokens.entity.js +57 -0
  99. package/dist/backend/entities/cms-brand-tokens.entity.js.map +1 -0
  100. package/dist/backend/entities/cms-page.entity.d.ts +32 -1
  101. package/dist/backend/entities/cms-page.entity.d.ts.map +1 -1
  102. package/dist/backend/entities/cms-page.entity.js +63 -0
  103. package/dist/backend/entities/cms-page.entity.js.map +1 -1
  104. package/dist/backend/index.d.ts +5 -1
  105. package/dist/backend/index.d.ts.map +1 -1
  106. package/dist/backend/index.js +78 -8
  107. package/dist/backend/index.js.map +1 -1
  108. package/dist/backend/plugin.d.ts +16 -2
  109. package/dist/backend/plugin.d.ts.map +1 -1
  110. package/dist/backend/plugin.js +20 -1
  111. package/dist/backend/plugin.js.map +1 -1
  112. package/dist/backend/routes.admin.d.ts +2 -0
  113. package/dist/backend/routes.admin.d.ts.map +1 -1
  114. package/dist/backend/routes.admin.js +39 -4
  115. package/dist/backend/routes.admin.js.map +1 -1
  116. package/dist/backend/routes.storefront.d.ts +24 -1
  117. package/dist/backend/routes.storefront.d.ts.map +1 -1
  118. package/dist/backend/routes.storefront.js +55 -2
  119. package/dist/backend/routes.storefront.js.map +1 -1
  120. package/dist/backend/services/anchor-guard.d.ts +10 -0
  121. package/dist/backend/services/anchor-guard.d.ts.map +1 -0
  122. package/dist/backend/services/anchor-guard.js +132 -0
  123. package/dist/backend/services/anchor-guard.js.map +1 -0
  124. package/dist/backend/services/asset-references.d.ts.map +1 -1
  125. package/dist/backend/services/asset-references.js +46 -30
  126. package/dist/backend/services/asset-references.js.map +1 -1
  127. package/dist/backend/services/brand-tokens-service.d.ts +84 -0
  128. package/dist/backend/services/brand-tokens-service.d.ts.map +1 -0
  129. package/dist/backend/services/brand-tokens-service.js +159 -0
  130. package/dist/backend/services/brand-tokens-service.js.map +1 -0
  131. package/dist/backend/services/channel-language-prefixes.d.ts +11 -0
  132. package/dist/backend/services/channel-language-prefixes.d.ts.map +1 -0
  133. package/dist/backend/services/channel-language-prefixes.js +24 -0
  134. package/dist/backend/services/channel-language-prefixes.js.map +1 -0
  135. package/dist/backend/services/cms-block-service.d.ts.map +1 -1
  136. package/dist/backend/services/cms-block-service.js +3 -0
  137. package/dist/backend/services/cms-block-service.js.map +1 -1
  138. package/dist/backend/services/cms-cache.d.ts +10 -0
  139. package/dist/backend/services/cms-cache.d.ts.map +1 -1
  140. package/dist/backend/services/cms-cache.js +9 -0
  141. package/dist/backend/services/cms-cache.js.map +1 -1
  142. package/dist/backend/services/cms-content-invalidator.d.ts +13 -4
  143. package/dist/backend/services/cms-content-invalidator.d.ts.map +1 -1
  144. package/dist/backend/services/cms-content-invalidator.js +13 -6
  145. package/dist/backend/services/cms-content-invalidator.js.map +1 -1
  146. package/dist/backend/services/cms-page-read-port.d.ts +6 -1
  147. package/dist/backend/services/cms-page-read-port.d.ts.map +1 -1
  148. package/dist/backend/services/cms-page-read-port.js +27 -0
  149. package/dist/backend/services/cms-page-read-port.js.map +1 -1
  150. package/dist/backend/services/cms-page-service.d.ts +72 -1
  151. package/dist/backend/services/cms-page-service.d.ts.map +1 -1
  152. package/dist/backend/services/cms-page-service.js +317 -17
  153. package/dist/backend/services/cms-page-service.js.map +1 -1
  154. package/dist/backend/services/cms-template-service.d.ts.map +1 -1
  155. package/dist/backend/services/cms-template-service.js +3 -0
  156. package/dist/backend/services/cms-template-service.js.map +1 -1
  157. package/dist/backend/services/contact-form/contact-form-mail.d.ts +22 -0
  158. package/dist/backend/services/contact-form/contact-form-mail.d.ts.map +1 -0
  159. package/dist/backend/services/contact-form/contact-form-mail.js +64 -0
  160. package/dist/backend/services/contact-form/contact-form-mail.js.map +1 -0
  161. package/dist/backend/services/contact-form/contact-form.service.d.ts +35 -0
  162. package/dist/backend/services/contact-form/contact-form.service.d.ts.map +1 -0
  163. package/dist/backend/services/contact-form/contact-form.service.js +75 -0
  164. package/dist/backend/services/contact-form/contact-form.service.js.map +1 -0
  165. package/dist/backend/services/contact-form/recipients-validator.d.ts +8 -0
  166. package/dist/backend/services/contact-form/recipients-validator.d.ts.map +1 -0
  167. package/dist/backend/services/contact-form/recipients-validator.js +23 -0
  168. package/dist/backend/services/contact-form/recipients-validator.js.map +1 -0
  169. package/dist/backend/services/content-tree-walker.d.ts +12 -0
  170. package/dist/backend/services/content-tree-walker.d.ts.map +1 -1
  171. package/dist/backend/services/content-tree-walker.js +40 -0
  172. package/dist/backend/services/content-tree-walker.js.map +1 -1
  173. package/dist/backend/services/page-builder-registry.d.ts +11 -2
  174. package/dist/backend/services/page-builder-registry.d.ts.map +1 -1
  175. package/dist/backend/services/page-builder-registry.js +10 -1
  176. package/dist/backend/services/page-builder-registry.js.map +1 -1
  177. package/dist/backend/services/page-paths.d.ts +87 -0
  178. package/dist/backend/services/page-paths.d.ts.map +1 -0
  179. package/dist/backend/services/page-paths.js +177 -0
  180. package/dist/backend/services/page-paths.js.map +1 -0
  181. package/dist/backend/services/storefront-resolver.d.ts +53 -2
  182. package/dist/backend/services/storefront-resolver.d.ts.map +1 -1
  183. package/dist/backend/services/storefront-resolver.js +313 -22
  184. package/dist/backend/services/storefront-resolver.js.map +1 -1
  185. package/dist/backend/services/translation/extract.d.ts.map +1 -1
  186. package/dist/backend/services/translation/extract.js +9 -1
  187. package/dist/backend/services/translation/extract.js.map +1 -1
  188. package/dist/manifest.d.ts +13 -1
  189. package/dist/manifest.d.ts.map +1 -1
  190. package/dist/manifest.js +592 -73
  191. package/dist/manifest.js.map +1 -1
  192. package/dist/migrations/20261022T163218_cms_brand_tokens.d.ts +24 -0
  193. package/dist/migrations/20261022T163218_cms_brand_tokens.d.ts.map +1 -0
  194. package/dist/migrations/20261022T163218_cms_brand_tokens.js +38 -0
  195. package/dist/migrations/20261022T163218_cms_brand_tokens.js.map +1 -0
  196. package/dist/migrations/20261023T052237_cms_page_tree_and_share.d.ts +24 -0
  197. package/dist/migrations/20261023T052237_cms_page_tree_and_share.d.ts.map +1 -0
  198. package/dist/migrations/20261023T052237_cms_page_tree_and_share.js +51 -0
  199. package/dist/migrations/20261023T052237_cms_page_tree_and_share.js.map +1 -0
  200. package/dist/migrations/20261027T165458_cms_page_parent_path_in_url.d.ts +16 -0
  201. package/dist/migrations/20261027T165458_cms_page_parent_path_in_url.d.ts.map +1 -0
  202. package/dist/migrations/20261027T165458_cms_page_parent_path_in_url.js +20 -0
  203. package/dist/migrations/20261027T165458_cms_page_parent_path_in_url.js.map +1 -0
  204. package/dist/migrations/20261028T090524_cms_page_breadcrumbs_overlay.d.ts +14 -0
  205. package/dist/migrations/20261028T090524_cms_page_breadcrumbs_overlay.d.ts.map +1 -0
  206. package/dist/migrations/20261028T090524_cms_page_breadcrumbs_overlay.js +18 -0
  207. package/dist/migrations/20261028T090524_cms_page_breadcrumbs_overlay.js.map +1 -0
  208. package/dist/migrations/20261029T131218_cms_page_translations.d.ts +15 -0
  209. package/dist/migrations/20261029T131218_cms_page_translations.d.ts.map +1 -0
  210. package/dist/migrations/20261029T131218_cms_page_translations.js +19 -0
  211. package/dist/migrations/20261029T131218_cms_page_translations.js.map +1 -0
  212. package/dist/migrations/index.d.ts +6 -1
  213. package/dist/migrations/index.d.ts.map +1 -1
  214. package/dist/migrations/index.js +11 -1
  215. package/dist/migrations/index.js.map +1 -1
  216. package/docs/cms/brand.md +310 -0
  217. package/docs/cms/contact-form.md +161 -0
  218. package/docs/cms/extending-page-builder.md +210 -15
  219. package/docs/cms/index.md +1232 -39
  220. package/docs/cms/page-navigation.md +83 -0
  221. package/i18n/en.json +2758 -22
  222. package/i18n/pl.json +2758 -22
  223. package/package.json +18 -16
  224. package/dist/admin/components/ButtonLinkFields.d.ts +0 -6
  225. package/dist/admin/components/ButtonLinkFields.d.ts.map +0 -1
  226. package/dist/admin/components/ButtonLinkFields.js +0 -127
  227. package/dist/admin/components/ButtonLinkFields.js.map +0 -1
package/docs/cms/index.md CHANGED
@@ -44,34 +44,1201 @@ The same `content` JSONB is scanned by the **Assets Library reference registry**
44
44
 
45
45
  ## Page Builder authoring
46
46
 
47
- The Page Builder is built on **Puck** (`@puckeditor/core`) and ships components
48
- in `@endora-commerce/cms-components`. Core layout/content defaults:
49
-
50
- | Component | Purpose |
51
- | --------------- | ---------------------------------------------------------------------- |
52
- | `Row` | Flex-column layout container. |
53
- | `Heading` | `h1`–`h6` with align + level select. |
54
- | `Text` | Simple body text with typography controls. |
55
- | `RichContent` | TipTap rich text (links modal, colors, images). |
56
- | `Button` | Label + link target + variant select. |
57
- | `Image` | URL or asset library; width modes + align. |
58
- | `Icons` | Visual Lucide icon picker (~100 curated icons). |
59
- | `Social` | Brand social icons (`react-icons`); link list shows network names. |
60
- | `Spacer` | Vertical spacing + optional divider. |
61
- | `FeatureList` | Icon + title + description columns. |
62
- | `Hero` | CTA banner with background, heading, button. |
63
- | `LogoStrip` | Partner / trust logos. |
64
- | `Testimonial` | Quote + author (+ optional avatar). |
65
- | `Stats` | KPI / counter strip. |
66
- | `AnnouncementBar` | Thin promo strip. |
67
- | `SimpleTable` | Simple pipe-separated table. |
68
- | `NewsletterSignup` | Email signup form (configurable action URL). |
69
- | `ContactFormEmbed` | Form iframe embed or mailto. |
70
- | `InsertBlock` | Embeds a Block by `code`. Storefront inlines the resolved Block. |
71
- | `InsertTemplate`| Legacy: embeds a Template by `code`. Kept for existing trees; **not** in the drawer palette. Prefer Save as / Apply template. |
72
-
73
- Additional categories (catalog, media, interactive, forms, advanced) ship
74
- Product*, Video, Map, sliders, Tabs, Accordion, RawHtml/RawJs, etc.
47
+ The Page Builder is built on **Puck** (`@puckeditor/core`). Its blocks are
48
+ declared in the manifests of the modules that own them and are drawn by
49
+ `@endora-commerce/cms-components`, both in the admin canvas and on the
50
+ storefront, so the preview and the published page match. Colours, fonts,
51
+ the type scale, buttons and spacing come from the brand settings, edited once
52
+ on the [Brand](./brand.md) screen.
53
+
54
+ ### Blocks
55
+
56
+ A page is built as a stack of **Sections**: `cms.Section` is the one block
57
+ that carries the [section settings](#section-settings) described below, and
58
+ it holds any other blocks. Feature 163 (page builder for marketing pages)
59
+ added, reshaped and removed blocks; the last column says what changed.
60
+
61
+ | Block | Palette label | What it is, and what changed |
62
+ | --- | --- | --- |
63
+ | `cms.Section` | Section | **New.** A band of the page with its own anchor, colour scheme, background, spacing, width, content position and entrance reveal, holding any blocks. It stands only at the top level of a page, or in a Section group. |
64
+ | `cms.SectionGroup` | Section group | **New.** Holds Sections and paints one colour scheme, background and decorative backdrop behind all of them, with no seam between them; optional space above and below and an anchor. It stands only at the top level of a page. See [Section groups](#section-groups). |
65
+ | `cms.Row` | Row | Columns layout container. Unchanged. |
66
+ | `cms.Column` | Column | A column inside a Row. **Extended** with **Distribute blocks vertically** (from the top, which is the default, center, to the bottom, space between, or the last block to the bottom); a block placed in a column can take another **Order in the column** per breakpoint, and the column itself another **Order in the row**: see [Columns: distribution and order](#columns-distribution-and-order). A column can also span rows of its Row and start at a given column or row per breakpoint: see [Columns: placement in the row's grid](#columns-placement-in-the-rows-grid). |
67
+ | `cms.Heading` | Heading | **Reshaped.** The text is inline rich text (bold, italic, link, three highlight styles, an icon from the icon catalog: see [Icons in headings and captions](#icons-in-headings-and-captions)). The semantic level (`h1`–`h6` or a paragraph) is chosen apart from the visual size, which is a type-scale token. Font, size, weight, style and line height stay available as **Custom** overrides in an "Advanced" group. |
68
+ | `cms.Text` | Simple Text | Body text with typography controls; it reads the brand tokens as defaults. **Extended** with a maximum text width per breakpoint (narrow, medium, wide or Custom px; none by default), which follows the text's alignment. |
69
+ | `cms.RichContent` | Rich Content | TipTap rich text. **Extended** with collapsible "read more" text, a check-mark list, links shown as buttons, heading anchors, visually hidden headings, the three highlight styles and a maximum text width per breakpoint. Its headings follow the brand's type scale once one is set (see [Rich-text headings and the type scale](#rich-text-headings-and-the-type-scale)). An image in the text takes a **Width** in px or %, an **Alignment** (left, center, right) and **In the line of text**, which sets it inside a sentence (a logo, a small avatar group); the same applies to every rich body of the other blocks. In the admin, **Image source** picks the image from the **Asset library** (its alternative text is filled in when the asset has one and the field is still empty) or takes a **URL**. |
70
+ | `cms.Button` | Button | **Reshaped.** One button described by a style (`primary`, `secondary`, `light`, `dark`), a fill (`solid`, `outline`, `text`), a size, an optional icon (before, after, or icon only), colour overrides and a link. Today's `ghost` variant is the `text` fill. |
71
+ | `cms.Image` | Image | **Extended.** A **Mobile image** shown below the tablet width, an **Aspect ratio** per breakpoint (Responsive tab; a preset or a custom `w:h`, the image's own ratio by default), an **Overlay** (solid or gradient, with direction and strength) and an optional **Caption** below or beside the image — an image with a sentence next to it, such as a small avatar group. **Full width** is the existing Width option; inside a Section with the **Bleed** width the image reaches the window's edges. The image is loaded lazily; with a ratio its space is reserved before it loads. With none of these set it looks as before. |
72
+ | `cms.Icons`, `cms.Social`, `cms.Spacer` | Icons, Social, Spacer / Divider | Unchanged. |
73
+ | `cms.Hero` | Hero / CTA banner | **Reshaped.** Media (solid colour, gradient, image with a mobile alternative, or self-hosted video with a poster and a **Video aspect ratio** per breakpoint for a video above the text, 16:9 by default) behind or above the text; eyebrow, title, subheading and statement, each with its own level and size; rich body text; up to six buttons; social proof (image and caption); **Overlay (darkens the background media)**, minimum height, alignment and an optional entrance reveal; the overlay's **Type** is none, solid or gradient, and only the settings that type uses are shown (the strength for solid and gradient, the direction for a gradient). **Elements: order and spacing** puts the eyebrow, title, subheading, statement, text, buttons and social proof in any order (unlisted ones follow in the default order), and each listed element can take a **Space after** it (a spacing size or a **Custom** px value); left on **Default**, an element keeps **Space between items**, or the default spacing when that is not set. **Media width: Full window width** lets an image or video reach the window's edges while the text stays in the hero. A video's mobile alternative is a library video, or a **Mobile video URL** with the URL source. **Poster source** sets where both stills come from: the **Asset library** (**Poster image**, **Mobile poster image**) or **URL** (**Poster URL**, **Mobile poster URL**); the mobile poster is the still shown before the mobile video plays, so a video of another shape is not shown cropped. The title takes a **Title weight** and a **Title max width** per breakpoint: see [Headings: weight and width](#headings-weight-and-width). |
74
+ | `cms.MediaText` | Media and text | **New.** Image or video (from the Assets Library or, with **Video source: URL**, by address, each with an optional mobile video shown below the tablet width, and with a **Video aspect ratio** per breakpoint, 16:9 by default) beside text, with side, mobile order, column split, vertical alignment, feature items with icons, buttons, a footnote, and repeated rows that can alternate sides. A video takes an optional **Mobile poster image** or **Mobile poster URL** for the mobile video. **Item title size** (a type-scale size or **Custom (px)**, per breakpoint) and **Item title weight** (300–800) restyle every feature item's title; left on **Default**, the titles stay 16 px semibold. |
75
+ | `cms.BackgroundPanel` | Background image panel | **New.** An image with a text panel on one side. To take it edge to edge, put it in a Section with the **Bleed** or **Full** width. **Transparent text box** (off by default) leaves the text panel without its scheme background, so the image shows through behind the text; choose the scheme so the text reads on the image. |
76
+ | `cms.CtaCard` | Call-to-action card | **New.** A boxed call to action in its own colour scheme, with a list, buttons, an optional image and the brand's decorative backdrop. |
77
+ | `cms.Statement` | Statement | **New.** A large statement or quote, optionally over an image that fills the block, with an optional word-by-word reveal and a maximum text width per breakpoint. A Section with the **Bleed** width takes it edge to edge. |
78
+ | `cms.LinkList` | Link list | **New.** Rows of title, description and button, with an optional divider. |
79
+ | `cms.FeatureList` | Feature list | **Reshaped.** Columns per breakpoint, uploaded SVG icons that take the text colour, rich item text, an optional image below the grid. |
80
+ | `cms.Stats` | Stats | **Reshaped.** Key figures with an optional heading and image. |
81
+ | `cms.Testimonial` | Testimonial | **Reshaped.** Adds an image and an image-overlay layout; the card layout is the default. |
82
+ | `cms.Video` | Video | **Extended.** **Source: Embed** (YouTube, Vimeo or a page URL, as before: the **Video URL** and the **Provider**) or **Video file**. For a file, **File source** sets where the video and its optional mobile version (shown below the tablet width) come from: the **Asset library** (**Video file**, **Mobile video file**) or **URL** (**Video URL**, **Mobile video URL**); **Poster source** does the same for the **Poster image** and **Mobile poster image**, or the **Poster URL** and **Mobile poster URL**. Only the fields of the chosen sources are shown. A video saved before the sources existed opens on the source its values imply — a URL with no library file is the URL source — and plays as before: with no source chosen, a library file or image wins over a URL. The **Aspect ratio** takes every preset and a custom `w:h`, per breakpoint (Responsive tab). A file loads nothing until it plays; with **Autoplay** it plays muted, only while on screen and never for a visitor who prefers reduced motion; otherwise the visitor starts it with its controls. **Rounded corners** (none, small, medium, large) round the player's frame; the default, medium, is the 8 px it always had. An autoplaying file is always muted, so **Muted** is offered only for a file that does not autoplay. |
83
+ | `cms.LogoStrip`, `cms.Map`, `cms.SimpleTable` | Logo strip, Map, Table | Unchanged. |
84
+ | `cms.AnnouncementBar` | Announcement bar | Unchanged. |
85
+ | `cms.ContentSlider` | Carousel | **Reshaped** into the one carousel: a header (heading, lead, button), slides per view per breakpoint (1–8, in steps of 0.25), slide or fade effect, arrow placement per breakpoint, an arrow style, shape, size and colour, dots, bleed to the viewport edge, optional autoplay. The same items can be laid out as a grid of columns per breakpoint, and an optional filter bar shows only the items with one tag. The slides per view are CSS, so the server and the browser render the same layout. See [Carousels: controls, grid and filter](#carousels-controls-grid-and-filter). |
86
+ | `cms.CarouselImage`, `cms.CarouselSplit`, `cms.LinkTile`, `cms.DownloadTile` | Carousel image, Carousel split slide, Link tile, Download tile | **New** carousel items, offered only inside a carousel. Each item, and a free-content slide, carries optional tags for the carousel's filter. A carousel image's caption over the image can sit on a scrim (a gradient from its edge or an even tint). A link tile's image ratio can differ per breakpoint. A carousel image takes **Image – rounded corners** (and its caption **Caption – rounded corners**), a link tile **Rounded corners** (none, small, medium, large; medium, 8 px, by default). A carousel image's caption, and a link tile's title and label, take a size per breakpoint and a font; a link tile's label is a text link with an arrow, a button or hidden. A download tile is a single download link to an Assets Library file; when the file is gone, customers see nothing and the preview shows a warning. |
87
+ | `cms.Tabs`, `cms.Accordion` | Tabs, Accordion | **Reshaped.** Each panel holds blocks instead of one HTML text, every panel is in the server-rendered HTML, and keyboard navigation follows the WAI-ARIA patterns. Tabs gain an animated panel change (fade or slide) and a tab bar look: the bar's background and border (a capsule around pills), the active and other tabs' colours, a hover colour for the other tabs, a **Tab size** per breakpoint (small, medium or large; medium when not set), and the **Space below the tab bar** (a spacing size or a **Custom** px value, per breakpoint; 12 px when not set). A panel in columns is a Row inside it: see [Tabs: a panel in columns](#tabs-a-panel-in-columns). **Tabs that do not fit** either wrap onto more lines (the default) or stay in one line that scrolls sideways inside the block, snapping to a tab; the page itself never scrolls sideways, and the keyboard works the same in both. Accordion item titles can be headings (H2–H6, the trigger inside the heading) with a size from the type scale; by default they are not headings and keep their look. |
88
+ | `cms.NewsletterSignup` | External newsletter form | Kept as the form that posts to **any external endpoint** (`actionUrl`). Gained an optional consent checkbox. The platform's own newsletter sign-up is the `newsletter.Signup` block below. |
89
+ | `cms.ContactFormEmbed`, `cms.RawHtml`, `cms.RawJs`, `cms.InsertBlock` | Contact / form embed, Raw HTML, Raw JS, Insert Block | Unchanged. `InsertBlock` embeds a Block by `code`; a Section in an embed placed at the top level of a page renders as a section. |
90
+ | `cms.InsertTemplate` | Insert Template | Legacy: kept for existing trees and **not** in the drawer palette. Prefer Save as / Apply template. |
91
+ | ~~`cms.ImageSlider`~~ | — | **Removed.** Use the Carousel with **Carousel image** items, which carry every caption option the image slider had. |
92
+
93
+ Blocks owned by other modules appear in the same palette while their module is
94
+ present:
95
+
96
+ | Block | Owner | What changed |
97
+ | --- | --- | --- |
98
+ | `blog.LatestPosts` | `blog` | **New.** The newest published posts of the channel, as a carousel or a grid. |
99
+ | `newsletter.Signup` | `newsletter` | **New.** Subscribes through the newsletter module, with optional topics and a required consent checkbox; works without JavaScript. |
100
+ | `catalog.ProductGrid`, `catalog.ProductSlider` | `catalog` | **Reshaped.** A header, a card variant (including a `showcase` card with a short summary), a "more" link label and a footer button; the slider takes the carousel options. |
101
+
102
+ **An empty listing shows nothing.** A product grid, product slider, category grid,
103
+ category list or latest posts block that finds nothing to show (no product in its
104
+ category, no post yet) leaves no trace on the storefront: no box, no heading, no
105
+ sentence. In the editor its preview still says why it is empty.
106
+
107
+ ### Content saved before a block changed shape
108
+
109
+ A reshaped block keeps every option it had: the option-parity test
110
+ (`packages/cms-components/src/components/option-parity.test.ts`) maps each
111
+ field the block had before the reshape to its new counterpart. Stored content
112
+ is not migrated in the database, and it does not need to be:
113
+
114
+ - **A reshaped block renders stored content as before.** Each reshaped block
115
+ carries a mapping from its earlier props (`heroFromLegacy`,
116
+ `headingFromLegacy`, `buttonFromLegacy`, `contentSliderFromLegacy`, and so on)
117
+ that runs when it renders. When an editor opens the page, the editor converts
118
+ the block to the new shape, and the next save stores it. A stored tab or
119
+ accordion panel written as HTML keeps rendering as that HTML until the page is
120
+ opened, when it moves into the panel as a **Rich Content** block.
121
+ - **A hero's spacing list moves into its element list.** A hero saved with
122
+ **Space after an element** keeps its spaces on the storefront. When the page is
123
+ opened, each space moves to its element in **Elements: order and spacing**,
124
+ which then lists every element in the order shown — nothing moves on the page.
125
+ - **A removed block degrades to the missing-block placeholder.** A stored
126
+ `cms.ImageSlider` renders nothing for customers, the rest of the page renders
127
+ normally, and the editor shows the placeholder where it was. Rebuild it as a
128
+ Carousel.
129
+
130
+ ### Section settings
131
+
132
+ The **Section** block (`cms.Section`) carries the section settings — anchor,
133
+ colour scheme, background, spacing, width, content position and an entrance
134
+ reveal — and a slot that holds any other blocks. Each setting is a field of
135
+ its own. Width, Space above, Space below, Content position and Overlap with the
136
+ previous section are set per breakpoint on the editor's **Responsive** tab: choose Base (mobile), Tablet or Desktop in
137
+ its **Scope settings** and edit the value for that breakpoint, as on a Row. The
138
+ other settings are on the **General** tab, with the anchor and the entrance
139
+ reveal last. No other block carries section settings; a block outside a
140
+ Section renders exactly as it does on its own.
141
+
142
+ A Section stands only at the **top level** of a page, or in a
143
+ [Section group](#section-groups). Every other slot — a row's columns, a tab or
144
+ accordion panel, a carousel slide, another Section — refuses it, and the
145
+ editor undoes a drop into one. A Section embedded with
146
+ `InsertBlock` at the top level of a page renders as a section. With nothing
147
+ set, a Section is neutral: no colour, the contained width and the `l` spacing.
148
+
149
+ | Setting | Options |
150
+ | --- | --- |
151
+ | Anchor | A fragment name such as `contact`, so that `/page#contact` scrolls to the section. See [Anchors](#anchors). |
152
+ | Color scheme | Inherit, Light, Muted, Dark. The scheme sets the text, heading, link, border and button colours of every block inside the section. |
153
+ | Background | None, solid colour, gradient, image or video. An image takes an optional mobile image, a focal position, a **size** (Cover, the default; Contain, the whole image; Natural size; or a width in px or %) and a **repeat** (none, the default; tile; across; down); a video takes a poster and an optional mobile video. An overlay (solid or gradient, with direction and strength) can sit above the media. On the dark scheme, **Decorative backdrop** paints the brand's decorative image; with it switched on, **Backdrop size**, **Backdrop repeat** and **Backdrop position** set how it is drawn (Cover from the top centre, not repeated, until changed). A size in px keeps the image or backdrop that size on every screen width. With a mobile image or mobile video, **Mobile image or video shown on** sets where it gives way to the desktop one: **Phones (below 768 px)**, the default, or **Phones and tablets (below 1024 px)**. |
154
+ | Space above / Space below | Responsive tab. A step of the brand spacing scale (`none`, `xs`, `s`, `m`, `l`, `xl`, `xxl`) or a pixel value, per breakpoint; a breakpoint left on **Inherit** takes the one below it. Spacing is padding, so two adjacent dark sections touch and read as one dark area. |
155
+ | Width | Responsive tab. Contained, Wide, Full, Viewport (the full viewport wide and at least the full viewport tall), Bleed (content to the edges) or Custom, which shows **Custom max width (px)**: one maximum width in pixels. Set it per breakpoint for a section that is, say, **Bleed** on phones (a box edge to edge) and **Contained** from the desktop up; a width chosen once applies at every breakpoint, as before. A Custom width wider than the page container widens the section beyond the container, centred, up to the window less the page's side margin; narrower than the container, it stays inside it. |
156
+ | Content width | Shown with Full, Viewport or Bleed: the background keeps that extent and the content sits in the page container, the wide frame, to the edges or in a custom max width. A dark band across the whole screen with its content in the container is **Bleed** with content width **Page container**; only **Viewport** also makes the section the full screen tall. Left unset, the width's own content frame applies. |
157
+ | Content position | Responsive tab. Top, Middle or Bottom, per breakpoint: where the content sits when the section is taller than it, as a Viewport section is. |
158
+ | Overlap with the previous section | Responsive tab. A step of the brand spacing scale or a pixel value, per breakpoint; **None** until set. The section's content moves up by that much over the bottom of the section before it and is drawn above that section's background, while this section's own background stays in place, for example an image that rises into a dark band of features. Keep it within the previous section's space below, or its content is covered. The first block of a page overlaps nothing. In the editor the content is not moved, so the previous section stays easy to select; a hatched band at the top of the section shows how far it will overlap on the previewed breakpoint. |
159
+ | Entrance reveal | None or fade-up, optionally on desktop only. See [Motion](#motion). |
160
+
161
+ A newsletter sign-up inside a Section with an anchor brings the visitor back
162
+ to that anchor after a sign-up without JavaScript.
163
+
164
+ **An empty Section takes no space.** When none of a Section's blocks shows
165
+ anything on the page — a news list with no posts yet, a product list with no
166
+ products, or blocks hidden on that breakpoint with **Hide on** — the published
167
+ Section drops its space above and below (and its overlap and minimum height),
168
+ so the page shows no blank band. A Section with a background image or video
169
+ keeps its size, since the media is its content. The editor always shows the
170
+ Section with its space, so you can drop blocks into it. Browsers without
171
+ support for the CSS `:has()` selector (older than 2023) show the empty space
172
+ as before.
173
+
174
+ ### Section groups
175
+
176
+ A **Section group** (`cms.SectionGroup`) holds a run of Sections and paints
177
+ one background behind all of them. Use it when several adjacent Sections share
178
+ a dark band with the brand's decorative backdrop: on separate Sections each one
179
+ paints its own copy of the backdrop from its own top, so a hard edge shows at
180
+ every boundary; in a group the backdrop is painted once, from the group's top,
181
+ and runs on behind every Section in it.
182
+
183
+ A group stands only at the **top level** of a page, and its slot accepts
184
+ **Sections only**: the editor undoes a drop of any other block into it, and of
185
+ a group into any slot. Its settings:
186
+
187
+ | Setting | Options |
188
+ | --- | --- |
189
+ | Color scheme | Inherit, Light, Muted, Dark. The Sections in the group take this scheme unless they set their own. |
190
+ | Background | The same choices as a Section's: none, solid colour, gradient, image or video, with the overlay, and on the dark scheme **Decorative backdrop**. It is painted once, across the full window width, behind all the group's Sections. |
191
+ | Space above / Space below | Responsive tab. A step of the brand spacing scale or a pixel value, per breakpoint; **None** until set, since the Sections carry their own spacing. |
192
+ | Anchor | A fragment name for the whole group, as a Section's. |
193
+
194
+ While the group paints — it has a scheme or a background — a Section in it
195
+ with no background of its own and the group's scheme (or **Inherit**) is
196
+ transparent, so the group's background shows through it. A Section that sets
197
+ a background, a decorative backdrop or another scheme paints it as usual, for
198
+ example a light band inside a dark group. With neither a scheme nor a
199
+ background, the group paints nothing and its Sections look as they would
200
+ without it.
201
+
202
+ Inside a group a Section keeps everything else: its width, spacing, content
203
+ width, anchor and overlap. The first Section of a group can overlap the block
204
+ before the group (the group's own space above is covered first); the first
205
+ Section of a group that opens the page overlaps nothing. An empty Section in a
206
+ group takes no space, as anywhere, and a group none of whose Sections shows
207
+ anything drops its own space above and below too. A group stored inside
208
+ another block (which the editor refuses) renders its Sections' content only.
209
+
210
+ ### Colour schemes
211
+
212
+ The three schemes — light, muted and dark — are defined once on the
213
+ [Brand](./brand.md) screen. A section with a scheme renders
214
+ `data-cmsb-scheme="light|muted|dark"`, which rebinds the scheme variables
215
+ (`--cmsb-fg`, `--cmsb-bg`, `--cmsb-fg-muted`, `--cmsb-border`,
216
+ `--cmsb-link`) for everything inside it. Colour fields in the blocks also
217
+ accept a brand colour: the colour picker lists **Brand colors** first and
218
+ stores a token such as `token:primary`, which follows later brand changes.
219
+ A hex value stays available as an override.
220
+
221
+ Inside a section with a scheme, the blocks' secondary text — feature
222
+ descriptions, product SKUs and stock, category counts, an inactive or active
223
+ tab — takes the scheme's muted or main text colour, so it stays legible on the
224
+ dark scheme. The light grey behind a link tile's or a carousel image's picture
225
+ gives way to the section's own background, so artwork with a transparent
226
+ background shows no light card on a dark section; an item with no image yet
227
+ shows a faint tint of the scheme's text colour instead. A bordered product
228
+ card takes the scheme's background and border, and an active pill tab inverts
229
+ the scheme's colours. Outside a section with a scheme, all of these look as
230
+ they did before.
231
+
232
+ ### Anchors
233
+
234
+ A Section's anchor and a heading anchor in Rich Content become element ids,
235
+ and a button, a rich-text link or a link field of the **In-page anchor** kind
236
+ can target them. The editor normalises what is typed — lower case, ASCII,
237
+ hyphens, a leading letter, at most 64 characters — so `Contact Us!` becomes
238
+ `contact-us` and `9x` becomes `a-9x`. The link field lists the anchors on the
239
+ current canvas: the anchors of its top-level Sections and Section groups, and
240
+ of the Sections inside a group.
241
+
242
+ Saving page, block or template content is refused with `422` when an anchor
243
+ breaks one of two rules, checked per language tree:
244
+
245
+ | Error | When |
246
+ | --- | --- |
247
+ | `CMS_DUPLICATE_ANCHOR` (`details.anchor`) | The same anchor is used twice in one language's content. A section anchor and a heading anchor conflict with each other; the same anchor in two languages is allowed. |
248
+ | `CMS_RESERVED_ANCHOR` (`details.anchor`) | The anchor is an id the storefront layout already uses: `main-content`, `cmsb`, `cmsb-header-offset`, `b2b-locale`, `b2b-currency`, `ga-gtag-src`, `ga-gtag-init`, `gtm-init`. |
249
+
250
+ The reserved list is `RESERVED_ANCHORS` in
251
+ `packages/contracts/src/page-builder-values.ts`, re-exported by the storefront
252
+ as `storefront/app/reserved-anchors.ts`. Only the anchors of top-level
253
+ Sections, of top-level Section groups and of the Sections inside a group
254
+ count, because only they render an id. A
255
+ refused save writes nothing and records no audit entry. The storefront
256
+ offsets the scroll target by its sticky header
257
+ (`scroll-margin-top: var(--cmsb-header-offset)`).
258
+
259
+ ### Section presets
260
+
261
+ The block drawer offers ready-made sections — hero, media and text,
262
+ call-to-action card, downloads, feature grid and statement — assembled from
263
+ the blocks above with neutral placeholder copy in the editor's language.
264
+ Each preset is a Section holding its block. Inserting one adds it at the top
265
+ level, after the selected block's top-level Section or at the end of the page,
266
+ without replacing the canvas; when the selected block is in a Section of a
267
+ Section group, the preset goes into that group, after its Section; everything in it is then edited like any other block. The presets
268
+ are code (`packages/cms-components/src/editor/section-presets.ts`), versioned
269
+ with the blocks they build, and their copy is in the `cms` bundle under
270
+ `presets.*`.
271
+
272
+ ### Parent page and breadcrumbs
273
+
274
+ The page editor's **Breadcrumbs** card sets:
275
+
276
+ - **Parent page** — the page shown before this one in the breadcrumb trail.
277
+ It changes the page's address only with the option below. A page cannot be its own parent or
278
+ be placed under one of its subpages, and the tree is at most eight levels
279
+ deep; a refused choice answers `422 CMS_PAGE_PARENT_CYCLE`. Deleting the
280
+ parent clears the field on its children.
281
+ - **Include the parent page's path in the address** — off by default, so a
282
+ page keeps its flat `/<slug>`. On, the page is served under its parent's
283
+ address: `/<parent path>/<slug>`. The parent's own address follows the same
284
+ rule, so a tree whose lower pages all opt in gives addresses such as
285
+ `/services/consulting/workshops`. See *Nested page
286
+ addresses* below.
287
+ - **Show breadcrumbs** — on by default.
288
+ - **Breadcrumb color scheme** — light (the default, which paints nothing),
289
+ muted or dark. On muted and dark the links take the scheme's muted text
290
+ colour (its text colour on hover) and the current page its text colour.
291
+ - **Show the breadcrumbs over the first section** — off by default. On, the
292
+ trail lies over the top of the page's first section (a hero, for example)
293
+ instead of in a band above it, and nothing on the page moves down: no band is
294
+ painted, and the trail keeps the brand's page container and side margin.
295
+ Choose the **dark** scheme for a light trail on a dark image. The first
296
+ section is not padded for the trail automatically — give it enough top
297
+ padding (its **Space above**, or the hero's own) so the trail does not cover
298
+ its content.
299
+
300
+ The storefront renders *Home › ancestors › page*. Every crumb is labelled with
301
+ the page's **name** — the current page's and each ancestor's alike (until
302
+ 2026-10-27 an ancestor showed its meta title instead). An ancestor that is not
303
+ published in the request's sales channel is shown as plain text, not as a
304
+ link, and its slug never leaks across channels. The trail sits in the brand's
305
+ page container and side margin, so it lines up with the page content. On the
306
+ muted or dark scheme the painted band holds its own space below the trail, so
307
+ a dark first section follows it with no light strip in between. The trail's
308
+ `BreadcrumbList` structured data uses absolute URLs. The fields are
309
+ stored on `cms_pages` (`parent_page_id`, `breadcrumbs_visible`,
310
+ `breadcrumbs_scheme`, `breadcrumbs_overlay`, `share_image_asset_id`) and are
311
+ part of the `cms_page.update` audit entry.
312
+
313
+ ### Nested page addresses
314
+
315
+ A page's **public path** is its own slug, or — when **Include the parent
316
+ page's path in the address** is on (`parentPathInUrl`, stored as
317
+ `cms_pages.parent_path_in_url`) — its parent's public path, a `/` and its
318
+ slug. The path is computed when the page is read, per sales channel, from the
319
+ slug each channel serves a page under; it is never stored. So:
320
+
321
+ - **Renaming or moving a parent moves every nested page below it.** The old
322
+ address stops answering; there is no automatic redirect from it.
323
+ - **The page's own slug keeps answering**, with a permanent (308) redirect to
324
+ its path, so links made before the option was switched on keep working.
325
+ - **A parent the channel does not serve** leaves the page at its own slug in
326
+ that channel.
327
+ - **Two pages cannot share an address in one channel.** A save that would
328
+ give a page — or a nested page below it — an address another page already
329
+ has is refused with `409 CMS_SLUG_CONFLICT`, and nothing is written.
330
+ - The first segment of a nested address is the top page's slug, which the
331
+ reserved-segment rule already checks, so a nested page cannot shadow a
332
+ storefront route such as `/p/…`, `/c/…`, `/cart` or `/account`.
333
+
334
+ The page editor shows the resulting address under **Public address**. The
335
+ storefront's breadcrumb links, canonical link, `og:url` and sitemap use the
336
+ path, and a Page Builder link to a page is rendered at the page's path in the
337
+ request's channel.
338
+
339
+ ### Name, slug and description per language
340
+
341
+ A page's **Name**, **Slug** and **Description** in the *Page metadata* card
342
+ are its defaults. The **Language version** card gives each language of the
343
+ page its own name, slug and description, next to that language's meta title,
344
+ meta description and meta keywords. A field left empty uses the page's own
345
+ value, which the card shows greyed out as a hint. The card edits the language
346
+ the canvas shows: the language tabs in the card and above the canvas switch
347
+ both. While a language's slug has not been typed, it follows that language's
348
+ name, as a new page's slug follows its name.
349
+
350
+ The overrides are stored in `cms_pages.translations`
351
+ (`{ "<lang>": { "name", "slug", "description" } }`, `{}` for a page that
352
+ overrides nothing) and are part of the `cms_page.update` audit entry. An
353
+ override counts only while the page has its language: removing a language
354
+ from the page keeps its overrides stored but unused, and adding the language
355
+ back brings them back. The API refuses an override of a language the page does
356
+ not have with `400 CMS_LANGUAGE_NOT_IN_CHANNEL_SCOPE`.
357
+
358
+ On the storefront:
359
+
360
+ - **Each language is served at its own slug** — and, for a nested page, at its
361
+ ancestors' slugs in that language, under that language's path prefix, as a
362
+ product's address is: `/pl/o-nas` in Polish, `/en/about-us` in English (`/o-nas`
363
+ when the channel does not prefix its default language — see *Sales channels*).
364
+ - **A page is found by its slug in any of its languages**, and by its own slug,
365
+ and served in the visitor's language. When the address asked for is not the
366
+ page's address in that language — a visitor switched language on the page —
367
+ the storefront answers a permanent (308) redirect to the right one.
368
+ - **Two pages cannot share an address in one channel and one language.** The
369
+ same slug may be one page's in Polish and another page's in English. A save
370
+ that breaks this is refused with `409 CMS_SLUG_CONFLICT` (`details.language`
371
+ names the language) and nothing is written.
372
+ - The page's name in the served language is its title fallback and its crumb in
373
+ every breadcrumb trail, and a Page Builder link to a page is rendered at the
374
+ page's address in the served language.
375
+ - The canonical link is the served language's address; every language is a
376
+ `hreflang` alternate, and the sitemap lists every language's address with
377
+ the others as alternates. The reserved-segment rule checks every language's
378
+ slug.
379
+
380
+ The description is the page's internal note and is not shown on the storefront.
381
+ The page list's search finds a page by its name or slug in any language.
382
+
383
+ ### Sharing image and search metadata
384
+
385
+ The page editor's **Sharing** card picks a **Sharing image** from the Assets
386
+ Library — about 1200 × 630 px suits most networks. Without one, the page uses
387
+ the setting `cms.default_share_image_asset_id` (**Settings → Page Builder →
388
+ Default sharing image**, settable per sales channel). Only public assets are
389
+ published. An asset used as a sharing image cannot be deleted
390
+ (`409 ASSET_REFERENCED`).
391
+
392
+ The storefront then emits, for a CMS page and for a CMS-backed home page:
393
+
394
+ - `og:image` and `twitter:card` `summary_large_image` when an image exists
395
+ (`summary` otherwise);
396
+ - `og:locale` for the served language and `og:locale:alternate` for the
397
+ page's other languages that have content. A CMS page also has `hreflang`
398
+ links, one per language, because each language has its own address (see
399
+ *Name, slug and description per language*). The CMS-backed home page has
400
+ none: `/` serves every language;
401
+ - `Organization` structured data with the shop logo and social profiles from
402
+ the Settings module (`shop.logo_asset_id`, `shop.social_profiles`).
403
+
404
+ ### Headings: weight and width
405
+
406
+ A block's heading keeps the look of its size until you choose otherwise. Two
407
+ options change it:
408
+
409
+ - **Heading weight**: **Default** (the size's own weight, as before) or a
410
+ weight from Light (300) to Extra bold (800).
411
+ - **Heading max width**, per breakpoint on the Responsive tab: **None (full
412
+ width)** by default, **Narrow**, **Medium**, **Wide** (about 36, 48 and
413
+ 60 rem) or **Custom (px)**. A long heading then wraps at that width; in a
414
+ centred block it stays centred.
415
+
416
+ Both are on the media-and-text block, the background image panel, the
417
+ call-to-action card, the link list, the feature list, the stats, and the
418
+ header of the carousel, the product grid and slider, and the latest posts.
419
+ The statement takes the weight only: its **Max text width** already holds the
420
+ heading and the text. On the hero the same pair is **Title weight** and
421
+ **Title max width**.
422
+
423
+ Smaller texts take a weight too: the feature list's **Title weight** (every
424
+ item title), a carousel image's **Caption weight**, a link tile's **Title
425
+ weight** and **Label weight**, and the product listings' **Card title
426
+ weight** (the product name on every card). **Default** keeps each one's look.
427
+
428
+ The carousel and the product card read the brand's **body font**, as the other
429
+ blocks' texts do: the filter bar, the header's lead and the cards' texts follow
430
+ the brand screen. With no brand font set they keep the page's font.
431
+
432
+ ### Icons in headings and captions
433
+
434
+ Every text edited as inline rich text — a heading, a block's title, a carousel
435
+ image's caption — can hold an icon from the same icon catalog the feature list
436
+ and the icon block use. Place the cursor, choose **Insert icon** in the text's
437
+ toolbar and pick an icon; search by name. The icon sits on the line of text, at
438
+ the text's size and in its colour (inside a gradient highlight it takes the
439
+ accent colour), and is removed like a character.
440
+
441
+ In the same dialog, before picking the icon, **Icon size** sets its size:
442
+ **Text size (1 em)**, the default; **Relative to the text (em)**, from 0.5 to 3
443
+ times the text's size, so the icon scales with the heading on every screen; or
444
+ **Fixed (px)**, from 8 to 200 pixels. **Vertical offset (em)** raises the icon
445
+ (a positive value, up to 1) or lowers it (a negative value, down to −1), in
446
+ units of the text's size; left empty, the icon sits on the line as before. To
447
+ change an icon already in the text, select it (for example with the arrow
448
+ keys) and choose **Edit icon**: the dialog opens with its values, **Apply**
449
+ keeps the icon and writes the new size and offset, and picking another icon
450
+ replaces it.
451
+
452
+ The icon is decoration: it is hidden from screen readers, so the heading is
453
+ read by its words alone, and it is not sent for translation — a translated
454
+ heading keeps it where the translation puts it.
455
+
456
+ ### Rich-text headings and the type scale
457
+
458
+ Headings written inside rich text — a Rich Content block and the text of the
459
+ media-and-text block, the call-to-action card, the hero, the feature list and
460
+ the other blocks with a rich body — follow the **type scale** of the
461
+ [brand settings](./brand.md): a Heading 4 in the text takes the Heading 4 size
462
+ (mobile and desktop), line height, weight and letter spacing. Until a type scale
463
+ is set for a heading level, headings of that level keep their look as before.
464
+
465
+ ### Text sizes, line heights and spacing in blocks
466
+
467
+ The smaller texts of the content blocks take their own look, each option empty
468
+ or on **Default** until you choose otherwise, so a block already on a page keeps
469
+ its look. Three rules hold for every block:
470
+
471
+ - **A size is a step of the type scale or Custom (px).** A step (**Body**,
472
+ **Lead**, **Heading 4** …) brings the brand's line height, weight and letter
473
+ spacing of that step with it, at every breakpoint — so a text set to **Body**
474
+ looks like body text everywhere. Sizes are set per breakpoint on the
475
+ **Responsive** tab.
476
+ - **A line height is offered with a Custom (px) size only.** A step already has
477
+ its own; a line height (a multiple of the size, for example 1.5) applies only
478
+ at a breakpoint whose size is Custom (px).
479
+ - **A weight is one value for every breakpoint.** It wins over the step's own
480
+ weight. A weight saved per breakpoint by an earlier version of these options
481
+ is read as its desktop value, else its base value.
482
+
483
+ Spaces inside a block are one step of the brand spacing scale (**None**,
484
+ **XS** … **XXL**), not a pixel value per element; a step has its own phone and
485
+ desktop size, so it follows the breakpoints and the brand.
486
+
487
+ - **Feature list**: **Text size**, **Text weight** and **Text line height** for
488
+ every item's text (by default a small, muted line); **Title line height**
489
+ with a Custom title size; **Space inside each item** — the space after the
490
+ icon, below the title and between the paragraphs. **Icon position: Beside
491
+ the title** puts the icon at the start of the title, and the title and the
492
+ text hang beside it: a wrapped line starts under the text, not under the
493
+ icon.
494
+ - **Hero**: the subheading and the statement take a **weight**, a **line
495
+ height** (with a Custom size) and a **max width**, like the title; the text
496
+ takes a **Text size** (16 px by default), **weight**, **line height** and
497
+ **max width**. The hero has one **Text color** for all its texts; the eyebrow
498
+ may take its own **Eyebrow color** as an accent. **Space between items**
499
+ offers **Custom (px)**. With media **Above the content**, **Space below the
500
+ media** sets the space between the image or video and the texts (none by
501
+ default). The social-proof image keeps its 40 px height.
502
+ - **Statement**: **Heading line height** (with a Custom heading size), and the
503
+ supporting text's **size**, **weight** and **line height**. Over a background
504
+ image, **Minimum height** (**Default** is 60 % of the screen's height; also
505
+ half, three quarters, the full screen, **Auto** or **Custom (px)**).
506
+ - **Stats**: the labels' **size** and **weight** (their colour is the scheme's
507
+ muted text; **Value color** stays the figures' accent). Beside an image, from
508
+ the tablet up, **Layout (image – figures)** places the image and the figures
509
+ on 12 columns (see *Layouts on 12 columns* below), and **Figures vertical
510
+ position**: **Center** (default), **Top**, **Bottom** or **Spread over the
511
+ image height**.
512
+ - **Link list**: **Row title size** and **Row title weight**.
513
+ - **Call-to-action card**: **Rounded corners** (**Default** keeps today's) and
514
+ **Image inset**: the card's padding by default, **None** (the image reaches
515
+ the card's edges) or **Custom (px)**, one value for every breakpoint.
516
+ - **Media and text**: **Side by side from** the tablet (768 px, default) or the
517
+ desktop (1024 px); below it the media and the text stack, in the **Order on
518
+ mobile**.
519
+ - **Rich content**: **Text size** and **Text weight** for the whole text; its
520
+ lists follow them.
521
+ - **Row**: **Space between rows (px)** is set per breakpoint; one value saved
522
+ before applies at every width.
523
+
524
+ In any rich text, the toolbar's **Text size** sizes the selected words with a
525
+ step of the type scale, and **List marker** chooses the markers of a bulleted
526
+ list: **Disc** (default), **Check mark**, **Chevron** or **None**. The page and
527
+ the editor render both the same. Words sized in pixels by an earlier version of
528
+ the toolbar keep their size until a step is chosen for them. A check mark is
529
+ drawn in the brand's primary colour and a chevron in the text's colour; a
530
+ block's **List marker color** (Rich content, Media and text) gives both
531
+ markers a colour of their own, for example white ticks on a dark Section.
532
+
533
+ A **Simple Text** block takes bold, italic, links and highlights: its text is
534
+ edited like a heading's. A text saved before keeps its plain text until it is
535
+ edited.
536
+
537
+ A heading that starts with an icon can hang its text beside the icon:
538
+ **Hanging indent after a leading icon** keeps a wrapped line under the text,
539
+ which starts 0.35 em after the icon.
540
+
541
+ #### Layouts on 12 columns
542
+
543
+ Media and its text side by side — the **Carousel split slide**, **Stats**
544
+ beside an image and the **Call-to-action card** with an image — take a
545
+ **Layout** from the side-by-side width up: **Default** (two equal halves, as
546
+ before) or a preset of columns of 12, named media first — **6 – 6**, **7 – 5**,
547
+ **5 – 7**, **8 – 4**, **4 – 8**, and **5 – 1 – 6** or **6 – 1 – 5** with a
548
+ column between (not on the card). With the media on the right the layout is
549
+ mirrored. **Advanced layout (columns of 12)** shows the widths in columns, the
550
+ columns between and **Columns aligned to** instead, and they win over the
551
+ preset while the switch is on; widths saved before the switch existed open with
552
+ it on. **Media and text** keeps its **Split (media – text)** as the layout and
553
+ offers the same switch for its widths in columns of 12.
554
+
555
+ A **gradient highlight** that wraps onto several lines is one gradient across
556
+ the whole phrase: each line continues it rather than starting it again.
557
+
558
+ ### Carousels: controls, grid and filter
559
+
560
+ The options below are on the Carousel; the arrow placement, style,
561
+ alignment and the loop apply to the product slider and the latest posts
562
+ carousel as well.
563
+
564
+ | Option | Where | What it does |
565
+ | --- | --- | --- |
566
+ | **Arrow placement** | Responsive tab | Below the slides, in the header or over the slides, chosen per breakpoint. For example, arrows in the header on desktop and below the slides on a phone. |
567
+ | **Arrow style**, **shape**, **size**, **colour** | Controls (General tab) | Style: the default light circle, an outline or a solid fill. Shape: round or square. Size: 32, 36 (default) or 44 px. Colour: a brand colour or a hex value, used for the outline and icon, or as the fill. With nothing chosen the arrows look as before. |
568
+ | **Arrow icon** | Controls (General tab) | **Chevron** (default, as before) or **Arrow**, a drawn arrow from the icon catalog. The buttons, their names for screen readers and their style options stay the same. |
569
+ | **Next arrow style** | Controls (General tab) | **Same as the arrow style** (default), or a style of its own for the next arrow: for example an outline previous arrow beside a solid next one. Shape, size and colour stay shared. |
570
+ | **Controls alignment** | Responsive tab | Where the arrows and dots below the slides sit, per breakpoint: **Center** (default), **At the start**, **At the end**, **Spread out**, or **Arrows at both ends** with the dots centred between them. Only the position changes: the keyboard order stays previous, dots, next. |
571
+ | **Align the controls to** | General tab | **The content edge** (default) or **The first slide**: the arrows and dots below the slides line up with the first slide instead of the content. With **Bleed past the content edge**, the controls then end where the first slide ends rather than at the content's edge. Arrows in the header or over the slides do not move. |
572
+ | **Loop at the ends** | General tab | **Yes** (default, as before): the previous arrow on the first slide goes to the last one, and the next arrow on the last slide back to the first. **No**: the carousel stops at its ends, and the arrow that cannot go further is disabled — a screen reader announces it as unavailable and the Tab key skips it; if it had the keyboard focus, the focus moves to the other arrow. Autoplay then stops on the last slide. |
573
+ | **Disabled arrow look (no loop)** | Controls (General tab) | How an arrow disabled at an end looks: **Dimmed** (default), **Light outline (dark backgrounds)** — a transparent arrow with a faint white outline — or **Color**, an outline in the **Disabled arrow color** (a brand colour or a hex value). |
574
+ | **Layout** | General tab | **Carousel** (default) or **Grid**. A grid shows every item in **Columns** per breakpoint (1–6, set on the Responsive tab), with no arrows, dots or autoplay. Every item kind works in both. |
575
+ | **Filter** | General tab | **Show a filter bar**, the **“All” label** (left empty, the page language's word is shown) and the **tags to filter by**, each with the label visitors see. **Bar style**: **Pills** (default) or **Underlined tabs**, a line under the bar with the chosen tag underlined. **Bar alignment**: **Left** (default), **Center** or **Right**. **Buttons that do not fit**: **Wrap onto more lines** (default) or **Scroll in one line**. |
576
+
577
+ To filter, give each item its **Tags** (comma-separated, for example
578
+ `offices, retail`) and list the same tags in the carousel's filter. Tags are
579
+ compared without regard to case or surrounding spaces. Only the labels are
580
+ translated; the tags stay as they are.
581
+
582
+ The filter bar is a row of toggle buttons that wraps on a narrow screen; with
583
+ **Scroll in one line** it stays one line that the visitor swipes sideways
584
+ instead, snapping to a button, and a button reached with the keys or tapped
585
+ scrolls into view without pushing the page sideways. The
586
+ keyboard moves between the buttons with the arrow keys, Home and End, and a
587
+ screen reader hears how many items are shown after each change. Filtering
588
+ happens in the browser only: every item is in the server-rendered HTML, so a
589
+ search engine and a visitor without JavaScript see them all.
590
+
591
+ A carousel image's **Caption scrim** darkens the image behind a caption placed
592
+ over it, for legibility on a busy photo: a gradient from the caption's edge,
593
+ or an even tint, at a strength of 0–90 %. With a scrim, the caption drops its
594
+ own dark box unless you gave it a background colour.
595
+
596
+ A carousel image's **Caption size** and a link tile's **Title size** and
597
+ **Label size** are a type-scale size (Small, Body, Lead, Heading 1–6, Display)
598
+ or a **Custom (px)** value, chosen per breakpoint on the Responsive tab;
599
+ **Caption font**, **Title font** and **Label font** pick the brand's heading
600
+ or body font, and **Caption weight**, **Title weight** and **Label weight** a
601
+ weight from 300 to 800. Left on **Default**, the caption stays 14 px semibold
602
+ and the title 18 px semibold, as before. A link tile's **Label style** is a **Text
603
+ link with an arrow** (default), a **Button** in the primary button's look, or
604
+ **None**; the whole tile stays a single link either way.
605
+
606
+ A carousel image's **Caption hover color** and a link tile's **Title hover
607
+ color** and **Label hover color** (a brand colour or a hex value) change that
608
+ text's colour while the pointer is over the item or the item has the keyboard
609
+ focus, with a short fade between the two colours — at once for a visitor who
610
+ prefers reduced motion. The label colour applies to the text-link label; a
611
+ label shown as a button keeps the button's own hover look. Left empty, the
612
+ text keeps its colour.
613
+
614
+ A link tile's **Title color** and **Label color** (a brand colour or a hex
615
+ value) set the colour of its title and of its text-link label at rest, so a
616
+ hover colour has a colour to change from — for example a grey title that turns
617
+ white on hover. A label shown as a button keeps the button's colours. Left
618
+ empty, the title and the label keep their usual colours.
619
+
620
+ Both colours are set per breakpoint on the **Responsive** tab, so a tile can
621
+ rest in one colour on phones and tablets and in another on desktop — for
622
+ example a white title over the image on narrow screens and a dark one under it
623
+ on wide screens. A colour set for one breakpoint applies from that breakpoint
624
+ up until a wider one has its own; a breakpoint below the first one with a
625
+ colour keeps the usual colour. A colour set before this option existed is the
626
+ colour of every breakpoint, as before. A hover colour still wins on hover.
627
+
628
+ A carousel image's **Caption weight** and a link tile's **Title weight** and
629
+ **Label weight** are set per breakpoint on the **Responsive** tab too, so a
630
+ tile title can be regular on phones and tablets and medium on desktop. A weight
631
+ set for one breakpoint applies from that breakpoint up until a wider one has
632
+ its own; a breakpoint below the first one with a weight, or left on
633
+ **Default**, keeps the usual weight. A weight set before this option existed is
634
+ the weight of every breakpoint, as before.
635
+
636
+ ### Carousel controls, buttons, download tiles and image cards: look options
637
+
638
+ Every option below is unset by default, and a page saved before them looks as
639
+ it did.
640
+
641
+ **Carousel controls** (the Carousel, the product slider and the latest posts
642
+ carousel, under **Controls**):
643
+
644
+ | Option | What it does |
645
+ | --- | --- |
646
+ | **Arrow icon color (solid style)** | The glyph of a **Solid** arrow (or a solid next arrow), white by default — so a white solid arrow can carry a black icon. Shown once an arrow style is Solid. |
647
+ | **Hide the arrows on**, **Hide the dots on** | The breakpoints (mobile, tablet, desktop) where the arrows or the dots are not shown, for example arrows only from the desktop up while phones and tablets swipe. A row of controls left with nothing to show there is removed, so it leaves no gap. |
648
+
649
+ The dots follow the colour scheme: in a dark Section the current dot is the
650
+ scheme's light text colour over faint dots, so it stays visibly current.
651
+
652
+ Arrows placed **In the header** show even when the carousel has no heading:
653
+ the header then holds only the arrows, at its end, as beside a heading. The
654
+ Carousel's **Arrow placement** also offers **Inside each split slide (under
655
+ its text)**: every **Carousel split slide** shows the arrows and dots at the
656
+ end of its text column, and only the slide on screen has working controls (the
657
+ others are hidden from the keyboard and screen readers). Like the other
658
+ placements it is chosen per breakpoint, for example below the slides on a
659
+ phone and under the text from the tablet up. A carousel whose items are not
660
+ split slides keeps its controls below the slides there. Free-content slides
661
+ (**Slide**) cannot hold the controls.
662
+
663
+ The product slider's and product grid's **Button below the products** takes a
664
+ **Button alignment**: **Left** (default), **Center** or **Right**.
665
+
666
+ **Button** (`cms.Button`):
667
+
668
+ - Its **Outline** fill is filled with the Section's background, as the
669
+ `secondary` button it replaced was. **Transparent outline fill** lets the
670
+ background show through instead (offered with an outline fill).
671
+ - **Border color** replaces the fill's border colour, for example a grey ring
672
+ around an icon-only outline button. An **Icon only** button is as large as
673
+ its **Size** option (small, medium or large, from the brand's button heights).
674
+
675
+ **Download tile**: **Card color scheme** (as the Section, light, muted or
676
+ dark), **Card background**, **Card border** (on by default), **Rounded
677
+ corners**, **Card padding** (a step of the spacing scale), **Title size** (a
678
+ step of the type scale or **Custom (px)**, per breakpoint) and **Show the file
679
+ type** (on by default). **Image on hover** is the default **Faint tint** or
680
+ **Full image with a dark gradient**, the text turning white over it. **Link
681
+ look** is the default **Text label** or a 48 px **Round icon button** at the
682
+ bottom end, ringed in the text colour; its label is still read by screen
683
+ readers. With the round icon button, **Icon button size** is **Small** (48 px,
684
+ as before), **Medium** (72 px) or **Large** (112 px), and **Icon button style**
685
+ is **Outline** (the ring, as before) or **Filled**: a disc in the text colour
686
+ with the icon in the card's background colour. The whole tile stays one download link, and tiles in a carousel row
687
+ keep equal heights.
688
+
689
+ **Carousel image**: a **Read-more label** (for example "Read more") shown over
690
+ the image in a corner of its own — **Read-more label placement**, bottom right
691
+ by default — apart from the caption, with an optional **Read-more label
692
+ icon**. It is 14 px semibold, 12 px from its corner, takes the caption's text
693
+ colour when one is set and is part of the item's link.
694
+
695
+ **Image** caption: **Caption placement** is chosen per breakpoint (for example
696
+ below the image on phones and beside it from the tablet up), and the caption
697
+ takes a **Caption size** (a step of the type scale or **Custom (px)**) and a
698
+ **Caption alignment** per breakpoint; it keeps the scheme's muted text colour.
699
+
700
+ ### Buttons in blocks, hero texts, download tiles and image captions: more options
701
+
702
+ Every option below is unset by default, and a page saved before them looks as
703
+ it did.
704
+
705
+ **Buttons inside blocks** — a Hero's buttons, a card's or a panel's, a
706
+ section or listing header's button, the buttons of Media and text — take the
707
+ look options the **Button** block has: **Transparent outline fill** and
708
+ **Border color**. An icon-only button can also be a **Pill** instead of a
709
+ **Circle** (**Icon-only button shape**), 1.15 times as wide as it is tall — for
710
+ example a "scroll down" control slightly wider than tall. The Button block
711
+ offers the pill too; its other look options stay where they were.
712
+
713
+ **Hero**:
714
+
715
+ - **Title line height** per breakpoint, with a Custom title size. The hero's
716
+ **Text color** colours all its texts; **Eyebrow color** gives the eyebrow an
717
+ accent of its own.
718
+ - The eyebrow can serve as a label above the body: **Eyebrow size** (a step of
719
+ the type scale or **Custom (px)**, per breakpoint, with an **Eyebrow line
720
+ height** for a Custom size) and **Eyebrow in capitals** (on by default)
721
+ switched off for a label in its own case. Put it where it belongs and set the
722
+ space after it in **Elements: order and spacing**, as for any element.
723
+ - The **Social proof** caption: **Social proof caption placement** beside the
724
+ image (default) or below it, per breakpoint — for example below on phones and
725
+ beside from the tablet up —, and a **Custom social proof caption max width
726
+ (px)** per breakpoint. It keeps the small, muted text.
727
+
728
+ **Download tile**:
729
+
730
+ - **Links to** a file (default) or **A page or URL**: the tile then takes a
731
+ **Link** (a page, a product, a category, a file or a URL) instead of a file,
732
+ has no file-type badge, and its round icon button points onwards. A tile
733
+ whose link leads nowhere is not shown to customers; the editor shows a
734
+ warning in its place.
735
+ - **Custom minimum height (px)**, one value for every breakpoint (180 px by
736
+ default).
737
+ - A Custom title size now applies from the tablet up as well (it was read on
738
+ phones only).
739
+
740
+ **Carousel image**: a caption on the same edge as the read-more label — both
741
+ at the bottom, or both at the top — now sits above the label's line instead of
742
+ sharing it, so the two never overlap on a narrow card.
743
+
744
+ **Image** caption: **Custom caption max width (px)**, per breakpoint. A
745
+ caption placed below the image on phones and
746
+ beside it from a wider breakpoint now gets a column of its own there, beside an
747
+ image of a set width, instead of being squeezed into the image's width.
748
+
749
+ An inline heading left empty — a Heading block, a Media and text heading, a
750
+ Hero's title — writes no empty heading element on the page; a Heading block
751
+ keeps its spacing.
752
+
753
+ ### Tabs: a panel in columns
754
+
755
+ A tab's panel holds blocks, so a panel laid out in columns is a **Row** placed in
756
+ it; no dedicated layout is needed. For example, a panel with a short text on the
757
+ left, an image in the middle and a text with a button on the right:
758
+
759
+ 1. Select the Tabs block and open the tab in the sidebar; drop a **Row** into its
760
+ **Panel** and pick **3 columns**.
761
+ 2. Set each **Column**'s width on the Responsive tab, for example 3, 5 and 4 of
762
+ 12 on desktop and 12 each on a phone, where the columns then stack.
763
+ 3. Fill the columns: a Heading and an Image with a caption (the social-proof
764
+ line) in the first, an Image in the second, a Rich Content text and a Button
765
+ in the third.
766
+
767
+ A panel accepts any block except a Column on its own (columns live in a Row),
768
+ another Tabs or Accordion block, and a Section. Every panel, with its columns,
769
+ is in the server-rendered HTML. The **Space below the tab bar** sets the gap
770
+ between the bar and the panel.
771
+
772
+ On a phone, many tabs wrap onto two or more lines. Set **Tabs that do not fit**
773
+ to **Scroll in one line** to keep a single line that the visitor swipes
774
+ sideways instead; the bar snaps to a tab, a tab reached with the arrow keys or
775
+ chosen with a tap scrolls into view, and nothing wider than the screen pushes
776
+ the page sideways.
777
+
778
+ The **Tab size** is set per breakpoint on the Responsive tab: for example small
779
+ pills on a phone and medium ones from a tablet up. With one size for every
780
+ breakpoint the tabs look as they did with the size in the tab bar's look.
781
+
782
+ **Tab background on hover** and **Tab text on hover** (in the tab bar's look,
783
+ a brand colour or a hex) colour a tab that is not selected while the pointer is
784
+ over it, with a short colour transition; on a touch screen nothing sticks after
785
+ a tap. Left unset, the tabs do not change on hover, as before.
786
+
787
+ The **Panel change** is **Instant** by default. **Fade** crossfades: the
788
+ panel going out fades away over the one coming in, and the block's height
789
+ follows smoothly from one panel to the other. **Slide** adds a short sideways
790
+ shift in the direction of travel (a tab further on comes in from the end side).
791
+ Every panel stays in the server-rendered HTML; while the outgoing panel is
792
+ still fading it cannot be focused or read by a screen reader, and the arrow
793
+ keys, Home and End work as with an instant change. Visitors who ask their
794
+ system for reduced motion get the instant change.
795
+
796
+ ### Columns: distribution and order
797
+
798
+ A column that is taller than its blocks (the Row stretches its columns to the
799
+ tallest one, which is its default vertical alignment) can spread them with
800
+ **Distribute blocks vertically**:
801
+
802
+ | Option | Effect |
803
+ | --- | --- |
804
+ | From the top | Today's stack, the default. |
805
+ | Center | The blocks sit together in the middle of the column. |
806
+ | To the bottom | The blocks sit together at the bottom. |
807
+ | Space between | The first block at the top, the last at the bottom, the others spread evenly. |
808
+ | Last block to the bottom | The blocks stack from the top and the last one goes to the bottom, for example a social-proof line under a text. |
809
+
810
+ A block inside a column can also take another place on a given screen size,
811
+ without a second copy hidden with **Hide on**: select the block and, on the
812
+ Responsive tab, set **Order in the column** for that breakpoint — **First**,
813
+ **Last**, or **Position 1** to **Position 6** (blocks left **As placed** come
814
+ before numbered ones). A breakpoint with no value of its own takes the one
815
+ below it. For example, a social-proof image first in its column on desktop and
816
+ last on a phone: **Last** on the base breakpoint, **First** on desktop.
817
+
818
+ The order changes what the visitor **sees**, not the page's structure: a screen
819
+ reader still reads the blocks, and the Tab key still moves through them, in
820
+ the order they are placed in the editor. Reorder only where both orders make
821
+ sense. The editor canvas also keeps the placed order, so dragging blocks works
822
+ on what the outline shows; the published page shows the order per breakpoint.
823
+ In a column where a distribution
824
+ or an order is set, the blocks are laid out as a flex column, so the vertical
825
+ margins of two neighbouring blocks add up instead of overlapping.
826
+
827
+ A whole column can move the same way inside its Row: select the **Column** and,
828
+ on the Responsive tab, set **Order in the row** for a breakpoint, with the same
829
+ choices. For example, in a Row of two columns that stack on a phone, the second
830
+ column first on a phone and in its place on desktop: **First** on the base
831
+ breakpoint, **As placed** on desktop. As with blocks, only what the visitor
832
+ sees moves — a screen reader and the Tab key follow the columns in the order
833
+ they are placed — and the editor canvas keeps the placed order.
834
+
835
+ ### Columns: placement in the row's grid
836
+
837
+ A Row lays its columns out on a grid of twelve tracks; **Width** says how many
838
+ tracks a column takes. On the Responsive tab, a **Column** can also be placed on
839
+ that grid per breakpoint:
840
+
841
+ | Option | Values | Effect |
842
+ | --- | --- | --- |
843
+ | **Height in rows** | 1 row (default) to 4 rows | The column spans that many rows of the Row, so the columns next to it can stack beside it. |
844
+ | **Start at column** | Next free place (default), 1 to 12 | The track the column starts at. A start that would push the column past the twelfth track at that breakpoint's width is moved left so the column fits. |
845
+ | **Start at row** | Next free place (default), 1 to 4 | The row the column starts at. |
846
+
847
+ A breakpoint with no value of its own takes the one below it. As soon as one
848
+ column of a Row is placed, that Row fills the free places of its grid in order
849
+ (dense packing), so a column given only a start column takes the first free row
850
+ of that track. A column left at one row and the next free place on every
851
+ breakpoint renders exactly as before.
852
+
853
+ For example, a side column with a short item at its bottom next to two tall
854
+ columns, which stack one under another on a phone. Add four columns, each
855
+ **Width** 12 on the base breakpoint and 4 on desktop, in the order they should
856
+ be read: **A** (the top of the side column), **B**, **C** and **D** (the item
857
+ under A). Then, on desktop only, set **Height in rows** to 2 rows on B and C, and
858
+ **Start at column** 1 (optionally **Start at row** 2) on D. On desktop, A and D
859
+ share the first track and B and C span both rows; on a phone, A, B, C and D
860
+ stack in that order. D exists once: no second copy is hidden per breakpoint.
861
+
862
+ As with the order, the placement changes what the visitor **sees**, not the
863
+ page's structure: a screen reader and the Tab key follow the columns in the
864
+ order they are placed in the editor, so place them in an order that also reads
865
+ well. The editor canvas keeps the placed order and the widths, without the
866
+ placement, so dragging columns works on what the outline shows; the published
867
+ page shows the placement per breakpoint.
868
+
869
+ ### Columns: a background wider than the column
870
+
871
+ A Column's **Background outset (px)**, on the **Responsive** tab, makes its box
872
+ — its background, border and shadow — reach that many pixels past the column
873
+ on each side, while the column's content stays where it was: a grey box a
874
+ little wider than the text column beside it. Set it per breakpoint, for example
875
+ **0** on phones, where the column already spans the screen, and **24** from the
876
+ desktop up. Left at 0 (the default) the box is as wide as the column. The
877
+ outset reaches into the gap between the columns and past the Row's edge, so
878
+ keep it within the space around the column. The column box's own **Outer
879
+ spacing** at the sides still applies on top of the outset, at every
880
+ breakpoint — a breakpoint whose outset is 0 shows the box with its own margins.
881
+
882
+ ### Mobile images: phones only, or phones and tablets
883
+
884
+ An image with a **Mobile image** — the **Image** block, a Hero, a Media and
885
+ text block, any block whose image field offers one — shows the mobile image on
886
+ phones and the main image from the tablet width up (768 px). **Mobile image
887
+ shown on** (offered once a mobile image is set) moves that switch to the
888
+ desktop width: **Phones and tablets (below 1024 px)** keeps the mobile art on
889
+ tablets too, for a tall image that suits a tablet better than the wide desktop
890
+ one. A Section's or Section group's background has the same setting, **Mobile
891
+ image or video shown on**, for its mobile image or mobile video. Left at
892
+ **Phones (below 768 px)** nothing is stored and the image switches as before.
893
+
894
+ ### Split slides, carousel controls and block spacing
895
+
896
+ Every option below is empty or off by default, and a page saved before them
897
+ looks as it did. Options marked *per breakpoint* are set on the **Responsive**
898
+ tab; a breakpoint without its own value takes the one below it, and a
899
+ breakpoint no value reaches keeps the block's own look.
900
+
901
+ **Carousel split slide**:
902
+
903
+ - **Side by side from** the tablet (768 px, default) or the desktop (1024 px);
904
+ below it the media and the text stack, media first.
905
+ - **Layout (media – text)** on 12 columns from the side-by-side width up (see
906
+ *Layouts on 12 columns*); **Default** keeps two equal halves.
907
+ - **Rounded corners** of the media (8 px by default; **None** for square).
908
+ - **Title size** and **Text size**, *per breakpoint*, each with a line height
909
+ for a Custom size, and a **Title weight** and a **Text weight**.
910
+ - **Hanging indent after a leading icon**: a title that starts with an icon
911
+ (a check mark, for example) hangs beside it, so a wrapped line starts under
912
+ the text.
913
+
914
+ **Carousel controls** (the Carousel, the product slider and the latest posts
915
+ carousel):
916
+
917
+ - **Controls alignment** also offers **Dots at the start, arrows at the end**.
918
+ Chosen, the alignment applies to the controls inside a split slide too (left
919
+ unset, those start at the text's left edge).
920
+ - **Keep the arrows when all slides fit** (under **Controls**): when every
921
+ slide is already on screen the arrows stay, both disabled, and the dots are
922
+ hidden; off, the controls disappear as before. Kept arrows are not dimmed:
923
+ they rest on the colour scheme's background with its border and muted text
924
+ colour, so they stay readable on a light, muted or dark Section and over a
925
+ slide. A chosen **Disabled arrow look** — **Light outline** or **Color** — is
926
+ used instead, and is offered for this case on a looping carousel too.
927
+
928
+ **Media and text**: **Text size** for every row's text, *per breakpoint*, with
929
+ a **Text line height** for a Custom size; **Space between the heading and the
930
+ paragraphs** and **Space between media and text when stacked**, each a step of
931
+ the spacing scale. Each of **More rows** has its own **Vertical alignment**;
932
+ **Same as the block** (or empty) follows the block's.
933
+
934
+ **Background image panel**: **Layout on mobile** — **Image and text stacked**
935
+ (default) or **Text over the image**, which keeps the mobile image at its own
936
+ height (a tall mobile image keeps its shape) with the text over its top or
937
+ bottom, by **Text on mobile**.
938
+
939
+ **Feature list**: **Space between rows (px)**, *per breakpoint*, apart from the
940
+ gap, which then spaces the columns only; **Line height of lists in the text**,
941
+ *per breakpoint*, with a Custom text size.
942
+
943
+ **Call-to-action card**: **Card padding**, a step of the spacing scale (an
944
+ image inset is measured from it), and with an image a **Layout (image – text)**
945
+ from the tablet up (half the card by default; see *Layouts on 12 columns*).
946
+
947
+ **Stats**: **Label line height**, *per breakpoint*, with a Custom label size.
948
+
949
+ **Link list**: **Divider after the last row**, offered while **Divider between
950
+ rows** is on.
951
+
952
+ ### Stacking breakpoints, column layouts and more text options
953
+
954
+ As above, every option below is empty by default, a page saved before them
955
+ looks as it did, and options marked *per breakpoint* are set on the
956
+ **Responsive** tab.
957
+
958
+ **Hero**: a social-proof caption placed **Below the image** always starts a
959
+ line of its own, also with a **Custom social proof caption max width (px)**
960
+ narrow enough to fit beside the image.
961
+
962
+ **Media and text**:
963
+
964
+ - With **Advanced layout (columns of 12)**, **Media width** and **Text width**
965
+ in columns of 12 and the **Columns between the media and the text**, from the
966
+ side-by-side width up — as on the carousel split slide. Any one set lays every
967
+ row on a 12-column grid (the media 6 columns and none between unless set, the
968
+ text the rest), mirrored on a row with the media on the right, in place of
969
+ the **Split (media – text)**; for example 5 and 5 columns one column apart.
970
+ - **Heading line height** (with a Custom heading size, *per breakpoint*), a
971
+ **Text weight**, and the **List marker color** of the check and chevron lists
972
+ in every row's text.
973
+
974
+ **Call-to-action card** (with an image):
975
+
976
+ - **Image position when stacked**: **Above the text** (default) or **Below the
977
+ text**; an image inset then runs along the sides and the bottom.
978
+ - **Side by side from** the tablet (768 px, default) or the desktop (1024 px);
979
+ below it the card stacks as on a phone.
980
+ - **Custom image inset (px)** is one value for every breakpoint.
981
+ - **Text size**, *per breakpoint*, with a Custom (px) size; the list follows
982
+ it.
983
+
984
+ **Stats** (with an image): **Side by side from** the tablet (default) or the
985
+ desktop; below it the image sits above the figures.
986
+
987
+ **Carousel split slide**:
988
+
989
+ - **Text indent**, offered with the hanging indent on: **Aligned with the title
990
+ text** starts the text below where the title's text starts, after the
991
+ leading icon and its space. Only a title that starts with an icon is
992
+ indented.
993
+ - **Space between media and text when stacked**, and **Space between the
994
+ title, the text and the controls** (the controls a carousel places inside its
995
+ slides), each a step of the spacing scale.
996
+
997
+ **Image**: with a mobile image, **Mobile image shown on** phones only (below
998
+ 768 px, default) or phones and tablets (below 1024 px), as for image fields.
999
+
1000
+ **Heading**: **Max text width**, *per breakpoint* — a named measure or a
1001
+ Custom (px) width; a centred or right-aligned heading keeps its alignment.
1002
+
1003
+ **Rich Content**: **List line height**, *per breakpoint*, with a Custom text
1004
+ size.
1005
+
1006
+ **Accordion**: **Title line height**, *per breakpoint*, with a Custom title
1007
+ size.
1008
+
1009
+ **Product grid** and **Product slider**: the header's **Lead size** (a type
1010
+ token or Custom px, *per breakpoint*), **Lead weight** and **Lead color**.
1011
+
1012
+ **Download tile**: **Title weight**.
1013
+
1014
+ ### Type sizes per breakpoint
1015
+
1016
+ A text whose size is a different type token per breakpoint — for example a
1017
+ carousel heading at Heading 3 on phones and Heading 2 on the desktop, a hero
1018
+ title, a section heading or a Heading block — now takes each breakpoint's line
1019
+ height, weight and letter spacing from that breakpoint's token as well (until
1020
+ 2026-10-28 they stayed the first breakpoint's). A weight the block sets itself
1021
+ still wins; a line height applies at a Custom (px) breakpoint only.
1022
+
1023
+ ### Column gaps, column anchors, row alignment and more options
1024
+
1025
+ As above, every option below is empty by default, a page saved before them
1026
+ looks as it did, and options marked *per breakpoint* are set on the
1027
+ **Responsive** tab.
1028
+
1029
+ **Columns of 12** — on **Media and text**, the **Carousel split slide** and
1030
+ **Stats** (with an image), once a layout on 12 columns is chosen:
1031
+
1032
+ - **Space between columns (px)**, *per breakpoint*. Left empty, the gap is the
1033
+ page's side gutter, as before; set it (for example 16 px) to keep the
1034
+ columns where you place them whatever the gutter.
1035
+ - **Columns aligned to** (**Media and text** and the split slide, with
1036
+ **Advanced layout (columns of 12)**): **The media side** (default) keeps a
1037
+ row with the media on the right ending at column 12 — for example text in
1038
+ columns 2–6 and media in 8–12. **Start (column 1)** starts the pair at column
1039
+ 1 on either side — text 1–5 and media 7–11 — and **End (column 12)** ends it
1040
+ at column 12.
1041
+
1042
+ **Row**: **Align columns** (top, middle, bottom) now places the columns on a
1043
+ published page as it does in the editor; until 2026-10-28 each column stretched
1044
+ to the row's height whatever was chosen. A row left on **Stretch** (the
1045
+ default) looks as before. A row saved with `center` — the word **Media and
1046
+ text** uses for the same choice — is read as middle.
1047
+
1048
+ **Call-to-action card**:
1049
+
1050
+ - **Side by side from: Desktop (1024 px)** now keeps a two-column list in one
1051
+ column on a tablet as well, while the card is stacked; a card side by side
1052
+ from the tablet keeps its two columns from 768 px.
1053
+ - **Space below the heading**, a step of the spacing scale (16 px by default).
1054
+ - **Text weight**, and **Max text width** (a named measure or Custom px, *per
1055
+ breakpoint*), for the card's text.
1056
+
1057
+ **Stats**: **Value line height**, *per breakpoint*, with a Custom value size. A
1058
+ breakpoint below the first Custom one keeps the value size's own line height.
1059
+
1060
+ **Media and text**: **Item text size** (a type token or Custom px, *per
1061
+ breakpoint*) and **Item text weight** for every feature item's text (15 px and
1062
+ muted by default).
1063
+
1064
+ **Rich Content**: **Text weight**; its lists follow it.
1065
+
1066
+ **Feature list**:
1067
+
1068
+ - **Icon position** is set *per breakpoint* — for example beside the title on a
1069
+ tablet and above it from 1024 px. One position saved before applies to every
1070
+ breakpoint.
1071
+ - An item's **Width on desktops (columns of 12)**: from 1024 px the list is
1072
+ laid out on 12 columns, that item spans its width and the others keep their
1073
+ share of the **Columns** (for example 6 of 12 with two columns).
1074
+ - **Title weight** was already set per breakpoint.
1075
+
1076
+ **Carousel**, **Product slider**, **Product grid** and **Latest posts**: the
1077
+ header's **Heading line height**, *per breakpoint*, with a Custom heading size;
1078
+ a breakpoint below the first Custom one keeps the heading size's own. **Latest
1079
+ posts** also takes a **Lead weight**.
1080
+
1081
+ **Link list**: **Row title line height**, *per breakpoint*, with a Custom row
1082
+ title size.
1083
+
1084
+ **Newsletter sign-up**: a **Button icon** from the icon catalog after the
1085
+ button's label (none by default).
1086
+
1087
+ **Testimonial**: **Quote size** — a type token or Custom px, *per breakpoint*
1088
+ (1.15 rem by default).
1089
+
1090
+ **Download tile** (with the round icon button): **Icon button icon**, a glyph
1091
+ from the icon catalog — for example the cloud download added to the catalog;
1092
+ left empty, a file's tile shows the download arrow and a link's tile the arrow
1093
+ pointing on.
1094
+
1095
+ ### Box margins and padding per breakpoint
1096
+
1097
+ **Outer spacing** (margin) and **Inner spacing** (padding) of every block that
1098
+ has them are set per breakpoint on the **Responsive** tab: choose Base
1099
+ (mobile), Tablet or Desktop in its **Scope settings** and enter the values for
1100
+ that breakpoint, for example 16 px below a heading on phones and 32 px on the
1101
+ desktop. A breakpoint without its own value takes the one below it.
1102
+
1103
+ ### Full-width buttons and a chevron "read more"
1104
+
1105
+ - **Full-width buttons.** A **Button** block has a **Width** on the **Responsive** tab: **Fit the
1106
+ label** (the default) or **Full width**, which stretches the button across its box. Set it per
1107
+ breakpoint, for example full width on phones and fitted from the tablet up. The blocks with a
1108
+ list of buttons — **Hero**, **Media and text**, **Call-to-action card**, **Background image
1109
+ panel** and the **Carousel split slide** — have a **Button width** for the whole list:
1110
+ at **Full width** the buttons stack, each across the box. Left unset, the buttons look as before.
1111
+ - **"Read more" as a chevron.** In rich text, put the cursor in a "read more" passage and press
1112
+ **Read more as a chevron** (⌄) in the toolbar. The passage then opens with a bare chevron
1113
+ instead of its summary line, and the chevron turns when it opens. The summary text stays the
1114
+ control's name for screen readers, so keep it meaningful ("Show the details"). In the editor
1115
+ the summary stays visible and editable. Press the button again to go back to the text summary.
1116
+
1117
+ ### "Read more" placement, accordion look and highlight colours
1118
+
1119
+ - **Where the "read more" sits.** With the cursor in a "read more" passage, **Read more
1120
+ position** in the rich-text toolbar puts its summary — the text or the chevron — at the
1121
+ **Start** of the line (the default), in the **Center** or at the **End**. **Show the revealed
1122
+ text above the summary** (⤒) makes the passage open upwards: while it is open, its text shows
1123
+ above the summary, which stays the one control under it. Only the order on screen changes:
1124
+ keyboard users and screen readers still meet the summary first, as before. A browser that
1125
+ cannot reorder a "read more" passage shows the text below the summary. In the editor the text
1126
+ stays below the summary, to edit, and an arrow before the summary marks the passage.
1127
+ - **Accordion look.** An **Accordion** block has an **Icon** — **Plus and minus** (the default)
1128
+ or a **Chevron** that turns when its item opens, placed at the end of the title's line —,
1129
+ **Items** — **Plain**, **Boxed** (each item in a bordered box, its title and panel inset
1130
+ from the edge; left unset, the **Style** decides as before: *Bordered* is boxed) or
1131
+ **Filled** (each title on a softly tinted bar taken from the colour scheme — a faint dark
1132
+ tint on the light schemes, a faint light one on the dark scheme — with its panel inset
1133
+ below it, items 8 px apart and no dividers) —,
1134
+ **Dividers** for plain items — **None**, **Between items**, or **Above, between and below**
1135
+ (left unset, the **Style** draws its usual line under each item) — and a **Title padding**
1136
+ above and below each title on the **Responsive** tab: a spacing size or a **Custom** px value
1137
+ per breakpoint (12 px when not set). Every panel is still in the page's HTML, closed panels
1138
+ hidden until opened.
1139
+ - **Accordion title colour, divider and icon size.** **Title color** (a brand colour or a hex
1140
+ value) colours every item's title and its icon; left empty, they keep the text's colour.
1141
+ **Divider position** draws the line of an item that has one **Under the item** (the
1142
+ default) or **Under the title**, so an open item shows its line between the title and the
1143
+ panel; with **Between items** the last title has no line, and boxed items are not affected.
1144
+ **Icon size** is **Small (16 px)**, **Medium (20 px)**, **Large (24 px)** or a **Custom (px)**
1145
+ value; left unset, the icon follows the title's text size as before.
1146
+ - **Accordion spacing and title weight.** On the **Responsive** tab, **Space above the open
1147
+ panel** sets the space between an item's title (or its line, with the line under the title)
1148
+ and its open panel, and **Space between items** the space from one item to the next; each is
1149
+ a spacing size or a **Custom (px)** value per breakpoint. A breakpoint left unset keeps the
1150
+ usual spacing: no space above a panel (12 px under a title line), none between plain items,
1151
+ 8 px between boxed or filled ones. **Space below the open panel** sets the space under an open
1152
+ panel's content (12 px when unset), and **Space after an open item** the space from an open
1153
+ item to the next title, used instead of **Space between items** while the item is open (a
1154
+ breakpoint left unset uses the space between items); both are a spacing size or a
1155
+ **Custom (px)** value per breakpoint and open and close with the panel. **Title weight** sets
1156
+ how bold every title is — **Default** (the usual semibold) or a weight from **Light (300)** to
1157
+ **Extra bold (800)** — once for every width or, on the **Responsive** tab, per breakpoint; a
1158
+ breakpoint below the first one with a weight keeps the usual weight.
1159
+ - **Opening and closing animate.** A "read more" passage and an accordion item open and close
1160
+ with a short animation of their height. Visitors who ask their system for reduced motion see
1161
+ them open at once, and so do browsers that cannot animate to a content's own height. An
1162
+ accordion item open when the page loads does not animate in.
1163
+ - **Highlight colours.** In a heading, a block's title or a caption, select a phrase and choose
1164
+ **Highlight colour** in the text's toolbar. Pick one of the **Brand colours** — the phrase
1165
+ then follows the brand screen's colour — or type or pick a **Custom colour (hex)**, and
1166
+ **Apply**. The phrase keeps its highlight style (accent, muted or gradient; accent when it had
1167
+ none) and reads in that colour; a gradient phrase becomes solid text in it. **Remove colour**
1168
+ takes the colour off and keeps the highlight. Choose a colour that keeps the text readable on
1169
+ its background. A translated heading keeps the highlight and its colour on the translated
1170
+ words.
1171
+
1172
+ ### The settings panel
1173
+
1174
+ Every block's settings follow the same conventions, so a setting reads and
1175
+ behaves alike wherever it appears:
1176
+
1177
+ - **Order.** The content first, then the layout, the look, spacing and borders,
1178
+ and **Hide on**. A text's **weight** sits next to its **size**, both on the
1179
+ **Responsive** tab, and is set per breakpoint like the size (a weight saved as
1180
+ one value keeps applying at every width).
1181
+ - **Only what applies is shown.** For example the autoplay interval only with
1182
+ **Autoplay** on, the arrows' look only while **Show arrows** is on, the
1183
+ controls' placement only while arrows or dots show, the look of a disabled
1184
+ arrow only for a carousel that does not loop, a carousel image's caption look
1185
+ only once it has a caption, the image side only with an image, a row's
1186
+ **Vertical position** only with a **Minimum height**, the **Divider position**
1187
+ only where the accordion's items have lines, and **Muted** only for a video
1188
+ that does not play automatically (an autoplaying video file is always muted).
1189
+ - **One switch for every on/off setting**, in place of Yes/No choices; it stores
1190
+ the same values, so saved pages are unchanged.
1191
+ - **Alignment is per breakpoint** in the icons, social links, logo strip,
1192
+ feature list, stats, statement, hero and tabs, and reads **Left / Center /
1193
+ Right** everywhere (a side reads **Left / Right**). A value saved before
1194
+ applies at every width.
1195
+ - **Gaps** are a spacing step or **Custom gap (px)**, per breakpoint, in the
1196
+ social links, logo strip, product grid and category grid too; a gap saved as a
1197
+ number of pixels opens as Custom with that number and renders as before.
1198
+ - **Custom values in pixels** read "Custom … (px)", and every custom maximum
1199
+ width takes 160–2000 px.
1200
+ - **Rounded corners** is the name of every corner setting; a block with two of
1201
+ them names each (**Image – rounded corners**, **Caption – rounded corners**).
1202
+ - **Images and videos** offer the **Asset library** first, and a new image starts
1203
+ on it. An image saved with no source and a URL keeps its URL.
1204
+ - **Links** in the image, icon, logo strip, announcement bar and map markers
1205
+ are the same link as a button's: a page, product, category, file, a section
1206
+ of this page or a URL, with **Open in new tab** (shown once the link leads
1207
+ somewhere). A URL saved before reads as a URL link with the same target and
1208
+ renders as before; the editor moves it into the new link when the block is
1209
+ opened. Every URL, here and in the social links, must start with `https://`,
1210
+ `http://`, `mailto:`, `tel:` or `/`, as in every other link: any other address
1211
+ (for example `javascript:`) renders the image, icon, logo or text without a
1212
+ link, and a social link without its address.
1213
+ - **Item open at first** (accordion) and **Tab shown at first** (tabs) are
1214
+ chosen from the items' titles instead of typing a number.
1215
+ - **New blocks follow the section's colours**: a new text and new icons or
1216
+ social links take the section's text colour, and a new announcement bar the
1217
+ brand's primary colour. Blocks already on a page keep theirs. The icons' and
1218
+ social links' **Color** then reads **Inherited (text color)**; picking a
1219
+ colour sets one, and **Inherit** returns to the text colour.
1220
+ - **The settings are translated** in the admin's language, including the
1221
+ settings every block shares (name, **Hide on**, spacing, border, background,
1222
+ corners, shadow, typography), which are translated once for all blocks.
1223
+
1224
+ ### Motion
1225
+
1226
+ Motion is opt-in and restrained:
1227
+
1228
+ - **Entrance reveal** of a Section (none or fade-up), and a block-level
1229
+ reveal on the hero and the statement (none, fade-up, or words appearing one
1230
+ by one); each can be limited to desktop.
1231
+ - **Hover zoom** on carousel images, carousel split slides and link tiles.
1232
+ - Carousel autoplay is off unless switched on, pauses on hover and focus, and
1233
+ has a pause button.
1234
+
1235
+ Nothing moves for a visitor who prefers reduced motion, and every text is in
1236
+ the server-rendered HTML and visible before any script runs: the hidden
1237
+ starting state is applied by a script only after the page has loaded, and
1238
+ content already on screen is left as it is. The one exception the page cannot
1239
+ control is an animated SVG chosen as the dark scheme's decorative backdrop: it
1240
+ stops under reduced motion only if the SVG itself says so (see
1241
+ [The decorative backdrop](./brand.md#the-decorative-backdrop)).
75
1242
 
76
1243
  ### Preview viewports
77
1244
 
@@ -202,8 +1369,8 @@ page render.
202
1369
  | GET | `/pages` | Paginated Page list with filters. |
203
1370
  | POST | `/pages` | Create a Page (always starts as `draft`). |
204
1371
  | GET | `/pages/:id` | Detail with full content envelope + version. |
205
- | PATCH | `/pages/:id` | Edit metadata; honours `If-Match` via `version`.|
206
- | PUT | `/pages/:id/content/:language` | Save the Page Builder tree per language. |
1372
+ | PATCH | `/pages/:id` | Edit metadata, including `parentPageId`, `parentPathInUrl`, `breadcrumbsVisible`, `breadcrumbsScheme`, `breadcrumbsOverlay`, `shareImageAssetId` and `translations` (the per-language name, slug and description, replaced whole); honours `If-Match` via `version`. A cyclic or too-deep parent answers `422 CMS_PAGE_PARENT_CYCLE`; an address another page has answers `409 CMS_SLUG_CONFLICT`. |
1373
+ | PUT | `/pages/:id/content/:language` | Save the Page Builder tree per language. A duplicate or reserved anchor answers `422 CMS_DUPLICATE_ANCHOR` / `CMS_RESERVED_ANCHOR`. |
207
1374
  | POST | `/pages/:id/{publish,archive,unarchive}` | Lifecycle transitions. |
208
1375
  | DELETE | `/pages/:id` | Hard delete (channels are cascade-unbound). |
209
1376
  | Same | `/blocks/*` | Same shape; per-channel-unique `code`; reference-protected on delete. |
@@ -213,7 +1380,9 @@ page render.
213
1380
  | PATCH | `/hooks/:id` | Edit name / active / scope; `code` is immutable.|
214
1381
  | DELETE | `/hooks/:id` | Refused with 409 when `is_system=true`. |
215
1382
  | GET / POST / PATCH / DELETE | `/hooks/:id/attachments[/:blockId]` | Attach / reorder / detach Blocks on a Hook. |
216
- | GET | `/page-builder/config` | Merged Page Builder descriptor (metadata only). |
1383
+ | GET | `/page-builder/config?salesChannelId=` | Merged Page Builder descriptor (metadata only), with `brandTokens`: the effective brand set of the named channel, or the global set. |
1384
+ | GET | `/brand-tokens?salesChannelId=` | The global set, the named channel's override, the effective set and its contrast warnings. `cms.read`. See [Brand](./brand.md). |
1385
+ | PUT | `/brand-tokens` | Save the global set or one channel's override (`tokens: null` resets it). `cms.brand`. |
217
1386
  | GET | `/page-builder/translation` | Translation capability: `ready` (provider, model), `disabled`, `not_configured` or `unavailable`, plus the size limit. `cms.translate`. |
218
1387
  | POST | `/page-builder/translate` | Translate a canvas (optionally one component or a selected text) into a language; nothing is stored. `cms.translate`. |
219
1388
 
@@ -221,10 +1390,23 @@ page render.
221
1390
 
222
1391
  | Method | Path | Returns |
223
1392
  | ------ | --------------------------------- | -------------------------------------------------------------- |
224
- | GET | `/pages/by-slug?slug=…&language=…`| Resolved Page with `embeds.blocks`, `embeds.templates`, assets.|
1393
+ | GET | `/pages/by-slug?slug=…&language=…`| Resolved Page with `embeds.blocks`, `embeds.templates`, assets. `slug` takes the page's whole public path in any of its languages; a nested page's own slug also resolves.|
225
1394
  | GET | `/blocks/by-code?code=…&language=…`| Resolved Block (single, channel-filtered, active-only). |
226
1395
  | GET | `/hooks/by-code?code=…&language=…`| Ordered active Block list for the named Hook. |
227
1396
 
1397
+ The resolved Page also carries `path` (its public path in the channel and the
1398
+ served language), `url` (that path as the storefront links it, under the
1399
+ language's path prefix), `alternates` (`{language, url}` for
1400
+ every language it is served in), `name` in the served language,
1401
+ `breadcrumbs` (`visible`, `scheme`, `overlay: true` only when the trail lies
1402
+ over the first section, and the `trail` of ancestors, each
1403
+ `{name, slug, path}` with `slug` and `path` null for one not published in the
1404
+ channel), `share.imageUrl` and `languages`.
1405
+
1406
+ The brand tokens have their own public read,
1407
+ `GET /api/v1/storefront/cms/brand-tokens`: the effective set for the resolved
1408
+ channel, with `cache-control: public, max-age=60`.
1409
+
228
1410
  Channel resolution prefers the `X-Sales-Channel` header, then falls back
229
1411
  to the system-default channel. Language resolution prefers `?language=`,
230
1412
  then `Accept-Language`, then the channel's configured default.
@@ -269,12 +1451,21 @@ itself by posting the matching tags to the storefront's `/api/revalidate`:
269
1451
  | Block | `cms:block:<code>`, `cms:page`, `cms:hook` |
270
1452
  | Template | `cms:page` |
271
1453
  | Hook / attachment | `cms:hook:<code>` |
272
-
273
- A saved page is therefore the next request's page. Revalidation needs
274
- `STOREFRONT_BASE_URL` and `REVALIDATE_SECRET` on the backend and the same
275
- secret on the storefront; without them it is skipped and the 60-second window
276
- is the fallback. It is best-effort — a storefront that cannot be reached is
277
- logged and never fails the save.
1454
+ | Brand settings | `cms:brand` — posted straight after the save commits, not through the event |
1455
+
1456
+ The manual cache flush on the Settings module's cache screen revalidates the
1457
+ same tag through its `cms-brand` namespace.
1458
+
1459
+ A saved or published page is therefore the next request's page: the write
1460
+ dispatches the change in an EventBus scope and answers only once the storefront
1461
+ has dropped the tags, so even a request sent the moment the save returns gets
1462
+ the new content. Revalidation needs `STOREFRONT_BASE_URL` and
1463
+ `REVALIDATE_SECRET` on the backend and **the same** secret on the storefront;
1464
+ without them it is skipped and the 60-second window is the fallback (the first
1465
+ request after the window then still gets the previous render once, while the
1466
+ storefront refetches). It is best-effort: a storefront that cannot be reached,
1467
+ does not answer within 3 seconds, or refuses the call is logged and never fails
1468
+ the save. A refusal with status 401 means the two secrets differ.
278
1469
 
279
1470
  Another module that caches CMS content inside an answer of its own subscribes
280
1471
  to the same event through `ctx.subscribe`; `megamenu` does, for the blocks a
@@ -314,7 +1505,9 @@ declaration, the three renderer layers and the block stylesheet.
314
1505
  `CMS_PAGE_NOT_FOUND`, `CMS_BLOCK_NOT_FOUND`, `CMS_TEMPLATE_NOT_FOUND`,
315
1506
  `CMS_HOOK_NOT_FOUND`, `CMS_SLUG_CONFLICT`, `CMS_CODE_CONFLICT`,
316
1507
  `CMS_REFERENCED`, `CMS_HOOK_SYSTEM_PROTECTED`,
317
- `CMS_LANGUAGE_NOT_IN_CHANNEL_SCOPE`, `CMS_SCHEMA_UPGRADE_FAILED`, and for the
1508
+ `CMS_LANGUAGE_NOT_IN_CHANNEL_SCOPE`, `CMS_SCHEMA_UPGRADE_FAILED`,
1509
+ `CMS_DUPLICATE_ANCHOR` and `CMS_RESERVED_ANCHOR` (422, with `details.anchor`),
1510
+ `CMS_PAGE_PARENT_CYCLE` (422), and for the
318
1511
  translation `CMS_TRANSLATION_DISABLED`, `CMS_TRANSLATION_NOT_CONFIGURED`,
319
1512
  `CMS_TRANSLATION_UNAVAILABLE` (409), `CMS_TRANSLATION_TOO_LARGE` (413, with the
320
1513
  configured `limit`), `CMS_TRANSLATION_SELECTION_NOT_FOUND` (422) and