Array
Array metadata stores multiple values in one field. Use it for multiple selected records, multiple option values, multiple members, or multiple uploaded files.
Value Shape
type ArrayMetadataValue = unknown[] | null;
Normalize before iterating:
const tags = Array.isArray(record.data.tags) ? record.data.tags : [];
Common Uses
| Use | Examples |
|---|---|
| Multiple records | Related orders, affected assets |
| Multiple options | Tags, categories |
| Multiple people | Participants, reviewers |
| Uploaded resources | Images, videos, files, audio |