Avatar Group

Renders a stack or row of small user avatars, often indicating a group

Surfaces
webmeet-stagepdfapps-script-web
Degraded on
SurfaceNote
googlechatRenders as a limited number of small images or a text count; stacking/overlapping is not supported.
emailRenders as a limited number of small images or a text count; stacking/overlapping is not reliably supported across clients.
Fields
FieldType
avatarslistrequired
total_countintegerrequired
labelstringrequired
Example payload
{
  "type": "avatar_group",
  "avatars": [
    {
      "src": "https://example.com/image.png",
      "name": "Alice"
    },
    {
      "src": "https://example.com/image.png",
      "name": "Bob"
    }
  ],
  "total_count": 5,
  "label": "Avatar Group"
}
ARD catalog entry
{
  "identifier": "urn:air:a2uicatalog.ai:atom:avatar_group",
  "displayName": "Avatar Group",
  "type": "application/vnd.a2ui.atom+json",
  "url": "https://a2uicatalog.ai/atoms/avatar_group",
  "capabilities": [
    "web",
    "meet-stage",
    "pdf",
    "apps-script-web"
  ],
  "description": "Renders a stack or row of small user avatars, often indicating a group",
  "representativeQueries": [
    "show a stacked user avatar group with overflow count or community",
    "renders a stack or row of small user avatars, often indicating a group",
    "render a avatar group"
  ]
}
← 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 →