links block

A flat list of outbound links, rendered as a row of pill links.

links block

A compact strip of outbound links — “Docs · Status · Pricing · Book a call”. Use it under the chat panel for utility navigation, or above the chat when the most useful next action is not asking the agent something.

When to use it

• Surfacing external pages every visitor will eventually want: docs, status page, pricing, contact.
• Replacing a long list of inline markdown links with something visually structured.
• Footer-style “useful links” rail at position: below_chat.

Shape

{
  "id": "links-1",
  "type": "links",
  "position": "below_chat",
  "heading": "Useful links",
  "items": [
    { "label": "Status page", "url": "https://status.example.com" },
    { "label": "Warranty policy", "url": "https://example.com/warranty" }
  ]
}

Field	Required	Type	Notes
id	yes	string	Stable slug, unique.
type	yes	"links"	Fixed.
position	no	enum	Default above_chat.
heading	no	string	Small heading above the row. Omit for unlabelled links.
items[]	no	array	Each item: { label, url, icon? }.
items[].label	yes	string	The visible text.
items[].url	yes	string	Full URL — opens in a new tab with rel="noopener noreferrer".
items[].icon	no	string	Reserved for future use; currently unused.

Tips

• Aim for 3–6 items; more than that loses the “quick links” effect.
• For a single prominent CTA, use hero — links is designed for peers, not for one dominant action.
• All links open in a new tab. There’s no way to keep the visitor on the chat page when they click.