# Assets

Keep your product shots, photos and marks in one library and use them in every design.

**Assets** is your organisation's picture library. Upload a picture once under **Setup** > **Assets**, and it is offered in the editor's picture chooser for every design.

> **Before you start:**
>
> - Editors and owners can upload, rename and delete assets. Reviewers and viewers can look at them.
> - Assets are kept with your organisation's other files and count towards its cloud storage. See [Library](https://withmestra.com/docs/concepts/library/).

## Add pictures

1. In the web app, open **Setup** > **Assets**.
2. Under **Add pictures**, drop PNG, JPEG or SVG files, or choose them. You can drop several at once. They go up one after another, each with its own line: **Uploading…**, then it joins the grid.
3. Each file is named after its file name, without the extension, up to 200 characters.

A picture is known by its content. If your organisation already holds the same picture, the line says "Already in your assets as <name>." and nothing is added twice. The existing one keeps its name.

Dismiss a finished line with the **X** next to it.

## Look, rename and delete

- Select a picture's thumbnail to see it large in a lightbox. Use **Previous picture** and **Next picture** to step through them. Each shows its width and height in px and its kind: **PNG**, **JPEG** or **SVG**.
- Select the picture's **Actions** menu, then **Rename**. The name is what the editor's picture chooser calls the picture. A name is 1 to 200 characters.
- Select **Actions** > **Delete**, then confirm "Delete <name>?". It leaves your assets. Designs that already use the picture keep it: deleting an asset doesn't change any design, master or size that was built with it.
- A long library loads in pages. Select **Show more** for the next page. If that fails, it says "Couldn't load more. Try again."

An empty library says "No assets yet". An editor sees "Add your product shots, photos and marks here once, and use them in every design." A viewer sees "An editor or owner can add pictures here for every design to use."

## Use an asset in a design

In the editor, select a picture (or add a picture element) and choose **Replace** or **Choose a picture**. The chooser lists **Assets** first, with each picture's name. Select one to use it. The chooser also lists **In this run** and **Your pictures**. Select **Manage assets** to open the Assets page beside the editor without leaving it.

You can also paste or drop images straight onto the canvas. On a master, a pasted image adds a picture, and several dropped files each become a picture. In a size, a pasted image replaces the selected picture. See [Add pictures](https://withmestra.com/docs/how-to/edit-in-the-browser/#add-pictures).

An asset larger than a size can use is drawn smaller for that size, so a big product shot still goes into a small banner.

**SVGs can be used on masters only.** A size takes PNG or JPEG pictures.

## Limits and errors

| Limit                             | Value                                        |
| --------------------------------- | -------------------------------------------- |
| File types                        | PNG, JPEG and SVG                            |
| Largest file in the library       | 25 MB                                        |
| Largest picture a master can draw | 15 MB. Use a smaller or more compressed file |
| Width or height of a picture      | 1 to 100,000 px                              |
| Length of a name                  | 1 to 200 characters                          |
| Pictures one run holds            | 200                                          |

| You see                                                                                         | What to do                                                                                                                                                                                                                   |
| ----------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| "Use a PNG, JPEG or SVG picture." (Assets and masters) or "Use a PNG or JPEG picture." (a size) | Convert the file to a supported type.                                                                                                                                                                                        |
| "That picture is over 25 MB."                                                                   | Compress or shrink the file, then upload again.                                                                                                                                                                              |
| "That picture is over 15 MB, the most a master can draw. Use a smaller or more compressed one." | Use a smaller file on the master. It can still stay in your assets.                                                                                                                                                          |
| "A size takes PNG or JPEG pictures. An SVG can go into the master."                             | Put the SVG on the master, or use a PNG or JPEG in the size.                                                                                                                                                                 |
| "That SVG has no size to place it at. Save it again from a file with a viewBox."                | Export the SVG again with a `viewBox`.                                                                                                                                                                                       |
| "That picture is empty."                                                                        | Choose a file that has content.                                                                                                                                                                                              |
| "That picture's size isn't valid."                                                              | Use a picture with a width and height.                                                                                                                                                                                       |
| "That picture didn't arrive whole. Try again." or "That picture couldn't be sent. Try again."   | Upload it again.                                                                                                                                                                                                             |
| "That picture is no longer in your assets."                                                     | Someone deleted it. Choose another or upload it again.                                                                                                                                                                       |
| "That picture is larger than this run can use."                                                 | Use a smaller picture.                                                                                                                                                                                                       |
| "This run already holds 200 pictures."                                                          | Remove some pictures from the run first.                                                                                                                                                                                     |
| "Pictures can't be added while the library is off."                                             | Your organisation's files aren't being kept, so pictures can't be stored. See [Support](https://withmestra.com/docs/support/).                                                                                               |
| "Pictures can't be added right now. Try again in a moment."                                     | Wait a moment and try again.                                                                                                                                                                                                 |
| "This editing session has ended. Reopen the size." (or master)                                  | Reopen it from its run or master.                                                                                                                                                                                            |
| Upload or rename refused because your organisation is read-only                                 | Uploads and renames are refused while the organisation is read-only, as logo uploads are. An owner needs to bring the plan out of read-only. See [Plans and billing](https://withmestra.com/docs/how-to/plans-and-billing/). |
| "Couldn't load your assets"                                                                     | Select **Try again**, or reload.                                                                                                                                                                                             |

## What's next

- [Edit a size or master in the browser](https://withmestra.com/docs/how-to/edit-in-the-browser/)
- [Start a design in Mestra](https://withmestra.com/docs/how-to/start-a-design/)
