# Metadata

Custom key-value pairs

Canonical URL: https://docs.paradoc.dev/schemas/primitives/metadata/

A Metadata is a collection of custom key-value pairs for storing domain-specific or organizational data. All [Artifacts](/schemas/artifacts) can have metadata associated with them.

## Properties

| Name | Type | Description |
| --- | --- | --- |
| `[key: string]` | `string \| number \| boolean \| null` | Keys must be alphanumeric with hyphens. Values can be strings, numbers, booleans, or null |

## Examples



**YAML**

```yaml
metadata:
  department: Human Resources
  category: onboarding
  priority: 1
  isPublic: false
  approvedBy: null
```

**JSON**

```json
{
  "metadata": {
    "department": "Human Resources",
    "category": "onboarding",
    "priority": 1,
    "isPublic": false,
    "approvedBy": null
  }
}
```