Pages and canvas editor
The canvas is the visual editor for pages (and similar surfaces). Routes vary by deployment; common patterns are Create → Editor (/dxp/create/editor) and page edit flows from Pages (/dxp/pages, /dxp/pages/edit).
Blocks and the palette
- Add blocks from the palette or context actions. Block types (
heading,paragraph,list,section,card,data_mapped, …) drive how data is stored and rendered. - Reorder with drag handles or dedicated reorder controls where the shell exposes them.
- Nested blocks — Sections and layout groups can contain children according to the schema for that Space.
Block library
Blocks saved from Block builder live in the site library; operators may also ship platform presets. The Create → Library desk lists these under Blocks alongside uploaded media; collections and tags apply per active Space when your release supports them.
Insert saved blocks into the page canvas in two ways:
- Ctrl+/ / Cmd+/ — opens a search palette on the canvas. The entry is inserted relative to your current selection (inside a selected container, or after a selected block).
- Library tab (right aside) — lists entries; click to insert with the same selection rules.
POST /dxp/api/paste-block-from-library performs the server-side paste (fresh block IDs, schema checks). You still save staged edits and publish when ready, like any other canvas change.
Deep-link: append ?libScope=site&libId=<entry-id> to the editor URL for a one-shot insert on load.
Page metadata
Title, slug, layout, and related fields are often edited in the inspector or meta panels. Saving meta may use /dxp/api/save-page-meta under the hood—wait for success feedback before navigating away.
Product pages and live commerce
Pages with type: product (or blocks bound to a catalog product slug) show live price and stock from the catalogue at render time — not from static text you typed in a paragraph.
- Create the page from Products (Create page on the product editor) or match the page slug to the product slug.
- Price, sale label, and strikethrough regular price update when you save the product; you normally do not re-type prices in the canvas.
- Default block layout for new product pages comes from Spaces → Settings → Appearance → Product page layout.
If the live price looks stale while the product editor preview is correct, see Troubleshooting.
Merchandising experiments (A/B)
Wrap eligible containers in an experiment slice to run server-side split tests with no third-party scripts. See Merchandising experiments (A/B).
Publish vs draft
- Save keeps work in the authoring pipeline (draft or working copy depending on product state).
- Publish (or equivalent) marks the version intended for live visitors and triggers the publishing pipeline your operator configured (engine nudge, edge invalidation, etc.).
If visitors still see old HTML, see Troubleshooting — cache and propagation are environment-specific.
History, checkpoints, and restore
Where enabled, the editor exposes:
- History — prior versions for comparison (
/dxp/api/page-historyand related). - Checkpoints — explicit snapshots you name (
/dxp/api/record-page-checkpoint). - Restore — rolling back to a stored revision (
/dxp/api/restore-page-revision).
Ghost overlays and stream endpoints (/dxp/api/page-revision-ghost, /dxp/api/page-revision-stream) support diff UI; behaviour is subject to role gates.
Media uploads
Images and files typically upload via /dxp/api/media or library-specific endpoints. Prefer Library entries when the same asset will be reused across pages (Library).