Skip to content
Navigation

Primary

Settings on three levels

The upper levels set the name and the theme. The Payments section adds a block under the menu and removes the page outline. One page brings the outline back with its own note and turns on the footer.

How it works

  1. Upper levels. The site’s docara.json sets the theme, and the shared section.json of the demo section sets the name “Acme Pay” and the header sections. That is why the Payments section and page files do not have them.
  2. Section. section.json puts its own block under the menu and turns off the page outline ("outline": {"enabled": false}) for every page in the section.
  3. Page. "$reset": true in the outline region drops what came from the section, and the page sets the right column again: the outline and its own note. The page turns on the footer only for itself.
page.page.json
"layout": {  "regions": {    "outline": {      "$reset": true,      "enabled": true,      "sections": [        {"id": "page-outline", "section": "docara.outline"},        {          "id": "page-context",          "section": "docara.shell",          "utilities": ["flex", "flex-col", "gap-1"],          "blocks": [            {"id": "label", "block": "shell.element", "slot": "content", "element": {"tag": "p", "text": "Updated on 2 November 2026.", "utilities": ["m-0"]}}          ]        }      ]    },

Without $reset, the page fields would merge with the section fields. With a reset, the region is fully described in page.json, and you do not need to remember what came from above.

What you can change

Parameter What it changes
$reset Drops the inherited setting and sets it again
enabled Whether the region is shown
sections What the region holds, top to bottom

See also