> ## Documentation Index
> Fetch the complete documentation index at: https://agentheya.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/sections/page-layout/markdown) instead — `notice` is for things that *grab* attention.

## Shape

```json theme={null}
{
  "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.