# dk.raakode.lab.groups.group

> Published by [lexauthority.pds1.lab.raakode.dk](https://lexicon.garden/identity/did:plc:ck6ybqliyrt6irwzqflfhzdq)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:ck6ybqliyrt6irwzqflfhzdq/dk.raakode.lab.groups.group)
- [Documentation](https://lexicon.garden/lexicon/did:plc:ck6ybqliyrt6irwzqflfhzdq/dk.raakode.lab.groups.group/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:ck6ybqliyrt6irwzqflfhzdq/dk.raakode.lab.groups.group/examples)

## Definitions

### `dk.raakode.lab.groups.group`

**Type**: `record`

The group's own description of itself, including whether it wants to be discoverable. Written by the group authority into its repo in the group's space, so it travels with the group when it changes app — a group that chose to be unlisted stays unlisted under a new operator.

**Key**: `literal:self`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `name` | `string` | Yes |  |
| `listed` | `boolean` | No | Whether the group may appear in an application's public directory. Absent means listed, so existing groups keep behaving as before. Unlisted hides the name and description from non-members; it cannot hide the group's existence, because a group is an account and a PDS enumerates its accounts publicly (see docs/evidence/privacy-of-membership.md). |
| `createdAt` | `string` (datetime) | Yes |  |
| `description` | `string` | No |  |

## Raw Schema

```json
{
  "id": "dk.raakode.lab.groups.group",
  "defs": {
    "main": {
      "key": "literal:self",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "name",
          "createdAt"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 640,
            "maxGraphemes": 64
          },
          "listed": {
            "type": "boolean",
            "description": "Whether the group may appear in an application's public directory. Absent means listed, so existing groups keep behaving as before. Unlisted hides the name and description from non-members; it cannot hide the group's existence, because a group is an account and a PDS enumerates its accounts publicly (see docs/evidence/privacy-of-membership.md)."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime"
          },
          "description": {
            "type": "string",
            "maxLength": 3000,
            "maxGraphemes": 300
          }
        }
      },
      "description": "The group's own description of itself, including whether it wants to be discoverable. Written by the group authority into its repo in the group's space, so it travels with the group when it changes app — a group that chose to be unlisted stays unlisted under a new operator."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```