Media Integration
When to Use
Storing icon references as media entities so they can be browsed in the media library, reused, and have their own metadata.
Pattern
Enable ui_icons_media. Create a new media type with source plugin Icon. Each media entity stores one pack_id:icon_id plus optional settings.
Decision
| Want | Use |
|---|---|
| Icons as a "library" reused across pages | Media + Icon source |
| Icons inline in content body | CKEditor 5 Integration |
| Icons as a per-entity field | Field API Integration |
Common Mistakes
- Wrong: creating Icon media entities for every icon use → Right: use the Field API or CKEditor integrations when reuse isn't needed; they're simpler