> For the complete documentation index, see [llms.txt](https://docs.askyazi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.askyazi.com/results-and-reporting/media-library.md).

# Media Library

Review, tag, filter and download every photo, voice note and video from a study in the Media Library.

The **Media Library** holds every photo, voice note and video participants sent in a study, grouped by activity and question. Use it to work through media as a team, pick out the strongest clips, and download files. You find it under **Responses > Media Library**.

{% hint style="info" %}
**In short:**

* Search what people said in their voice notes and videos, and filter by person, question, tag, length or reviewed status.
* Stars, tags and the reviewed mark are shared, so the whole team sees the same progress.
* Downloads cover exactly what you ticked or filtered to, and you choose how files are named.
  {% endhint %}

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FZD6ImSm2Pf7BqTzjIlMM%2Fmedia-library-filters.webp?alt=media&amp;token=88f783aa-3153-4eb2-b279-3538502fe15b" alt="The Media Library toolbar with transcript search, the media type chips, Collections and filters"><figcaption></figcaption></figure>

## What is in the library

Every media answer from every activity in the study, including AI interview clips, sits in one library. Media is grouped by activity and then by the question it answers. A single survey or interview works the same way.

When a participant sends several photos in one answer, each photo gets its own tile and can be tagged and starred on its own.

Open any item to see it in the full-screen viewer: the question and participant above, and the transcription (for voice notes and videos) or the AI image description (for photos) below. **Copy transcript** and **AI summary** are available in the viewer where they apply. Clips show the participant's WhatsApp name, or an ID if the study uses Privacy Protection.

## Find what you need

* **Search** looks through the transcripts of voice notes and videos, so you can find clips by what people said.
* **Type chips**: **All**, **Photos**, **Voice notes**, **Videos**.
* **+ Add filter** offers:
  * **Tag**: clips with a given tag.
  * **Person**: everything one participant sent.
  * **Length**: voice notes and videos by duration.
  * **Reviewed**: just what you have been through, or just what is still to check.
  * **Questions**: media from a particular question, or from people who gave a particular answer to a single or multi-select question. On a multi-activity study, every activity's questions are listed, labelled with the activity name.

## Review as a team

* **Star** the clips worth coming back to.
* **Tag** clips with your own labels. You can set tags up before you start and apply them as you go.
* **Mark as reviewed** when you have been through a clip.

Stars, tags and the reviewed mark are saved for the study, not per person, so two researchers never work through the same 400 voice notes twice.

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2FD7rHDb3yZsadwldW0d3u%2Fmedia-library.webp?alt=media&amp;token=8ca05191-9591-4d32-accf-1a349ae4def7" alt="Responses > Media Library with voice notes grouped by question, two selected, and the Tag, Add to reel and Create reel actions"><figcaption></figcaption></figure>

## Download media

{% stepper %}
{% step %}

### Choose what to download

Tick individual items, or filter the library to exactly what you want (for example **Videos** from one question). The download covers what you ticked, or everything you have filtered to.
{% endstep %}

{% step %}

### Click Download

**Download** sits at the top right, next to **+ Add filter** and **Refresh**.
{% endstep %}

{% step %}

### Choose how files are named

Before the download starts, pick what goes into each file name, for example the question, the participant and the activity. This lets you match files to rows in your Table Data export. Yazi remembers the format you chose for next time.
{% endstep %}
{% endstepper %}

Files arrive as a ZIP. A name might look like `Q1_27821234567.ogg`, or use segment or enrichment columns, such as a participant's age group and the activity name.

On studies with **Privacy Protection** on, file names never contain phone numbers. A stable participant code is used instead, and the same code appears in the Participant ID column of your exports, so photos still line up with rows.

## Get new media

New photos and voice notes appear within seconds. If the page has been open a while, click **Refresh** to pull in anything new while keeping your filters and stars. An empty library shows a **Check for new media** button and says when it last looked.

## Build a reel from the library

Tick voice notes or videos and choose **Create reel** to go straight to putting them in order, or **Add to reel** to add them to a reel you already made. See [Video reels](https://docs.askyazi.com/results-and-reporting/video-reels.md).

## Limits and things to know

* **Media links in exports point back to Yazi.** Spreadsheet exports carry short links (`links.askyazi.co/...`), not the files themselves. If you need to keep media for the long term, download the files themselves as a ZIP. See [Exports](https://docs.askyazi.com/results-and-reporting/exports.md).
* **Image descriptions are AI-generated.** Check them before quoting.
* **Video content is not analysed visually.** Yazi transcribes what is said in a video. It does not analyse facial expressions or what is shown on screen.
* **Very old media.** A small number of older studies may store media in an older location that does not show in the library. Contact support if media you expect is missing.

## Related

* [Video reels](https://docs.askyazi.com/results-and-reporting/video-reels.md)
* [Transcripts](https://docs.askyazi.com/results-and-reporting/transcripts.md)
* [Exports](https://docs.askyazi.com/results-and-reporting/exports.md)
* [Participant privacy](https://docs.askyazi.com/security-and-privacy/participant-privacy.md)
