---
title: "Tile"
description: "Row with icon, title/subtitle and a value on the right; body adds a paragraph."
---

> Documentation Index
> Fetch the complete documentation index at: https://gistui.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Tile

```gistui
root = Grid(Tile("Enterprise", "Largest segment", icon:building, value:"+14%", note:"QoQ"), Tile("Churn", "Down from 3.1%", icon:users, value:"-0.4pt", note:"QoQ"), Tile("Single supplier", "One vendor for all chips", icon:alert-triangle, tone:danger, body:"A delay there stops the whole line."), cols:3)
```

## Signature

This is the line a model reads in the system prompt.

```gistui
Tile(title, subtitle?, icon:Icon2, value:str, note:str, body:str, tone:Tone, image:str, href:str, v:sunk|card|plain, do:[@step…], mono)
```

- **Group:** Content
- **Children:** No
- **Positional arguments:** `title`, `subtitle?` (a trailing `?` means it may be left out)

## Props

| Prop | Type | How to write it | Notes |
|---|---|---|---|
| `title` | string | positional, required |  |
| `subtitle` | string | positional, optional |  |
| `icon` | name (open list) | named: `icon:…` | Also accepts `money`, `revenue`, `price`, `cost`, `payment`, `chart`, `analytics`, `trend`, `growth`, `decline`, `people`, `team`, `customers`, `person`, `company`, `office`, `location`, `place`, `travel`, `flight`, `food`, `restaurant`, `time`, `date`, `email`, `chat`, `security`, `idea`, `ai`, `launch`, `speed`, `energy`, `warning`, `error`, `success`, `video`, `movie`, `streaming`, `game`, `education`, `nature`, `health`, `legal`, `document`, `photo`, `shop`, `shopping`, `house`, `storage`, `api`, `winner`, `goal`, `sunny`, `clear`, `cloudy`, `partly-cloudy`, `rain`, `rainy`, `snow`, `storm`, `thunder`, `temperature`, `takeoff`, `departure`, `landing`, `arrival`, `baggage`, `seat`, `bag`. |
| `value` | string | named: `value:…` | +/- values are coloured |
| `mono` | flag | bare word: `mono` | do not colour signed values |
| `note` | string | named: `note:…` | under the value |
| `body` | string | named: `body:…` | Markdown paragraph |
| `tone` | `neutral` · `info` · `success` · `warning` · `danger` · `accent` | named: `tone:…` | Also accepts `error`, `red`, `green`, `blue`, `yellow`, `primary`. |
| `image` | string (URL) | named: `image:…` |  |
| `href` | string | named: `href:…` |  |
| `v` | `sunk` · `card` · `plain` | named: `v:…` | Default `"sunk"`. |
| `do` | action list | named: `do:…` | steps run on click |

## Use your own component

Keep the name and schema, swap what is drawn. The prompt and the model's output do not change.

### React

```tsx
import { ui } from "@gistui/react/ui";

const lib = ui.extend({ Tile: MyTile });
<GistUI library={lib} stream={response.body} />;
```
### Vue

```vue
<GistUI :source="answer" :components="{ Tile: MyTile }" />
```
### Svelte

```svelte
<GistUI source={answer} components={{ Tile: MyTile }} />
```
### Solid

```tsx
<GistUI source={answer()} components={{ Tile: MyTile }} />
```
### Vanilla

```ts
import { ui } from "@gistui/vanilla/ui";

const lib = ui.extend({ Tile: (ctx) => ({ el: myElement(ctx) }) });
```

See [Custom components](/docs/guides/custom-components/) for the full contract. Style hook: `[data-gistui="Tile"]`.

Source: https://gistui.com/docs/components/content/tile/index.mdx