# Media Library

Store images and videos for embedding in item descriptions, content sections, and blog posts. Files are hosted on a CDN with permanent URLs.

## Uploading Media

1. Go to your dashboard and open the **Media** tab
2. Click "Upload"
3. Select an image or video file
4. Optionally choose a folder to organize it in

Accepted types: any `image/*` or `video/*` content type. File extensions must match the content type.

After upload, the file is scanned for malware, then available immediately via CDN.

## Folders

Folders are created implicitly -- upload a file to a folder name and the folder appears.

Common folder structures:

- `covers/`: album art, item covers
- `blog/`: images for blog posts
- `promo/`: marketing materials

## Using Media in Content

Embed images using markdown syntax:

```markdown
![Alt text](filename.jpg)
```

For files in subfolders:

```markdown
![Alt text](blog/header.jpg)
```

The dashboard provides copy buttons for both the CDN URL (for external use) and the markdown reference (for item bodies and blog posts).

## Storage and Tier Limits

Media uploads count toward your tier's total storage quota. Video uploads require the Big Files tier or above. See [Pricing Tiers](./tiers.md) for limits. Oversized files are rejected at upload time.

## Deleting Media

Delete files from the Media tab to free storage quota. If the file is still referenced in content, the markdown reference will show a broken image.

## See Also

- [Content & Items](./02-content.md): Writing item descriptions
- [Blog](./blog.md): Blog posts with embedded media
- [Pricing Tiers](./tiers.md): Storage limits per tier
- [Dynamic Clips](./dynamic-clips.md): Reusable audio clips for pre/mid/post-roll