Tested payload library

A2UI v0.9.1 JSON & JSONL examples

Copy valid A2UI v0.9.1 payloads checked by the same pinned Schema and component-graph rules used in A2UI Validator.

Tested against a2ui-v0.9.1-basic@3f6877b · Last verified July 16, 2026

What is included

Four runnable A2UI examples

The collection moves from a static component tree to data binding, progressive updates, and a complete surface lifecycle. Copy an entire block: a later message may depend on the createSurface message above it.

Example 1

Profile card component tree

A compact static surface using Column, Card, Image, and Text components.

Validator: validJSON array2 messages

What it demonstrates

Reachable root
Nested single-child references
Basic Catalog variants

JSON array

[
  {
    "version": "v0.9.1",
    "createSurface": {
      "surfaceId": "profile-card",
      "catalogId": "https://a2ui.org/specification/v0_9_1/catalogs/basic/catalog.json"
    }
  },
  {
    "version": "v0.9.1",
    "updateComponents": {
      "surfaceId": "profile-card",
      "components": [
        {
          "id": "root",
          "component": "Column",
          "children": [
            "profile"
          ],
          "align": "stretch"
        },
        {
          "id": "profile",
          "component": "Card",
          "child": "profile-content"
        },
        {
          "id": "profile-content",
          "component": "Column",
          "children": [
            "avatar",
            "name",
            "role"
          ]
        },
        {
          "id": "avatar",
          "component": "Image",
          "url": "https://example.com/avatar.png",
          "description": "Portrait of Maya Chen",
          "fit": "cover",
          "variant": "avatar"
        },
        {
          "id": "name",
          "component": "Text",
          "text": "Maya Chen",
          "variant": "h2"
        },
        {
          "id": "role",
          "component": "Text",
          "text": "Frontend engineer",
          "variant": "body"
        }
      ]
    }
  }
]

Example 2

Data-bound signup form

A JSONL stream with a data model, bound form controls, and a server event.

Validator: validJSONL3 messages

What it demonstrates

updateDataModel
Path bindings
Event context

JSONL

{"version":"v0.9.1","createSurface":{"surfaceId":"signup","catalogId":"https://a2ui.org/specification/v0_9_1/catalogs/basic/catalog.json"}}
{"version":"v0.9.1","updateDataModel":{"surfaceId":"signup","path":"/","value":{"email":"","consent":false}}}
{"version":"v0.9.1","updateComponents":{"surfaceId":"signup","components":[{"id":"root","component":"Column","children":["heading","email","consent","submit"]},{"id":"heading","component":"Text","text":"Join the product updates","variant":"h2"},{"id":"email","component":"TextField","label":"Work email","value":{"path":"/email"},"variant":"shortText"},{"id":"consent","component":"CheckBox","label":"Send me product updates","value":{"path":"/consent"}},{"id":"submit","component":"Button","child":"submit-label","variant":"primary","action":{"event":{"name":"submit_signup","context":{"email":{"path":"/email"},"consent":{"path":"/consent"},"source":"examples_page"}}}},{"id":"submit-label","component":"Text","text":"Join waitlist"}]}}

Example 3

Progressive order status

A component reference completed by a later updateComponents message in the same stream.

Validator: validJSONL3 messages

What it demonstrates

Progressive updates
Final accumulated graph
Cross-message references

JSONL

{"version":"v0.9.1","createSurface":{"surfaceId":"order-status","catalogId":"https://a2ui.org/specification/v0_9_1/catalogs/basic/catalog.json"}}
{"version":"v0.9.1","updateComponents":{"surfaceId":"order-status","components":[{"id":"root","component":"Column","children":["title","status-card"]},{"id":"title","component":"Text","text":"Order #A2UI-104","variant":"h2"},{"id":"status-card","component":"Card","child":"status-content"}]}}
{"version":"v0.9.1","updateComponents":{"surfaceId":"order-status","components":[{"id":"status-content","component":"Column","children":["status","eta"]},{"id":"status","component":"Text","text":"Ready to ship","variant":"h3"},{"id":"eta","component":"Text","text":"Estimated delivery: Friday"}]}}

Example 4

Tabs and surface teardown

A full create, update, and delete lifecycle with multiple single-child references.

Validator: validJSON array3 messages

What it demonstrates

Tabs
Complete lifecycle
deleteSurface

JSON array

[
  {
    "version": "v0.9.1",
    "createSurface": {
      "surfaceId": "help-center",
      "catalogId": "https://a2ui.org/specification/v0_9_1/catalogs/basic/catalog.json"
    }
  },
  {
    "version": "v0.9.1",
    "updateComponents": {
      "surfaceId": "help-center",
      "components": [
        {
          "id": "root",
          "component": "Column",
          "children": [
            "heading",
            "topics"
          ]
        },
        {
          "id": "heading",
          "component": "Text",
          "text": "Help center",
          "variant": "h1"
        },
        {
          "id": "topics",
          "component": "Tabs",
          "tabs": [
            {
              "title": "Overview",
              "child": "overview"
            },
            {
              "title": "Details",
              "child": "details"
            }
          ]
        },
        {
          "id": "overview",
          "component": "Text",
          "text": "Start with a createSurface message."
        },
        {
          "id": "details",
          "component": "Text",
          "text": "Delete the surface when the interaction ends."
        }
      ]
    }
  },
  {
    "version": "v0.9.1",
    "deleteSurface": {
      "surfaceId": "help-center"
    }
  }
]

Run the payloads

How to verify an example

Copy the entire block.Keep the message order and do not copy a progressive update in isolation.
Open A2UI Validator.Paste into the editor; JSON arrays and JSONL are both accepted.
Validate locally.A valid report should show the message count and the pinned Schema snapshot.

Open A2UI Validator Compare broken payloads and tested fixes

A2UI v0.9.1 JSON & JSONL examples

Four runnable A2UI examples

Profile card component tree

What it demonstrates

Data-bound signup form

What it demonstrates

Progressive order status

What it demonstrates

Tabs and surface teardown

What it demonstrates

How to verify an example

Read the protocol behind the examples