# Generative UI: Composites

> Combine links, citations, follow-ups, entity cards and image collections.

Source: <https://everruns.com/docs/reference/generative-ui/composites/>

Combine links, citations, follow-ups, entity cards and image collections.

[All categories](https://everruns.com/docs/reference/generative-ui/)[Layout](https://everruns.com/docs/reference/generative-ui/layout/)[Text](https://everruns.com/docs/reference/generative-ui/text/)[Inputs](https://everruns.com/docs/reference/generative-ui/inputs/)[Data](https://everruns.com/docs/reference/generative-ui/data/)[Dynamic values](https://everruns.com/docs/reference/generative-ui/dynamic-values/)[Media](https://everruns.com/docs/reference/generative-ui/media/)[Composites](https://everruns.com/docs/reference/generative-ui/composites/)[Feedback](https://everruns.com/docs/reference/generative-ui/feedback/)

Try the controls and expand **A2UI example** for source. Actions display their message and values locally; no account or agent run is needed. Use **Reset** to start again. External maps and media load only when you select their load button.

No examples match. Try another component name or category.

Composites

## LinkCard

`LinkCard`

A2UI example

Put this operation inside an `a2ui` Markdown fence. Try the controls above. Actions appear locally in the preview; in an editable chat they become messages.

```
{
  "version": "1.0",
  "createSurface": {
    "surfaceId": "example-28",
    "catalogId": "copilotkit/standard@1",
    "components": [
      {
        "id": "root",
        "component": "Column",
        "gap": 3,
        "children": [
          "a",
          "b"
        ]
      },
      {
        "id": "a",
        "component": "LinkCard",
        "href": "https://docs.copilotkit.ai/generative-ui",
        "title": "Generative UI",
        "description": "Render interactive surfaces from fences in ordinary markdown replies.",
        "image": "https://picsum.photos/seed/linkcard/200/200"
      },
      {
        "id": "b",
        "component": "LinkCard",
        "href": "https://a2ui.org",
        "title": "A2UI specification",
        "description": "The agent-to-UI protocol these components implement."
      }
    ]
  }
}
```

Composites

## Citation

`Citation`

A2UI example

Put this operation inside an `a2ui` Markdown fence. Try the controls above. Actions appear locally in the preview; in an editable chat they become messages.

```
{
  "version": "1.0",
  "createSurface": {
    "surfaceId": "example-29",
    "catalogId": "copilotkit/standard@1",
    "components": [
      {
        "id": "root",
        "component": "Column",
        "gap": 2,
        "children": [
          "r1"
        ]
      },
      {
        "id": "r1",
        "component": "Row",
        "gap": 0,
        "align": "baseline",
        "wrap": "wrap",
        "children": [
          "t1",
          "c1",
          "t2",
          "c2"
        ]
      },
      {
        "id": "t1",
        "component": "Text",
        "text": "Vienna has about 1.9 million inhabitants",
        "inline": true
      },
      {
        "id": "c1",
        "component": "Citation",
        "index": 1,
        "title": "Vienna",
        "url": "https://en.wikipedia.org/wiki/Vienna",
        "snippet": "Vienna is the capital, most populous city, and one of nine federal states of Austria."
      },
      {
        "id": "t2",
        "component": "Text",
        "text": " and sits on the Danube.",
        "inline": true
      },
      {
        "id": "c2",
        "component": "Citation",
        "index": 2,
        "title": "Danube",
        "url": "https://en.wikipedia.org/wiki/Danube",
        "snippet": "The Danube flows through Vienna."
      }
    ]
  }
}
```

Composites

## FollowUp pills

`FollowUp`

A2UI example

Put this operation inside an `a2ui` Markdown fence. Try the controls above. Actions appear locally in the preview; in an editable chat they become messages.

```
{
  "version": "1.0",
  "createSurface": {
    "surfaceId": "example-30",
    "catalogId": "copilotkit/standard@1",
    "components": [
      {
        "id": "root",
        "component": "FollowUp",
        "title": "Next",
        "items": [
          "Make it cheaper",
          {
            "label": "Luxury version",
            "message": "Turn this into a luxury version"
          },
          "Add a map"
        ],
        "onFollowUp": {
          "event": {
            "name": "follow_up"
          }
        }
      }
    ]
  }
}
```

Composites

## EntityCard

`EntityCard`

A2UI example

Put this operation inside an `a2ui` Markdown fence. Try the controls above. Actions appear locally in the preview; in an editable chat they become messages.

```
{
  "version": "1.0",
  "createSurface": {
    "surfaceId": "example-31",
    "catalogId": "copilotkit/standard@1",
    "components": [
      {
        "id": "root",
        "component": "Grid",
        "columns": 2,
        "gap": 3,
        "children": [
          "e1",
          "e2"
        ]
      },
      {
        "id": "e1",
        "component": "EntityCard",
        "title": "Café Central",
        "subtitle": "Coffee house · 1st district",
        "description": "Grand historic café known for its vaulted interior and literary legacy.",
        "image": "https://picsum.photos/seed/cafe/600/450",
        "meta": "Open until 22:00 · €€",
        "badge": {
          "label": "Popular",
          "color": "success"
        },
        "rating": 4.5,
        "ratingCount": 12840,
        "actions": [
          {
            "label": "Directions",
            "href": "https://maps.google.com/?q=Caf%C3%A9+Central+Wien"
          },
          {
            "label": "Pick",
            "variant": "solid"
          }
        ],
        "onAction": {
          "event": {
            "name": "pick",
            "context": {
              "message": "I pick Café Central"
            }
          }
        }
      },
      {
        "id": "e2",
        "component": "EntityCard",
        "layout": "horizontal",
        "title": "Café Sacher",
        "subtitle": "Hotel café",
        "description": "Home of the original Sachertorte.",
        "image": "https://picsum.photos/seed/sacher/300/300",
        "meta": "€€€",
        "rating": 4.2
      }
    ]
  }
}
```

Composites

## ImageGrid (bento)

`ImageGrid`

A2UI example

Put this operation inside an `a2ui` Markdown fence. Try the controls above. Actions appear locally in the preview; in an editable chat they become messages.

```
{
  "version": "1.0",
  "createSurface": {
    "surfaceId": "example-32",
    "catalogId": "copilotkit/standard@1",
    "components": [
      {
        "id": "root",
        "component": "ImageGrid",
        "layout": "bento",
        "columns": 3,
        "images": [
          {
            "url": "https://picsum.photos/seed/g1/800/800",
            "description": "One",
            "caption": "Hofburg"
          },
          {
            "url": "https://picsum.photos/seed/g2/400/400",
            "description": "Two"
          },
          {
            "url": "https://picsum.photos/seed/g3/400/400",
            "description": "Three"
          },
          {
            "url": "https://picsum.photos/seed/g4/400/400",
            "description": "Four"
          },
          {
            "url": "https://picsum.photos/seed/g5/400/400",
            "description": "Five"
          }
        ]
      }
    ]
  }
}
```

Composites

## Carousel with CarouselMediaItem

`CarouselMediaItem`

A2UI example

Put this operation inside an `a2ui` Markdown fence. Try the controls above. Actions appear locally in the preview; in an editable chat they become messages.

```
{
  "version": "1.0",
  "createSurface": {
    "surfaceId": "example-33",
    "catalogId": "copilotkit/standard@1",
    "components": [
      {
        "id": "root",
        "component": "Carousel",
        "gap": 3,
        "label": "Places",
        "children": [
          "m1",
          "m2",
          "m3",
          "m4"
        ]
      },
      {
        "id": "m1",
        "component": "CarouselMediaItem",
        "url": "https://picsum.photos/seed/m1/480/360",
        "children": [
          "c1"
        ]
      },
      {
        "id": "c1",
        "component": "Caption",
        "text": "Schönbrunn"
      },
      {
        "id": "m2",
        "component": "CarouselMediaItem",
        "url": "https://picsum.photos/seed/m2/480/360",
        "children": [
          "c2"
        ]
      },
      {
        "id": "c2",
        "component": "Caption",
        "text": "Belvedere"
      },
      {
        "id": "m3",
        "component": "CarouselMediaItem",
        "url": "https://picsum.photos/seed/m3/480/360",
        "children": [
          "c3"
        ]
      },
      {
        "id": "c3",
        "component": "Caption",
        "text": "Prater"
      },
      {
        "id": "m4",
        "component": "CarouselMediaItem",
        "url": "https://picsum.photos/seed/m4/480/360",
        "size": "sm",
        "children": [
          "c4"
        ]
      },
      {
        "id": "c4",
        "component": "Caption",
        "text": "Naschmarkt (sm)"
      }
    ]
  }
}
```

Composites

## Button verbs: href and copy; horizontal chart

`Button``Chart`

A2UI example

Put this operation inside an `a2ui` Markdown fence. Try the controls above. Actions appear locally in the preview; in an editable chat they become messages.

```
{
  "version": "1.0",
  "createSurface": {
    "surfaceId": "example-34",
    "catalogId": "copilotkit/standard@1",
    "components": [
      {
        "id": "root",
        "component": "Column",
        "gap": 3,
        "children": [
          "row",
          "ch"
        ]
      },
      {
        "id": "row",
        "component": "Row",
        "gap": 2,
        "children": [
          "b1",
          "b2"
        ]
      },
      {
        "id": "b1",
        "component": "Button",
        "label": "Open docs",
        "icon": "external-link",
        "href": "https://docs.copilotkit.ai"
      },
      {
        "id": "b2",
        "component": "Button",
        "label": "Copy code",
        "variant": "soft",
        "icon": "copy",
        "copy": "WELCOME-2026"
      },
      {
        "id": "ch",
        "component": "Chart",
        "chartType": "bar",
        "layout": "horizontal",
        "title": "Horizontal bars with a y-axis label",
        "height": 200,
        "data": [
          {
            "plan": "Starter",
            "seats": 12
          },
          {
            "plan": "Team",
            "seats": 48
          },
          {
            "plan": "Enterprise",
            "seats": 130
          }
        ],
        "xKey": "plan",
        "series": [
          "seats"
        ],
        "yAxis": {
          "label": "Seats"
        },
        "barRadius": 6
      }
    ]
  }
}
```

Using these components in chat? See [Generative UI in chat](https://everruns.com/docs/features/generative-ui/) and [AG-UI support](https://everruns.com/docs/integrations/ag-ui/).

Examples adapted from the [CopilotKit standard catalog](https://docs.copilotkit.ai/generative-ui/components/standard-catalog), under the [MIT license](https://github.com/everruns/everruns/blob/main/apps/ui/generative-ui/COPILOTKIT-LICENSE).