Tags
Organize files with tags and metadata.
Tags provide a flexible way to categorize and filter files across your space.
How Tags Work
Tags are associated with files through a many-to-many relationship. A file can have multiple tags, and a tag can be applied to multiple files.
Auto-Tagging
Upload configs can automatically apply tags to uploaded files:
{
"config": {
"metadata": {
"tags": ["product", "catalog"],
"auto_tagging": true
}
}
}
Tag Configuration
| Field | Type | Description |
|---|---|---|
tags | array | Tags automatically applied to every uploaded file |
auto_tagging | boolean | Enable automatic tag generation |
When tags are defined in the upload config, every file uploaded through that config will have those tags applied automatically.
Using Tags for Organization
Tags are useful for:
- Categorizing files by purpose (e.g.,
product,banner,avatar) - Filtering files in the management API
- Grouping related assets across folders
- Tracking file provenance (e.g.,
uploaded-via-widget,imported)
Best Practices
- Use consistent, lowercase tag names
- Define default tags in upload configs for automatic categorization
- Use descriptive tags that help with future filtering
- Combine folder organization with tags for flexible asset management