Raw schema
{
"type": "object",
"properties": {
"name": {
"description": "A new name for the site",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"theme": {
"description": "Keys to change. hue, chroma, tone and contrast, sent together, derive all six colours and replace those set before; a colour sent beside them is kept over it.",
"type": "object",
"properties": {
"--color-bg": {
"type": "string"
},
"--color-surface-1": {
"type": "string"
},
"--color-text": {
"type": "string"
},
"--color-muted": {
"type": "string"
},
"--color-border": {
"type": "string"
},
"--color-accent": {
"type": "string"
},
"--font-sans": {
"type": "string"
},
"--font-heading": {
"description": "Headings, and the site's name and menu unless --font-header sets theirs; unset, they take --font-sans",
"type": "string"
},
"--color-heading": {
"description": "The colour of headings, the site's name and its menu; unset, they take the text's",
"type": "string"
},
"--font-heading-weight": {
"description": "Their weight, \"700\" bold; unset, each heading keeps its own",
"type": "string",
"pattern": "^(?:[1-9]00)?$"
},
"--heading-align": {
"description": "Where the headings in a page's text sit: \"center\" centred; unset, at the start of the line",
"type": "string",
"enum": [
"",
"start",
"center",
"end"
]
},
"--heading-tracking": {
"description": "Space between the letters of headings, \"-0.03em\" tight for a large sans; unset, the font's own",
"type": "string",
"pattern": "^(?:-?\\d*\\.?\\d+em)?$"
},
"--text-size": {
"description": "The size of body text on a laptop, every heading reckoned from it, \"1.2rem\"; unset, 1rem",
"type": "string",
"pattern": "^(?:\\d*\\.?\\d+rem)?$"
},
"--hero-size": {
"description": "The size of an opening's heading on a laptop, \"3rem\"; unset, it grows with the window",
"type": "string",
"pattern": "^(?:\\d*\\.?\\d+rem)?$"
},
"--name-size": {
"description": "The size of the site's name in the header on a laptop, \"1.8rem\"; unset, the text's",
"type": "string",
"pattern": "^(?:\\d*\\.?\\d+rem)?$"
},
"--nav-size": {
"description": "The size of the header menu on a laptop, \"1.2rem\"; unset, the text's",
"type": "string",
"pattern": "^(?:\\d*\\.?\\d+rem)?$"
},
"--font-header": {
"description": "The font of the site's name and its menu; unset, the headings'",
"type": "string"
},
"--font-name": {
"description": "The site's name in a font of its own, written as --font-sans is; unset, --font-header's",
"type": "string"
},
"--name-weight": {
"description": "The name's weight; unset, the headings'",
"type": "string",
"pattern": "^(?:[1-9]00)?$"
},
"--color-name": {
"description": "The name's colour; unset, the headings'",
"type": "string"
},
"--color-name-strong": {
"description": "The colour of the words in <strong> in the header's styledName; unset, the name's",
"type": "string"
},
"--tagline-size": {
"description": "The size of the line under the name, \"0.9rem\"; unset, a little under the text's",
"type": "string",
"pattern": "^(?:\\d*\\.?\\d+rem)?$"
},
"--tagline-style": {
"description": "\"italic\" sets the line under the name in italic",
"type": "string",
"enum": [
"",
"italic"
]
},
"--color-tagline": {
"description": "The line's colour; unset, the quiet text's",
"type": "string"
},
"--color-tagline-strong": {
"description": "The colour of the words in <strong> in the line; unset, the line's",
"type": "string"
},
"--font-nav": {
"description": "The header menu's font, written as --font-sans is; unset, --font-header's",
"type": "string"
},
"--nav-weight": {
"description": "The menu's weight; unset, the headings'",
"type": "string",
"pattern": "^(?:[1-9]00)?$"
},
"--color-nav": {
"description": "The menu's colour; unset, the headings'",
"type": "string"
},
"--font-header-button": {
"description": "The font of the header's button; unset, the text's",
"type": "string"
},
"--header-button-size": {
"description": "The size of the words on the header's button, \"1.1rem\"; unset, the text's",
"type": "string",
"pattern": "^(?:\\d*\\.?\\d+rem)?$"
},
"--color-header-button": {
"description": "The header button's colour; unset, the accent",
"type": "string"
},
"--color-header-button-text": {
"description": "The colour of its words; unset, the background's",
"type": "string"
},
"--logo-size": {
"description": "The height of the logo in the header, \"5rem\"; unset, 3rem",
"type": "string",
"pattern": "^(?:\\d*\\.?\\d+rem)?$"
},
"--button-padding": {
"description": "Space inside every button, top and bottom then the sides, \"2rem 3rem\"; unset, from the shape",
"type": "string",
"pattern": "^(?:\\d*\\.?\\d+r?em(?: \\d*\\.?\\d+r?em)?)?$"
},
"--button-radius": {
"description": "Every button's corners as CSS border-radius, \"45px 0\" for a petal, \"0\" square, \"999px\" a pill; unset, from roundness",
"type": "string",
"pattern": "^(?:\\d*\\.?\\d+(?:px|rem)?(?: \\d*\\.?\\d+(?:px|rem)?){0,3})?$"
},
"--page-width": {
"description": "With the header's \"wide\", how wide pages may grow, \"93.75rem\"; unset, 112.5rem",
"type": "string",
"pattern": "^(?:\\d*\\.?\\d+rem)?$"
},
"--page-margin": {
"description": "With \"wide\", the margin either side of the header and pages, \"4cqi\" for 4% of the width; unset, 3cqi",
"type": "string",
"pattern": "^(?:\\d*\\.?\\d+(?:rem|cqi))?$"
},
"--header-padding": {
"description": "With \"wide\", the space above and below the header's contents, \"1cqi\"; unset, 2cqi",
"type": "string",
"pattern": "^(?:\\d*\\.?\\d+(?:rem|cqi))?$"
},
"--hero-entrance": {
"description": "How an opening's heading, words and button arrive as the page opens: \"rise\", \"focus\" or \"unveil\"; unset or \"\", at once. A visitor who asks for less motion sees them at once",
"type": "string",
"enum": [
"",
"rise",
"focus",
"unveil"
]
},
"adobeFonts": {
"description": "The id of the site's own Adobe Fonts web project, from its embed code use.typekit.net/<id>.css; \"\" removes it",
"type": "string",
"pattern": "^(?:[a-z0-9]{5,12})?$"
},
"background": {
"description": "A picture behind the whole site, by https URL, held still as the pages scroll over it: every block then sits on a frosted panel of the page's colour, and an opening with no picture of its own sits straight on it. For a single scrolling page with a strong sense of place; \"\" removes it",
"type": "string",
"pattern": "^(?:https:\\/\\/\\S+)?$"
},
"roundness": {
"type": "number",
"minimum": 0,
"maximum": 1,
"description": "Corners of buttons, pictures and panels: 0 square, 1 round"
},
"density": {
"type": "number",
"minimum": 0,
"maximum": 1,
"description": "Space between and around blocks: 0 roomy, 1 compact"
},
"scale": {
"type": "number",
"minimum": 0,
"maximum": 1,
"description": "Headings against body text: 0 close in size, 1 far larger"
},
"depth": {
"type": "number",
"minimum": 0,
"maximum": 1,
"description": "Shadow under buttons and panels: 0 flat, 1 raised"
},
"hue": {
"type": "number",
"minimum": 0,
"maximum": 360,
"description": "The accent colour, as an OKLCH hue in degrees"
},
"chroma": {
"type": "number",
"minimum": 0,
"maximum": 1,
"description": "How colourful the accent is; the rest is tinted with it faintly"
},
"tone": {
"type": "number",
"minimum": 0,
"maximum": 1,
"description": "0 a dark site, 1 a light one"
},
"contrast": {
"type": "number",
"minimum": 0,
"maximum": 1,
"description": "How far text and lines stand from the background"
}
}
},
"header": {
"description": "Replaces the header whole; {} clears it",
"type": "object",
"properties": {
"logo": {
"description": "A logo shown before the name, by https URL",
"type": "string",
"pattern": "^https:\\/\\/\\S+$"
},
"styledName": {
"description": "The site's name as the header draws it: Plain text; words may be wrapped in <strong> or <em>. Shown only while its words are the site's name",
"type": "string"
},
"tagline": {
"description": "A short line under the name: Plain text; words may be wrapped in <strong> or <em>",
"type": "string"
},
"action": {
"description": "One button at the far end of the header",
"type": "object",
"properties": {
"label": {
"type": "string",
"minLength": 1
},
"href": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$"
}
},
"required": [
"label",
"href"
]
},
"enquire": {
"description": "Where every product's Enquire button goes: a mailto:, tel: or page; unset, products have none",
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$"
},
"menu": {
"description": "\"side\" puts the name and menu down the left from a laptop up; across the top, \"start\" sets the menu just after the name and \"center\" in the middle; unset, at the end",
"type": "string",
"enum": [
"side",
"start",
"center"
]
},
"wide": {
"description": "The header, pages and footer run the window's width, their margins growing with it, as a page builder's do; unset, they keep to a column",
"type": "boolean"
},
"shadow": {
"description": "A shadow under the header in place of its line",
"type": "boolean"
},
"sticky": {
"description": "The header stays at the top of the window as the page scrolls",
"type": "boolean"
},
"nav": {
"description": "Where the menu of pages is: \"header\" across the header; \"sidebar\" in a sidebar beside each page, with the search box and the page's sections; \"both\"; unset, the header on a site of pages and the sidebar on a wiki. The search box sits in the sidebar when there is one, else in the header",
"type": "string",
"enum": [
"header",
"sidebar",
"both"
]
},
"social": {
"description": "The site's own profiles elsewhere, by https URL, each an icon at the end of the header: Instagram, Facebook, X, YouTube, LinkedIn or any other",
"maxItems": 8,
"type": "array",
"items": {
"type": "string",
"pattern": "^https:\\/\\/\\S+$"
}
}
}
},
"pages": {
"description": "Pages to create or replace, each whole",
"maxItems": 2000,
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string",
"description": "\"\" is the home page; else slash-separated slugs, no leading slash, never starting \"search\", \"mcp\" or \"download\""
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"description": {
"default": null,
"description": "Search snippet: one sentence under 160 characters",
"anyOf": [
{
"type": "string",
"maxLength": 1000
},
{
"type": "null"
}
]
},
"image": {
"default": null,
"description": "The picture a link to the page shows in a chat or a feed, by https URL, cropped to 1200×630; null draws a card of the page's title over its first picture or the site's colours",
"anyOf": [
{
"type": "string",
"pattern": "^https:\\/\\/\\S+$"
},
{
"type": "null"
}
]
},
"navOrder": {
"default": null,
"description": "Position in the header nav, 0 first; null keeps it out",
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"content": {
"maxItems": 500,
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "content"
},
"text": {
"type": "string",
"description": "Plain semantic HTML"
},
"band": {
"description": "A full-width strip of the panel or the accent colour behind the block",
"type": "string",
"enum": [
"panel",
"accent"
]
}
},
"required": [
"type",
"text"
]
},
{
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "pictures"
},
"items": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"src": {
"type": "string",
"pattern": "^https:\\/\\/\\S+$",
"description": "The picture by https URL, or with \"video\": true an MP4 file"
},
"alt": {
"type": "string",
"description": "What it shows"
},
"caption": {
"type": "string"
},
"video": {
"description": "src is an MP4 file that plays",
"type": "boolean",
"const": true
},
"poster": {
"description": "A video's picture before it plays",
"type": "string",
"pattern": "^https:\\/\\/\\S+$"
}
},
"required": [
"src",
"alt"
]
},
"description": "One picture or video, or several in a row the visitor scrolls sideways, each once, in order"
},
"band": {
"description": "A full-width strip of the panel or the accent colour behind the block",
"type": "string",
"enum": [
"panel",
"accent"
]
}
},
"required": [
"type",
"items"
]
},
{
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "codeTabs"
},
"tabs": {
"minItems": 1,
"maxItems": 8,
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"minLength": 1
},
"language": {
"type": "string"
},
"code": {
"type": "string"
}
},
"required": [
"label",
"code"
]
}
},
"band": {
"description": "A full-width strip of the panel or the accent colour behind the block",
"type": "string",
"enum": [
"panel",
"accent"
]
}
},
"required": [
"type",
"tabs"
]
},
{
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "stats"
},
"items": {
"minItems": 1,
"maxItems": 12,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"value": {
"type": "string",
"minLength": 1,
"description": "As it should read: \"1987\", \"40+\", \"4.9★\""
},
"label": {
"type": "string",
"minLength": 1
},
"suffix": {
"type": "string"
}
},
"required": [
"value",
"label"
]
}
},
"columns": {
"description": "How many to a row; unset, as many as fit",
"anyOf": [
{
"type": "number",
"const": 2
},
{
"type": "number",
"const": 3
},
{
"type": "number",
"const": 4
}
]
},
"band": {
"description": "A full-width strip of the panel or the accent colour behind the block",
"type": "string",
"enum": [
"panel",
"accent"
]
}
},
"required": [
"type",
"items"
]
},
{
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "linkGrid"
},
"intro": {
"type": "string"
},
"groups": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"heading": {
"type": "string"
},
"description": {
"description": "Plain semantic HTML",
"type": [
"string",
"null"
]
},
"links": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"minLength": 1
},
"href": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$"
}
},
"required": [
"label",
"href"
]
}
}
},
"required": [
"heading",
"links"
]
},
"description": "Groups of links under a heading each"
},
"band": {
"description": "A full-width strip of the panel or the accent colour behind the block",
"type": "string",
"enum": [
"panel",
"accent"
]
}
},
"required": [
"type",
"groups"
]
},
{
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "references"
},
"title": {
"description": "Its heading; unset, \"References\"",
"type": "string"
},
"items": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"text": {
"type": "string",
"minLength": 1,
"description": "The citation, plain semantic HTML"
},
"url": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$"
}
},
"required": [
"text"
]
}
},
"band": {
"description": "A full-width strip of the panel or the accent colour behind the block",
"type": "string",
"enum": [
"panel",
"accent"
]
}
},
"required": [
"type",
"items"
]
},
{
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "banner"
},
"variant": {
"type": "string",
"enum": [
"stub",
"unsourced",
"outdated",
"promotional",
"cleanup",
"coi"
],
"description": "The notice: a stub, unsourced, outdated, promotional, needing cleanup, or written with a conflict of interest"
},
"text": {
"description": "Words in place of the notice's standard ones",
"type": "string"
},
"band": {
"description": "A full-width strip of the panel or the accent colour behind the block",
"type": "string",
"enum": [
"panel",
"accent"
]
}
},
"required": [
"type",
"variant"
]
},
{
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "list"
},
"source": {
"type": "string",
"enum": [
"under",
"newest",
"chosen",
"products"
],
"description": "\"under\" the pages directly under an address (on a wiki, in a category); \"newest\" the most recently changed; \"chosen\" the pages named in \"pages\"; \"products\" the product pages"
},
"under": {
"description": "The address or category listed, or with \"newest\" the one the newest are taken from; omit for the top level, or the whole site",
"type": "string"
},
"count": {
"description": "With \"newest\", how many; unset, 6",
"type": "integer",
"minimum": 1,
"maximum": 48
},
"pages": {
"description": "With \"chosen\", the pages by path, in the order they are listed",
"maxItems": 48,
"type": "array",
"items": {
"type": "string"
}
},
"show": {
"default": "cards",
"description": "Cards of each page's first picture, title and search snippet, or links with how long ago each changed; products are always cards",
"type": "string",
"enum": [
"cards",
"links"
]
},
"shape": {
"description": "Each card's picture upright, as a book's cover or a poster, or wide; unset, square for products and wide for pages",
"type": "string",
"enum": [
"portrait",
"landscape"
]
},
"tag": {
"description": "With \"products\", only those with this tag; omit for all",
"type": "string"
},
"menu": {
"description": "With \"products\", the shop's lists, linked down the left of the cards with this one marked; the block then heads the page with its title",
"maxItems": 24,
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"minLength": 1
},
"href": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$"
}
},
"required": [
"label",
"href"
]
}
},
"band": {
"description": "A full-width strip of the panel or the accent colour behind the block",
"type": "string",
"enum": [
"panel",
"accent"
]
}
},
"required": [
"type",
"source"
]
},
{
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "events"
},
"upcoming": {
"description": "The heading over those to come or on now; unset, \"Upcoming\"",
"type": "string"
},
"past": {
"description": "The heading over those that have ended; unset, \"Past\"",
"type": "string"
},
"items": {
"minItems": 1,
"maxItems": 300,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"date": {
"type": "string",
"pattern": "^\\d{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12]\\d|3[01]))?)?$",
"description": "When it starts, as precisely as known: \"2026\", \"2026-11\" or \"2026-11-12\""
},
"end": {
"description": "When it ends, written as date is; unset, it ends when it starts",
"type": "string",
"pattern": "^\\d{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12]\\d|3[01]))?)?$"
},
"text": {
"type": "string",
"minLength": 1,
"description": "What it is and where: Plain text; words may be wrapped in <strong> or <em>, and in <a href> for a link"
}
},
"required": [
"date",
"text"
]
},
"description": "In any order: the page sets those to come soonest first and those that have ended latest first, by the day it is read"
},
"band": {
"description": "A full-width strip of the panel or the accent colour behind the block",
"type": "string",
"enum": [
"panel",
"accent"
]
}
},
"required": [
"type",
"items"
]
},
{
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "locations"
},
"heading": {
"description": "An h2 over the places, whose names are then h3s; unset, each name is an h2",
"type": "string"
},
"map": {
"description": "A map of each address, set under it",
"type": "boolean",
"const": true
},
"items": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"name": {
"description": "Which one it is, where a business has several: \"Covent Garden\"; unset where it has one",
"type": "string"
},
"image": {
"description": "A picture of it, by https URL",
"type": "string",
"pattern": "^https:\\/\\/\\S+$"
},
"address": {
"description": "Plain text, a line to a line: \"27 Monmouth Street\\nLondon WC2H 9EU\"",
"type": "string"
},
"map": {
"description": "A link to the place on a map, as the business gives it; unset, a search for the address",
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$"
},
"phone": {
"description": "As it reads: \"020 7232 3010\"",
"type": "string",
"pattern": "^\\+?[\\d\\s().-]{6,}$"
},
"email": {
"type": "string",
"pattern": "^[^\\s@<>]+@[^\\s@<>]+\\.[^\\s@<>]+$"
},
"hours": {
"description": "Its regular opening hours, a row for each set of days that keeps the same times and two rows for a day it closes in the middle of; a day in none is closed",
"maxItems": 21,
"type": "array",
"items": {
"type": "object",
"properties": {
"days": {
"minItems": 1,
"type": "array",
"items": {
"type": "string",
"enum": [
"mon",
"tue",
"wed",
"thu",
"fri",
"sat",
"sun"
]
},
"description": "The days these hours hold: \"mon\" to \"sun\""
},
"opens": {
"type": "string",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
"description": "24-hour: \"08:00\""
},
"closes": {
"type": "string",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
"description": "24-hour: \"18:00\"; at or before opens, the next morning; equal to opens, open all day"
}
},
"required": [
"days",
"opens",
"closes"
]
}
},
"timeZone": {
"description": "Where its clock is, as \"America/Los_Angeles\"; unset, \"Europe/London\"",
"type": "string"
},
"note": {
"description": "What the hours do not say: \"Closed on bank holidays\", \"Card payments only\"; Plain text; words may be wrapped in <strong> or <em>, and in <a href> for a link",
"type": "string"
}
}
}
},
"band": {
"description": "A full-width strip of the panel or the accent colour behind the block",
"type": "string",
"enum": [
"panel",
"accent"
]
}
},
"required": [
"type",
"items"
]
},
{
"type": "object",
"properties": {
"band": {
"description": "A full-width strip of the panel or the accent colour behind the block",
"type": "string",
"enum": [
"panel",
"accent"
]
},
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "columns"
},
"columns": {
"minItems": 1,
"maxItems": 12,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"blocks": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "content"
},
"text": {
"type": "string",
"description": "Plain semantic HTML"
}
},
"required": [
"type",
"text"
]
},
{
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "pictures"
},
"items": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"src": {
"type": "string",
"pattern": "^https:\\/\\/\\S+$",
"description": "The picture by https URL, or with \"video\": true an MP4 file"
},
"alt": {
"type": "string",
"description": "What it shows"
},
"caption": {
"type": "string"
},
"video": {
"description": "src is an MP4 file that plays",
"type": "boolean",
"const": true
},
"poster": {
"description": "A video's picture before it plays",
"type": "string",
"pattern": "^https:\\/\\/\\S+$"
}
},
"required": [
"src",
"alt"
]
},
"description": "One picture or video, or several in a row the visitor scrolls sideways, each once, in order"
}
},
"required": [
"type",
"items"
]
},
{
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "codeTabs"
},
"tabs": {
"minItems": 1,
"maxItems": 8,
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"minLength": 1
},
"language": {
"type": "string"
},
"code": {
"type": "string"
}
},
"required": [
"label",
"code"
]
}
}
},
"required": [
"type",
"tabs"
]
},
{
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "stats"
},
"items": {
"minItems": 1,
"maxItems": 12,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"value": {
"type": "string",
"minLength": 1,
"description": "As it should read: \"1987\", \"40+\", \"4.9★\""
},
"label": {
"type": "string",
"minLength": 1
},
"suffix": {
"type": "string"
}
},
"required": [
"value",
"label"
]
}
},
"columns": {
"description": "How many to a row; unset, as many as fit",
"anyOf": [
{
"type": "number",
"const": 2
},
{
"type": "number",
"const": 3
},
{
"type": "number",
"const": 4
}
]
}
},
"required": [
"type",
"items"
]
},
{
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "linkGrid"
},
"intro": {
"type": "string"
},
"groups": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"heading": {
"type": "string"
},
"description": {
"description": "Plain semantic HTML",
"type": [
"string",
"null"
]
},
"links": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"minLength": 1
},
"href": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$"
}
},
"required": [
"label",
"href"
]
}
}
},
"required": [
"heading",
"links"
]
},
"description": "Groups of links under a heading each"
}
},
"required": [
"type",
"groups"
]
},
{
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "references"
},
"title": {
"description": "Its heading; unset, \"References\"",
"type": "string"
},
"items": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"text": {
"type": "string",
"minLength": 1,
"description": "The citation, plain semantic HTML"
},
"url": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$"
}
},
"required": [
"text"
]
}
}
},
"required": [
"type",
"items"
]
},
{
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "banner"
},
"variant": {
"type": "string",
"enum": [
"stub",
"unsourced",
"outdated",
"promotional",
"cleanup",
"coi"
],
"description": "The notice: a stub, unsourced, outdated, promotional, needing cleanup, or written with a conflict of interest"
},
"text": {
"description": "Words in place of the notice's standard ones",
"type": "string"
}
},
"required": [
"type",
"variant"
]
},
{
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "list"
},
"source": {
"type": "string",
"enum": [
"under",
"newest",
"chosen",
"products"
],
"description": "\"under\" the pages directly under an address (on a wiki, in a category); \"newest\" the most recently changed; \"chosen\" the pages named in \"pages\"; \"products\" the product pages"
},
"under": {
"description": "The address or category listed, or with \"newest\" the one the newest are taken from; omit for the top level, or the whole site",
"type": "string"
},
"count": {
"description": "With \"newest\", how many; unset, 6",
"type": "integer",
"minimum": 1,
"maximum": 48
},
"pages": {
"description": "With \"chosen\", the pages by path, in the order they are listed",
"maxItems": 48,
"type": "array",
"items": {
"type": "string"
}
},
"show": {
"default": "cards",
"description": "Cards of each page's first picture, title and search snippet, or links with how long ago each changed; products are always cards",
"type": "string",
"enum": [
"cards",
"links"
]
},
"shape": {
"description": "Each card's picture upright, as a book's cover or a poster, or wide; unset, square for products and wide for pages",
"type": "string",
"enum": [
"portrait",
"landscape"
]
},
"tag": {
"description": "With \"products\", only those with this tag; omit for all",
"type": "string"
},
"menu": {
"description": "With \"products\", the shop's lists, linked down the left of the cards with this one marked; the block then heads the page with its title",
"maxItems": 24,
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"minLength": 1
},
"href": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$"
}
},
"required": [
"label",
"href"
]
}
}
},
"required": [
"type",
"source"
]
},
{
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "events"
},
"upcoming": {
"description": "The heading over those to come or on now; unset, \"Upcoming\"",
"type": "string"
},
"past": {
"description": "The heading over those that have ended; unset, \"Past\"",
"type": "string"
},
"items": {
"minItems": 1,
"maxItems": 300,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"date": {
"type": "string",
"pattern": "^\\d{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12]\\d|3[01]))?)?$",
"description": "When it starts, as precisely as known: \"2026\", \"2026-11\" or \"2026-11-12\""
},
"end": {
"description": "When it ends, written as date is; unset, it ends when it starts",
"type": "string",
"pattern": "^\\d{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12]\\d|3[01]))?)?$"
},
"text": {
"type": "string",
"minLength": 1,
"description": "What it is and where: Plain text; words may be wrapped in <strong> or <em>, and in <a href> for a link"
}
},
"required": [
"date",
"text"
]
},
"description": "In any order: the page sets those to come soonest first and those that have ended latest first, by the day it is read"
}
},
"required": [
"type",
"items"
]
},
{
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "locations"
},
"heading": {
"description": "An h2 over the places, whose names are then h3s; unset, each name is an h2",
"type": "string"
},
"map": {
"description": "A map of each address, set under it",
"type": "boolean",
"const": true
},
"items": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"name": {
"description": "Which one it is, where a business has several: \"Covent Garden\"; unset where it has one",
"type": "string"
},
"image": {
"description": "A picture of it, by https URL",
"type": "string",
"pattern": "^https:\\/\\/\\S+$"
},
"address": {
"description": "Plain text, a line to a line: \"27 Monmouth Street\\nLondon WC2H 9EU\"",
"type": "string"
},
"map": {
"description": "A link to the place on a map, as the business gives it; unset, a search for the address",
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$"
},
"phone": {
"description": "As it reads: \"020 7232 3010\"",
"type": "string",
"pattern": "^\\+?[\\d\\s().-]{6,}$"
},
"email": {
"type": "string",
"pattern": "^[^\\s@<>]+@[^\\s@<>]+\\.[^\\s@<>]+$"
},
"hours": {
"description": "Its regular opening hours, a row for each set of days that keeps the same times and two rows for a day it closes in the middle of; a day in none is closed",
"maxItems": 21,
"type": "array",
"items": {
"type": "object",
"properties": {
"days": {
"minItems": 1,
"type": "array",
"items": {
"type": "string",
"enum": [
"mon",
"tue",
"wed",
"thu",
"fri",
"sat",
"sun"
]
},
"description": "The days these hours hold: \"mon\" to \"sun\""
},
"opens": {
"type": "string",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
"description": "24-hour: \"08:00\""
},
"closes": {
"type": "string",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
"description": "24-hour: \"18:00\"; at or before opens, the next morning; equal to opens, open all day"
}
},
"required": [
"days",
"opens",
"closes"
]
}
},
"timeZone": {
"description": "Where its clock is, as \"America/Los_Angeles\"; unset, \"Europe/London\"",
"type": "string"
},
"note": {
"description": "What the hours do not say: \"Closed on bank holidays\", \"Card payments only\"; Plain text; words may be wrapped in <strong> or <em>, and in <a href> for a link",
"type": "string"
}
}
}
}
},
"required": [
"type",
"items"
]
}
]
}
},
"area": {
"description": "Its place on a twelve-column grid; give every column one, or none",
"type": "object",
"properties": {
"col": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"span": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"row": {
"type": "integer",
"minimum": 1,
"maximum": 99
},
"rows": {
"type": "integer",
"minimum": 1,
"maximum": 99
}
},
"required": [
"col",
"span",
"row",
"rows"
]
}
}
}
},
"gap": {
"type": "string",
"enum": [
"sm",
"md",
"lg"
]
},
"align": {
"type": "string",
"enum": [
"start",
"center",
"end",
"stretch"
]
},
"beside": {
"description": "Set as one panel beside the text, its columns stacked in it: a facts panel on a page about one thing, placed before its content",
"type": "boolean",
"const": true
}
},
"required": [
"type",
"columns"
]
},
{
"type": "object",
"properties": {
"band": {
"description": "A full-width strip of the panel or the accent colour behind the block",
"type": "string",
"enum": [
"panel",
"accent"
]
},
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "hero"
},
"call": {
"description": "A call to action further down the page rather than its opening: its heading an h2, set smaller",
"type": "boolean",
"const": true
},
"heading": {
"type": "string",
"description": "Plain text; words may be wrapped in <strong> or <em>; words in <strong> are drawn in the accent colour"
},
"text": {
"description": "Plain text; words may be wrapped in <strong> or <em>, and in <a href> for a link",
"type": "string"
},
"subheading": {
"description": "Its text is a subheading, set in the headings' font, each line on its own",
"type": "boolean"
},
"action": {
"type": "object",
"properties": {
"label": {
"type": "string",
"minLength": 1
},
"href": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$"
}
},
"required": [
"label",
"href"
]
},
"image": {
"description": "A picture behind the heading, by https URL",
"type": "string",
"pattern": "^https:\\/\\/\\S+$"
},
"backdrop": {
"description": "With no picture, a slowly moving field of the site's own colours behind the heading: \"mesh\" smooth, \"grain\" grainy as print, \"flow\" folding like poured paint, \"marble\" hard-edged as marbled paper",
"type": "string",
"enum": [
"mesh",
"grain",
"flow",
"marble"
]
},
"backdropSpeed": {
"description": "How fast the backdrop moves: 0 still, 1 fast; unset, 0.25, slowly",
"type": "number",
"minimum": 0,
"maximum": 1
},
"backdropIntensity": {
"description": "How strongly the backdrop swirls and folds: 0 gently, 1 wildly; unset, 0.5",
"type": "number",
"minimum": 0,
"maximum": 1
},
"box": {
"description": "Over a picture or backdrop, what the words sit on: unset, boxes of the page's background; \"panel\" or \"accent\" boxes of that colour; \"none\" no box, light words straight on the picture",
"type": "string",
"enum": [
"panel",
"accent",
"none"
]
}
},
"required": [
"type",
"heading"
]
},
{
"type": "object",
"properties": {
"band": {
"description": "A full-width strip of the panel or the accent colour behind the block",
"type": "string",
"enum": [
"panel",
"accent"
]
},
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "product"
},
"service": {
"description": "It is a service, booked rather than sold: a lesson, a treatment, a consultation",
"type": "boolean",
"const": true
},
"images": {
"type": "array",
"items": {
"type": "string",
"pattern": "^https:\\/\\/\\S+$"
},
"description": "Its pictures by https URL, the first on every listing"
},
"price": {
"description": "As it should read, currency included: \"£2,500\"",
"type": "string"
},
"unit": {
"description": "With \"service\", what the price is for, as it reads after it: \"an hour\", \"a session\", \"per person\"; bought online, the buyer says how many",
"type": "string",
"maxLength": 40
},
"duration": {
"description": "With \"service\", how long it takes, as it reads: \"1 hour\", \"Half a day\"",
"type": "string",
"maxLength": 40
},
"sold": {
"description": "A thing sold, or a service fully booked",
"type": "boolean"
},
"tags": {
"default": [],
"description": "The listings it appears in, by their \"tag\"",
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
"text": {
"type": "string",
"description": "Plain semantic HTML: materials, size, year, what it is; for a service, what it involves"
},
"action": {
"description": "A button of its own, to where it is sold or booked elsewhere: a publisher's or a gallery's page, a booking calendar",
"type": "object",
"properties": {
"label": {
"type": "string",
"minLength": 1
},
"href": {
"type": "string",
"pattern": "^(?:\\/(?!\\/)\\S*|#[\\w-]+|https?:\\/\\/\\S+|mailto:\\S+|tel:\\S+)$"
}
},
"required": [
"label",
"href"
]
},
"file": {
"description": "What a buyer downloads once they have paid, which only the site's owner sets, from Products; send it back as read",
"type": "object",
"properties": {
"key": {
"type": "string",
"minLength": 1,
"maxLength": 400
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"size": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"key",
"name",
"size"
]
}
},
"required": [
"type",
"images",
"text"
]
},
{
"type": "object",
"properties": {
"band": {
"description": "A full-width strip of the panel or the accent colour behind the block",
"type": "string",
"enum": [
"panel",
"accent"
]
},
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "donate"
},
"amounts": {
"default": [],
"description": "The suggested gifts as they read, in one currency, only as the charity gives them: [\"£10\", \"£20\"]; the donor may always give an amount of their own",
"maxItems": 6,
"type": "array",
"items": {
"type": "string"
}
},
"currency": {
"description": "With no amounts, the currency gifts are in; unset, £",
"type": "string",
"enum": [
"£",
"$",
"€"
]
},
"monthly": {
"description": "The donor may give it every month as well as once",
"type": "boolean"
}
},
"required": [
"type"
]
},
{
"type": "object",
"properties": {
"band": {
"description": "A full-width strip of the panel or the accent colour behind the block",
"type": "string",
"enum": [
"panel",
"accent"
]
},
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "testimonial"
},
"quote": {
"type": "string",
"minLength": 1,
"description": "Their words, exactly"
},
"author": {
"type": "string",
"minLength": 1,
"description": "Their name"
},
"role": {
"description": "Who they are: \"Bride, 2024\", \"Head chef, The Ivy\"",
"type": "string"
},
"avatarUrl": {
"description": "Their photo, by https URL",
"type": "string",
"pattern": "^https:\\/\\/\\S+$"
}
},
"required": [
"type",
"quote",
"author"
]
},
{
"type": "object",
"properties": {
"band": {
"description": "A full-width strip of the panel or the accent colour behind the block",
"type": "string",
"enum": [
"panel",
"accent"
]
},
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "poem"
},
"title": {
"type": "string"
},
"text": {
"type": "string",
"minLength": 1,
"description": "Plain text as set: a line to a line, a blank line between stanzas, the spaces that indent a line kept; words may be wrapped in <strong> or <em>"
},
"note": {
"description": "A line under it: where it first appeared, \"From Wringing Blood (Shoestring Press, 2013)\"",
"type": "string"
}
},
"required": [
"type",
"text"
]
},
{
"type": "object",
"properties": {
"band": {
"description": "A full-width strip of the panel or the accent colour behind the block",
"type": "string",
"enum": [
"panel",
"accent"
]
},
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "contents"
}
},
"required": [
"type"
]
},
{
"type": "object",
"properties": {
"band": {
"description": "A full-width strip of the panel or the accent colour behind the block",
"type": "string",
"enum": [
"panel",
"accent"
]
},
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "scenes"
},
"items": {
"minItems": 1,
"maxItems": 40,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"section": {
"description": "The id of the section the picture is shown from, as it scrolls into view: an h2 or h3 in the page's text, as its heading reads in lowercase with hyphens for spaces, \"excelsior-studios\"; unset, from where the page opens",
"type": "string",
"pattern": "^[\\w-]+$"
},
"src": {
"type": "string",
"pattern": "^https:\\/\\/\\S+$",
"description": "The picture, by https URL"
}
},
"required": [
"src"
]
},
"description": "In the order the page scrolls"
}
},
"required": [
"type",
"items"
]
},
{
"type": "object",
"properties": {
"band": {
"description": "A full-width strip of the panel or the accent colour behind the block",
"type": "string",
"enum": [
"panel",
"accent"
]
},
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "comments"
}
},
"required": [
"type"
]
},
{
"type": "object",
"properties": {
"band": {
"description": "A full-width strip of the panel or the accent colour behind the block",
"type": "string",
"enum": [
"panel",
"accent"
]
},
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "contact"
}
},
"required": [
"type"
]
},
{
"type": "object",
"properties": {
"band": {
"description": "A full-width strip of the panel or the accent colour behind the block",
"type": "string",
"enum": [
"panel",
"accent"
]
},
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "start"
}
},
"required": [
"type"
],
"description": "miow.me's own home page editor; never on another site"
},
{
"type": "object",
"properties": {
"band": {
"description": "A full-width strip of the panel or the accent colour behind the block",
"type": "string",
"enum": [
"panel",
"accent"
]
},
"id": {
"description": "Omit on a new block, keep as read on one you send back; assigned on write",
"type": "string"
},
"type": {
"type": "string",
"const": "pricing"
},
"heading": {
"type": "string"
}
},
"required": [
"type"
],
"description": "miow.me's own hosting prices; never on another site"
}
]
}
}
},
"required": [
"path",
"title",
"content"
]
}
},
"delete": {
"description": "Paths of pages to remove",
"maxItems": 2000,
"type": "array",
"items": {
"type": "string"
}
},
"summary": {
"type": "string",
"description": "What this change does, in a few words, for the history"
},
"token": {
"description": "The site token from create_site or the site's settings. Omit if your Authorization header carries it.",
"type": "string"
}
},
"required": [
"summary"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}