gutenberg-build-page

name	gutenberg-build-page
description	Build or edit a page in the live Gutenberg block editor with Novamira Visual tools. Use when creating or changing native block content (headings, paragraphs, lists, images, columns, groups) in the open block editor.
editor	gutenberg

Building Gutenberg pages in Novamira Visual

You are editing live inside the open Gutenberg editor. Changes apply directly in the editor and save with the page. There is no pending queue and no finalization step, and you never write post_content or block markup through execute-php or another backend tool.

Start in the editor

There is no backend tool for page content. Open the page in its editor first; to create a page, open a new page in the editor. The block tools below only exist once the editor is open.

Before changing anything, read get_page_structure to see the current block tree (clientIds, names, nesting). Discover what a block accepts with list_block_types and get_block_schema, and read a single block's values with get_block_attributes. Build from a block's real attributes, supports, and preset slugs, not from guesses.

Compose with native blocks

Use the most specific native block: core/heading (set level), core/paragraph, core/list + core/list-item, core/image, core/quote, core/buttons + core/button, core/table, core/code, core/separator. Express layout and nesting with core/group and core/columns + core/column and inner_blocks, not HTML.

If a registered third-party block fits what you are building (WooCommerce, Kadence, and similar), use it by name with its attributes instead of reproducing its output.

Use core/html only for a small fragment with no native equivalent, and keep it minimal. Never wrap whole sections, or the whole page, in core/html or inline styles. Raw HTML is not visually editable and defeats native editing.

Tools

• create_block: add a block. Pass inner_blocks for containers like core/columns. Returns the new clientId.
• update_block: change attributes on an existing block by clientId.
• replace_inner_blocks: rebuild a container's children in one call.
• move_block / delete_block: reorder or remove blocks.
• get_page_structure, get_block_schema, list_block_types, get_block_attributes, get_editor_settings: read state and schema.
• save persists the page; undo / redo step the editor history.

Text alignment

To align a block's TEXT (left, center, right), pass text_align to create_block or update_block. The tool stores it where this block keeps text alignment. Do not use the align attribute for text: align is block WIDTH (wide/full), and setting it to left/center/right does not move the text.

Colors, sizes, spacing

Prefer the theme's preset slugs from get_block_schema / get_editor_settings (for example a textColor slug, a named font size) over hardcoded hex values and pixel sizes, so the page stays consistent with the theme and editable.

Verify

After building, re-read get_page_structure to confirm the block tree matches the intent, then save.