> ## 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.

# 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

```json theme={null}
{
  "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](/sections/page-layout/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.