# Masters in the web app

See your saved masters, upload a PDF as a master, check the import, compare versions and run a master from the web app.

A master is the design every size is built from. You save one from InDesign, Figma or Canva, start one in the web app's editor, or upload a PDF. The **Masters** page lists them all.

> **Before you start:**
>
> - Editors and owners can upload, run, edit and delete masters. Reviewers can look.
> - You need at least one brand to upload a PDF. See [Set up a brand](https://withmestra.com/docs/how-to/set-up-a-brand/).

## The Masters page

Open **Masters** under **Work** in the sidebar. Each row shows the master's thumbnail, name, brand, the app it came from (**InDesign**, **Figma**, **Canva**, **Upload** or **Mestra**), who saved it and when, and how many runs it has made.

Each master has a status:

- **Ready.** Sizes can be built from it.
- **Not ready.** Something needs fixing first. Open the master and read **To fix**.
- **Checking.** Mestra is checking it. The page updates by itself.

A **Ready** master shows **Run** in its row. See [Run a master from the web](#run-a-master-from-the-web).

An empty page says "Save a master from InDesign, Figma or Canva, or start one in the editor." See [Save and update masters from your design app](https://withmestra.com/docs/how-to/save-and-update-masters/) and [Start a design in Mestra](https://withmestra.com/docs/how-to/start-a-design/).

## Open a master

Select a master to open it. The page shows:

- A **Ready** master's **Notes**, or a **Not ready** master's **To fix**, if there are any.
- **Versions**, once the master has two or more.
- **Runs**: the runs made from the master. A new master says "Nothing has been made with this master yet. Run it to make its sizes."
- The master as it was saved.

The buttons at the top are **Run**, **Edit** (see [Edit a size or master in the browser](https://withmestra.com/docs/how-to/edit-in-the-browser/)) and, for a master that came from a PDF, **Upload new version**. **More actions** > **Delete** removes the master.

### Delete a master

Select **More actions** > **Delete**, then confirm. Runs already made keep their files but can't be changed in review. Queued or running runs of the master fail.

## Versions and Compare versions

Every save makes a new version. Earlier versions stay. New runs use the latest, and a run keeps the version it was made from.

Each row in **Versions** shows the version, a **Current** tag on the latest, who saved it and from which app, and how many runs used it. **Edit this version** opens that version in the editor. Saving it makes the next version.

To see what changed, select **Compare with** on a version. **Compare versions** lists the changes in words, then shows the two versions:

- **From** and **To** pick the two versions.
- **Side by side**, **Wipe** and **Overlay** are three ways to look at them.

If a master has only one version, it says "This master has only one version."

## Run a master from the web

You can build a master's sizes without a design app.

1. Open a **Ready** master and select **Run**.
2. In **Run** *name*, choose the **Campaign**, or **No campaign** to pick any brands and sizes, including sizes you type. See [Run without a campaign](https://withmestra.com/docs/how-to/run-a-campaign/#run-without-a-campaign).
3. Choose the brands and sizes. Until you do, it says "Choose a brand and a size." A size that can't be made for a brand is greyed out, with the reason.
4. Check the summary line, then select **Run**.

The dialog follows the run. Select **Cancel run** to stop it. **Minimise** keeps the run in view while you work elsewhere. When it is done, the run is on the **Runs** page. See [Run a campaign](https://withmestra.com/docs/how-to/run-a-campaign/).

## Upload a PDF as a master

A PDF with live text and vector shapes can become a master. That is the kind to export from your design app: the text stays text, so Mestra can re-set it for each size.

A page with no live text can be uploaded too, and **Check the import** says what you get:

- A page that is one flat picture comes in as a picture. Nothing on it can be edited or rearranged, so it only suits sizes close to its own shape. For any other shape the picture is cropped to fit, and that size is marked to check.
- A page whose lettering is drawn as outlines comes in with its pictures and shapes, and the lettering stays a picture.
- A layered Photoshop PDF keeps its type. Lettering in one flat colour comes in as live text in that colour. Lettering filled with a photo or a gradient is kept as a picture.

1. On **Masters**, select **Upload a PDF**.
2. Choose the **Brand**.
3. Drop the PDF where it says "Drop a PDF here", or choose one. There is a size limit, and the dialog says if the file is over it.
4. If the PDF has more than one page, choose the page, or enter a **Page number** and select **Use this page**.
5. Wait while it reads the PDF. When it is read, Mestra opens **Check the import**.

To add a new version to a master that came from a PDF, open it and select **Upload new version**. It keeps the master's brand.

If the PDF can't be read, the dialog says why:

| You see                                                                                                     | What to do                                                                       |
| ----------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| "This page is empty, so there is nothing to import. Choose another page, or upload a different PDF."        | Choose a page that has something on it.                                          |
| "This PDF is password-protected."                                                                           | Remove the password and upload it again.                                         |
| "This PDF has too many items to import.", "This page is too large." or "This PDF is too complex to import." | Simplify the page, or choose a smaller one.                                      |
| "Your cloud storage is full. Free some space, then upload again."                                           | Free some storage. See [Library](https://withmestra.com/docs/concepts/library/). |
| "The page reader is busy. Try again in a minute." or "Reading took too long. Try again."                    | Select **Try again**.                                                            |

## Check the import

**Check the import** opens on a larger screen. On a phone it says "Open this on a larger screen to check the import."

The page shows the PDF with a box on each item Mestra found. Use the **PDF** and **Our render** tabs to compare the PDF with Mestra's drawing of it. Select an item on the page to see its **Kind**, its **Role** and, for text, each paragraph's **Text** and **Leading**.

The **To check** card lists what needs your eye. Each item is **Open** or **Done**.

Some items are notes about the page, with nothing to fix. "This page is a flat picture: it has no live text or shapes, so nothing on it can be edited or rearranged. It is imported as a picture, which only suits sizes close to its own shape." and "Lettering filled with a picture was kept as a picture; it is not editable text" are two of them. Select **Confirm** when you have read one.

- **Fix** selects the item so you can change it. Change its **Role**, its **Leading**, or pick a **Brand font** for a font the brand doesn't have. If the font you want isn't in the list, type its name in **Other included font** and select **Add**. "That font isn't included." means Mestra doesn't carry it. See [Set up a brand](https://withmestra.com/docs/how-to/set-up-a-brand/#fonts).
- **Confirm** accepts what Mestra read, as it is.
- For text whose capitals are in doubt, **Yes** sets it to all caps and **No** keeps it.
- For a logo, **Use full logo box** takes the whole box as the logo.

Give the master a name in the name box. The bar at the bottom says "N to check" until every item is done, then "Ready to save". Select **Save master**. It then opens the master.

## When a master is Not ready on a difference

If Mestra's drawing of a master doesn't match the design, the master is **Not ready**. Its page shows a card titled with how different it is, as "N% different". It shows the PDF (or **Design**), **Our render** and the **Difference**. If you are happy with how it looks, an editor selects **Accept**. If not, fix the design and save it again.

## What's next

- [Save and update masters from your design app](https://withmestra.com/docs/how-to/save-and-update-masters/)
- [Edit a size or master in the browser](https://withmestra.com/docs/how-to/edit-in-the-browser/)
- [Campaign rules and brand approval](https://withmestra.com/docs/how-to/campaign-rules/)
