# Media

> Pictures and videos in an order, each with a caption, for screenshots of a flow or a recording.

**New → Import…** with only pictures and videos makes a Media artifact. They're ordered by filename (`01-sign-in.png`, `02-…`) and captioned from the names.

## View and edit

- See one at a time with a strip beside it, or all of them in a grid.
- Editors add files (pick or drop them), remove, drag to reorder and caption.

## Comment

Comments pin to a spot on a picture. On a video, they pin to a spot in the frame at that moment. A picture replaced under the same name keeps its comments.

## Formats

Pictures: png, jpg, gif, webp, avif, svg. Video: mp4, webm, mov.

## For agents

The order and captions live in `media.json`, with the files in `media/`:

```json
{
  "v": 1,
  "title": "Onboarding",
  "items": [
    { "file": "media/01-sign-in.png", "caption": "Sign in" },
    { "file": "media/02-walkthrough.mp4" }
  ]
}
```

Publish only pictures and videos and Fiddle writes `media.json` for you.
