markdown block

A free-text markdown block rendered above, below, or beside the chat panel.

markdown block

Renders a markdown string. Use it for extra explanation paragraphs around the chat — features, target audience framing, “how to get the best out of this assistant” tips.

For short notes the chat panel itself should display, prefer public_details.instructions instead — that one renders directly inside the chat header area.

When to use it

• Long-form copy that would be awkward inside instructions.
• A welcome paragraph that complements (not duplicates) the hero block.
• Footer-style fine print sitting under the chat.
• A landing-page-style block above the chat for SEO / first-impression copy.

Shape

{
  "id": "intro-1",
  "type": "markdown",
  "position": "above_chat",
  "body": "## What this agent does\n\nIt answers questions about our docs, status, and warranty…"
}

Field	Required	Type	Notes
id	yes	string	Stable kebab-case slug, unique within page_layout.
type	yes	"markdown"	Fixed.
position	no	above_chat / below_chat / sidebar	Defaults to above_chat.
body	no	string	Markdown source. Empty body renders nothing.

Tips

• Markdown and fenced code blocks are supported. HTML is intentionally not allowed.
• For prominent imagery + CTA, use hero instead — markdown has no styling beyond paragraph text.