Media Files

What It Is

Media files are first-class records that wrap uploaded files together with metadata about publicity and assignment context.

Why It Matters

Not every file should remain only as a property value on another object. Media files give the tenant a managed asset surface with clearer governance.

Key Configuration Surface

• file name
• file source
• publicity
• assignment type
• assignment object id
• assignment notes

Publicity Levels

Media file publicity can distinguish between:

• system
• private
• public

This is an important governance decision because it changes who may access the asset and how the file may participate in public-facing experiences.

Assignment Context

Assignment fields make it possible to model why a file exists and which object or type it belongs to operationally, even when the file is managed as its own record.

Best Practices

• use media files for managed assets that need governance beyond a single field
• use public media intentionally
• store assignment metadata meaningfully when reuse or lifecycle review matters

Related Chapters

• Properties
• Customization