notice block

A coloured info / success / warning / error banner with optional title, markdown body, and dismiss button.

notice block

A banner styled by tone (info / success / warning / error) with an icon, optional title, and markdown body. Use it for announcements with urgency — the urgency styling is the whole point.

When to use it

• Transient announcements: “Responses delayed today — high volume”, “Maintenance window tonight 02:00 UTC”.
• Launch / change announcements: “New: schedule conversations for follow-up”.
• Service-impacting errors: “Payment processor outage — checkout disabled”.

For static, always-visible copy use markdown instead — notice is for things that grab attention.

Shape

{
  "id": "notice-1",
  "type": "notice",
  "position": "above_chat",
  "tone": "warning",
  "title": "Responses delayed today",
  "body": "We're seeing higher than usual volume — expect 5–10 min wait for the first reply. Status page: https://status.example.com",
  "dismissible": true
}

Field	Required	Type	Notes
id	yes	string	Stable slug.
type	yes	"notice"	Fixed.
position	no	enum	Default above_chat.
tone	no	info / success / warning / error	Default info. Drives icon and colour scheme.
title	no	string	Bold title.
body	yes	string	Markdown body. Required and non-empty.
dismissible	no	boolean	Default false. When true, an ✕ button appears; dismissal is remembered for the browser session only (no server-side persistence).

Tone usage

• info (blue) — general notes, calm tone.
• success (green) — celebrations, launches, “we just shipped X”.
• warning (amber) — degraded service, wait-times, “expect delays”.
• error (red) — outages, blocked features, payment failures. Use sparingly so it retains weight.

Tips

• Remove the block (don’t just dismiss it) once the announcement is no longer relevant. Dismissals are session-scoped — a returning visitor still sees it.
• Title is optional but recommended for warning/error so the urgency is clear at a glance.
• Don’t stack multiple error-tone notices; the visitor can only act on so much at once. If you have multiple, prefer warning or write a single combined notice.
• Schema enforcement: body must be non-empty. A write that supplies only a title is rejected.