Pagination

A control for navigating through a series of pages or results.

Surfaces

webmeet-stageapps-script-web

Degraded on

Surface	Note
googlechat	Renders as a set of buttons or text links. Complex styling and active page indication might be limited.
email	Renders as a simple list of links, losing interactive styling and current page indication.
pdf	Renders as a simple list of links, losing interactive styling and current page indication.

Fields

Field	Type
current_page	integer	required
total_pages	integer	required
base_url	string (the URL prefix for all page links)	required
page_param	string (e.g., 'page', the query parameter name for the page number)	required

Example payload

{
  "type": "pagination",
  "current_page": 2,
  "total_pages": 5,
  "base_url": "https://example.com",
  "page_param": 1
}

ARD catalog entry

{
  "identifier": "urn:air:a2uicatalog.ai:atom:pagination",
  "displayName": "Pagination",
  "type": "application/vnd.a2ui.atom+json",
  "url": "https://a2uicatalog.ai/atoms/pagination",
  "capabilities": [
    "web",
    "meet-stage",
    "apps-script-web"
  ],
  "description": "A control for navigating through a series of pages or results.",
  "representativeQueries": [
    "show a page number controls",
    "a control for navigating through a series of pages or results.",
    "render a pagination"
  ]
}

← Full ARD catalog Try it live →

Deploy your own renderer

The renderer is open source. Deploy your own instance in 4 commands — you own the URL, no dependency on the demo endpoint.

git clone https://github.com/a2uicatalog/a2ui
cd apps-script-surface/gas-schema-renderer
clasp push && clasp deploy

Full deploy guide →