> ## Documentation Index
> Fetch the complete documentation index at: https://help.pixwel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ingests

> How source media gets into Pixwel — uploading a file, watching it process and auto-match to a project and asset, and tracking it to a finished file.

**Ingesting** is how source media enters Pixwel. When you upload a master — a ProRes video, an image, a document — Pixwel creates an **ingest** that uploads the file, reads its metadata, matches it to the right [project and asset](/features/projects/overview), and turns it into a platform [file](/features/projects/files) (and any encodes). If the upload relates to an order, the ingest is linked back to that [work request](/features/work-requests).

## The Ingests page

The Ingests page lists everything being brought into the platform, newest first, so you can watch progress and spot anything that needs attention.

<Frame caption="The Ingests list — each row is one uploaded file, with its project, asset, owner, linked work request, and status.">
  <img src="https://mintcdn.com/pixwel/LCc2un8fWfvdWtLT/img/ingests.png?fit=max&auto=format&n=LCc2un8fWfvdWtLT&q=85&s=fcac0da6033056cbcbe670cad6d359b8" alt="The Pixwel Ingests page showing a table of uploaded files with status SUCCEEDED" width="2520" height="1506" data-path="img/ingests.png" />
</Frame>

Each row is one uploaded file:

| Column       | What it shows                                                                                                                                                         |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Filename** | The original name of the uploaded file.                                                                                                                               |
| **Project**  | The project it was matched to.                                                                                                                                        |
| **Asset**    | The asset it was matched to.                                                                                                                                          |
| **Owner**    | The person who uploaded it.                                                                                                                                           |
| **WR**       | The linked [work request](/features/work-requests) — shown as its tag (for example `AUTO`, `DATE`, `Banderole`, `Now`), or *None* if the file isn't tied to an order. |
| **Uploaded** | When it was uploaded.                                                                                                                                                 |
| **Size**     | The file size.                                                                                                                                                        |
| **Status**   | Where it is in processing (see below).                                                                                                                                |

You can narrow the list with the filters along the top — **Active**, **Owner**, **Status**, **Project**, **Asset**, **Language**, and **Existing Work Request** (has one or not) — **search by filename**, and choose how many rows to show.

## Statuses

An ingest moves through a sequence of statuses from upload to finished file:

| Status         | Meaning                                                                            |
| -------------- | ---------------------------------------------------------------------------------- |
| **Created**    | The ingest exists and is waiting for the file upload.                              |
| **Uploading**  | The file is uploading.                                                             |
| **Uploaded**   | Upload finished; preparing to process.                                             |
| **Submitted**  | Handed off for processing.                                                         |
| **Processing** | Pixwel is reading metadata and producing the file.                                 |
| **Waiting**    | Paused for your input — usually to confirm the matched project, asset, or details. |
| **Verified**   | Your input is in; processing resumes.                                              |
| **Succeeded**  | Done — the file is in the platform.                                                |
| **Failed**     | Processing couldn't complete.                                                      |

<Note>
  A **Waiting** ingest needs you. Open it, confirm or correct what Pixwel matched, and it will continue.
</Note>

## How files are matched

Pixwel reads the **filename** to figure out where a file belongs. A well-formed name encodes the project, asset, language, usage, and any tags — for example:

```
PASSENGER_SOCIAL_EXPLAINER-VERTICAL-30_GRK_SUB_DATE_PRORES_1920p2398.mov
```

From a name like that, Pixwel matches the **project** (by its file prefix), the **asset**, the **language/country**, and the relevant **tags**, and links the file to the matching work request revision. You can also set or correct the project and asset yourself when an ingest is waiting.

<Tip>
  Consistent, correctly-formed filenames are what make auto-matching work. A misnamed file is more likely to land in **Waiting** for manual matching.
</Tip>

## Who can ingest

Bringing files in is permission-controlled: you need the **Ingest Assets** permission (the `ingest` access flag) on your group. See [User roles](/features/user-roles).

## What an ingest produces

When an ingest succeeds it creates the platform **file** — and any **encodes** (transcoded versions) — attached to the matched asset, and links them back to the work request and its tag. In other words, ingesting is how a localized deliverable a vendor produced becomes a real, downloadable file sitting alongside the rest of the asset's versions.