# app.placita.tag

> Published by [placita.app](https://lexicon.garden/identity/did:plc:sg5d3buklhrsufaej4n4hjzx)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:sg5d3buklhrsufaej4n4hjzx/app.placita.tag)
- [Documentation](https://lexicon.garden/lexicon/did:plc:sg5d3buklhrsufaej4n4hjzx/app.placita.tag/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:sg5d3buklhrsufaej4n4hjzx/app.placita.tag/examples)

## Definitions

### `app.placita.tag`

**Type**: `record`

A user-defined tag for organizing saved places. Record key is the slug (any valid record key). Places reference tags by strongRef, so renaming a label updates everywhere.

**Key**: `any`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `color` | `string` | No | Display colour as a hex value, #RRGGBB or #RRGGBBAA. |
| `createdAt` | `string` (datetime) | Yes | When the tag was created. |
| `icon` | `string` | No | Optional icon name. |
| `label` | `string` | Yes | The tag name the user sees. |
| `slug` | `string` | Yes | Stable identifier, also the record key. Lowercase letters, digits and hyphens. It does not change when the label is renamed. |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "A user-defined tag for organizing saved places. Record key is the slug (any valid record key). Places reference tags by strongRef, so renaming a label updates everywhere.",
      "key": "any",
      "record": {
        "properties": {
          "color": {
            "description": "Display colour as a hex value, #RRGGBB or #RRGGBBAA.",
            "maxLength": 9,
            "pattern": "^#[0-9a-fA-F]{6}([0-9a-fA-F]{2})?$",
            "type": "string"
          },
          "createdAt": {
            "description": "When the tag was created.",
            "format": "datetime",
            "type": "string"
          },
          "icon": {
            "description": "Optional icon name.",
            "maxLength": 64,
            "type": "string"
          },
          "label": {
            "description": "The tag name the user sees.",
            "maxGraphemes": 40,
            "maxLength": 120,
            "type": "string"
          },
          "slug": {
            "description": "Stable identifier, also the record key. Lowercase letters, digits and hyphens. It does not change when the label is renamed.",
            "maxLength": 64,
            "pattern": "^[a-z][a-z0-9-]*$",
            "type": "string"
          }
        },
        "required": [
          "slug",
          "label",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "id": "app.placita.tag",
  "lexicon": 1
}
```
