# TokenEntry

A single design token, from the Design Tokens Community Group (DTCG) format.

Source: `entries/token.schema.yaml`

## TokenEntry {#tokenentry}

A single design token, from the Design Tokens Community Group (DTCG) format.

| Property | Type | Required | Description |
| --- | --- | --- | --- |
| `kind` | `"token"` | ✓ | Marks this entry as a token. |
| `id` | [tokenId](schema.md#common-id-tokenid) | ✓ | This token's unique id. |
| `name` | string | ✓ | The human-readable display name. |
| `description` | string | ✓ | A one-line statement of what this entry is or is for. |
| `purpose` | string |  | Explains the entry's reason for existing. |
| `metadata` | object |  |  |
| `sections` | [dispatch](schema.md#sections-section-dispatch)[] |  | Every documentation section for this entry. (Min items: 1) |
| `extends` | [list](schema.md#common-ref-list) |  | Pointers from this entry to another it inherits from (rel: extends). |
| `related` | [list](schema.md#common-ref-list) |  | Pointers from this entry to another it resembles in usage or purpose. |
| `refs` | [list](schema.md#common-ref-list) |  | Pointers from this entry to entries and outside resources not covered by `related` or `extends`. |
| `$extensions` | [Extensions](schema.md#common-extensions) |  | Escape hatch for tool data, or for an outside id that doesn't fit this schema's own id pattern. Each top-level key MUST be a dotted namespace, like `com.acme`, matching the Design Tokens Community Group's own `$extensions` convention. |
| `tokenType` | string |  | The token's type, from DTCG. (Pattern: `^[a-z][a-zA-Z0-9]*$`) |
| `source` | [Ref](schema.md#common-ref) |  | Path to the token's DTCG source file's token reference. |
| `combos` | [Combo](schema.md#common-combo)[] |  | Rules about which other tokens this one must or must never be paired with. (Min items: 1) |

**References:** [Entry](schema.md#entries-entry), [tokenId](schema.md#common-id-tokenid), [EntryMetadata](schema.md#metadata-entry-metadata), [Ref](schema.md#common-ref), [Combo](schema.md#common-combo), [dispatch](schema.md#sections-section-dispatch), [list](schema.md#common-ref-list), [Extensions](schema.md#common-extensions)