---
title: Library
description: The Creatives of your organization and the files that they use. Group the files of one ad idea, then use the Creative in a Campaign Plan.
---

The **Library** holds what your organization brings to its ads. An **Asset** is one file: an image or a video. A **Creative** is one ad idea, and it keeps the files of that idea together. Each file of a Creative is a **Variation**, for example the 9:16 video and the square image of the same idea.

A Creative of the Library changes no ad account. It is not the creative that an ad account holds. To put a file into an ad account, [register the Asset](/mcp/tools/bring-your-own-creative).

## The Library page

In the **Browse** tab of the console sidebar, select **Library**. The page has two tabs. Each tab shows its count beside its name. A tab shows no count while the console reads the list.

| Tab | Address | What it shows |
| --- | --- | --- |
| **Creatives** | `/library` | A gallery of the Creatives, with a picture of their Variations, their formats and the day of the last change. |
| **Assets** | `/library/assets` | Each Asset, with its dimensions, its size, and the ad accounts that it is registered to. |

## Creatives

The **Creatives** tab shows a gallery of the Creatives, newest first. A Creative with no name shows **Untitled creative**.

Each card shows:

- Thumbnails of the first Variations of the Creative. A card shows up to three thumbnails, and then a **+** badge with the number of the others. A thumbnail keeps the shape of its Asset. A video shows its length. A Creative with no Variation shows an empty tile.
- The name, and the number of Variations.
- One badge for each format that the Variations have: `9:16`, `4:5`, `1:1`, `1.91:1` or `16:9`. The console computes the format from the width and the height of the Asset of each Variation. An Asset with an unknown size, or with a ratio that is near no format, has no format.
- The day of the last change.

Select a card to open the page of the Creative.

The console reads the thumbnails and the formats of a card when the card comes near the screen. A card shows no format and no thumbnail until the console has read them.

Use the **Search creatives** field to filter the gallery by name. The search runs in the console.

Select **New creative** to create a Creative. The console opens its page. A new Creative has no name and no Variation.

### The page of a Creative

Select the name of a Creative to open its page. The address of the page holds the id of the Creative, so you can send it to a teammate.

- **Name.** Type a name in the field. The console saves the name when you leave the field or press Enter. An empty field removes the name.
- **Variations.** The list shows each Variation: the kind of its file, the name of its Asset, its dimensions, its aspect ratio and, for a video, its length. The aspect ratio comes from the dimensions: a file of 1080×1920 shows `9:16`.
- **Placement.** Each row has a picker for the placement of the Variation, or **No placement**. A placement is a spot where an ad runs, for example a Meta Stories video. The picker lists the placements of the same kind as the file, with the placements of AdCrunch first, by channel, and then your own. The change is saved when you pick.
- **Broken rules.** A placement has rules, for example a ratio of 9:16 or a length of 3 minutes at most. When the file of a Variation breaks a rule of its placement, the row shows a warning icon and the broken rules as text, under **Does not fit this placement**. A rule that the console cannot check, because the file has no known size or length, shows nothing. The warning is advice. It blocks nothing, and you can keep the Variation.
- **The file.** Select the name of an Asset to open its panel. The panel shows the preview of the file and where it is registered.
- **Remove.** Select the **×** of a row to remove that Variation. The Asset stays in the Library.

### Add Variations

Select **Add variations**. The dialog lists the Assets that are ready.

1. Select each Asset that you want in the Creative. Each Asset becomes one Variation.
2. For each selected Asset, the dialog shows a picker with the placements that the file fits. It lists only the placements of the same kind as the file, and only those whose rules the file meets. The picker starts on **No placement**. The console never picks a placement for you. If no placement fits, the dialog says so.
3. To use a file that is not in the Library yet, select **Upload**. When the upload ends, the file shows in the list, already selected.
4. Select **Add**.

An Asset that is in the Creative already shows **In this creative**. You can select it again with a different placement. A Creative holds the same Asset with the same placement one time only, and the dialog shows the refusal if you add it again. One Asset can be in several Creatives. The suggestion is advice: a rule that the console cannot check, because the file has no known size or length, does not remove a placement from the list.

### Delete a Creative

On the page of a Creative, select **Delete**, then confirm. The console deletes the Creative and its Variations. The Assets stay in the Library, and no ad account changes.

A Campaign Plan or a Line Item that uses the Creative no longer shows it.

## Assets

The **Assets** tab is where you upload files and place them in your ad accounts. Select **Upload** to add files. Select the name of a file to open its panel, where you can rename it.

## Use a Creative in a Campaign Plan

A Campaign Plan holds the Creatives that it can use, and each Line Item picks its Creatives from them. See [Creatives of a Campaign Plan](/console/campaign-plans#creatives).

## Agents

An agent reads and writes the Library with the MCP tools: [`library_creative_list`](/mcp/tools/library-creative-list), [`library_creative_get`](/mcp/tools/library-creative-get), [`variation_add`](/mcp/tools/variation-add) and the others. [Bring your own creative](/mcp/tools/bring-your-own-creative) walks the whole job.
