---
title: "Groups (GroupDecl)"
description: "Generated from the doc schema (CatalogDocSchema, @canonify/kernel-catalog/doc): each field’s type, default and description are the schema’s own, and each example is a bundle file that readBundle…"
order: 8
id: "model/group"
---

# Groups (GroupDecl)

Generated from the doc schema (`CatalogDocSchema`, @canonify/kernel-catalog/doc): each field’s type, default and description are the schema’s own, and each example is a bundle file that readBundle decodes. A field’s Example is its value in one of those examples.

## GroupDecl {#groupdecl}

A group of members (authz); who is in it is data on the member list.

The `groups` slot of the doc holds these, keyed by id. In a bundle each is one file, `groups/<name>.json`, named by its `name`, which the file then leaves out.

| Field | Type | Required | Default | Example | Description |
|---|---|---|---|---|---|
| `id` | [GroupId](shapes.md#groupid) | yes (propose assigns it; a new declaration leaves it out) | — | — | A group id (`gr_…`); renames keep it. |
| `name` | [Ident](shapes.md#ident) | yes | — | `"drivers"` | The group name; `me.groups` holds it (`"drivers" in me.groups`). |
| `label` | [Text](shapes.md#text) | yes | — | `"Drivers"` | The words shown for it. |

`groups/drivers.json`

```json
{ "label": "Drivers" }
```