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

# Mockups

> What a mockup is, where your product photos live, and how they get into a design template.

A **mockup** is a photo of the blank product you sell, prepared so Customei knows how to lay artwork onto it. The photo is only half of it. A finished mockup also carries:

* a **design area**, the patch of the photo where artwork belongs,
* a **surface shape**, how that patch curves, so print follows the product instead of lying flat on it,
* optional **clip masks**, edges that hide artwork where the product bends out of view.

Do that work once per product photo and every template you ever build can borrow it.

## Where mockups live

Mockups are assets, so they sit with your other reusable material under **Assets**. Open the **Mockup** tab to see just the mockup ones.

<Frame caption="Assets, filtered to mockup libraries.">
  <img src="https://mintcdn.com/nexlify/0N0REbKbYlg6O2HE/images/mockups/mockup-libraries.png?fit=max&auto=format&n=0N0REbKbYlg6O2HE&q=85&s=5574165dbbac188bfe6907c2a049943a" alt="The Assets page with the Mockup tab highlighted, listing mockup libraries with their thumbnails, item counts, reference counts, and last-modified dates." width="3840" height="2400" data-path="images/mockups/mockup-libraries.png" />
</Frame>

Mockups are kept in **libraries**, and a library is simply a named group of them. Keep one per product family and you'll find things later: *Mugs*, *Unisex tees*, *Framed canvas*.

Each row tells you:

| Column            | What it means                                        |
| ----------------- | ---------------------------------------------------- |
| **Media**         | A stack of thumbnails from inside the library        |
| **Name**          | The library's name                                   |
| **Content**       | How many mockups it holds                            |
| **References**    | How many design templates use it, or a dash for none |
| **Last modified** | When anything in it last changed                     |

## Inside a library

Click a library to see the individual mockups.

<Frame caption="One mockup library. The banner tells you which design templates rely on it.">
  <img src="https://mintcdn.com/nexlify/0N0REbKbYlg6O2HE/images/mockups/library-detail.png?fit=max&auto=format&n=0N0REbKbYlg6O2HE&q=85&s=3f536b4b8d2fc9ca41c0968ba3d5592a" alt="The item table inside a mockup library, listing three mockups with columns for position, preview, name, option ID, type marked 2D, and last modified." width="1956" height="830" data-path="images/mockups/library-detail.png" />
</Frame>

| Column            | What it means                                               |
| ----------------- | ----------------------------------------------------------- |
| **Position**      | The order they appear in. Drag the handle to change it.     |
| **Preview**       | The product photo                                           |
| **Name**          | The mockup's name                                           |
| **Option ID**     | The number an option set uses to point at this exact mockup |
| **Type**          | `2D` for a product photo, `3D` for a model                  |
| **Last modified** | When it last changed                                        |

The banner at the top is worth reading before you change anything: it counts the design templates using this library, and **View** opens one so you can see where these photos actually land.

<Warning>
  Editing a mockup changes it everywhere. If three templates use the same shirt photo and you move its print area, all three previews move. That's usually the point, but check the banner first so you know what you're affecting.
</Warning>

## Adding mockups

<Frame caption="Three ways to get product photos into a library.">
  <img src="https://mintcdn.com/nexlify/0N0REbKbYlg6O2HE/images/mockups/add-mockup-actions.png?fit=max&auto=format&n=0N0REbKbYlg6O2HE&q=85&s=c600d916190db5e2ee62ca374a97d803" alt="The mockup library header with the Add mockup, Import PSD and Import buttons highlighted, next to a Delete button." width="1366" height="380" data-path="images/mockups/add-mockup-actions.png" />
</Frame>

| Action         | What it's for                                         |
| -------------- | ----------------------------------------------------- |
| **Add mockup** | Upload product photos from your computer              |
| **Import PSD** | Upload a Photoshop mockup file and keep its structure |
| **Import**     | Bring in a prepared set of mockups in one go          |

A freshly uploaded photo has no print area yet, so artwork will fill the whole frame until you mark one out. Open the mockup and draw it: see [The mockup designer](/mockups/mockup-designer).

<Tip>
  Shoot or source photos of the *blank* product, evenly lit, with the print area facing the camera as squarely as you can manage. A photo taken at a sharp angle can be warped into shape, but a straight-on one takes minutes instead.
</Tip>

## How a mockup reaches a customer

Mockups aren't attached to products directly. They travel with your artwork:

<Steps>
  <Step title="You prepare the mockup once">
    In Assets, with its print area and surface shape set.
  </Step>

  <Step title="You add it to a design template">
    In the editor it becomes a **Design Preview** frame beside your artwork. See [Add a mockup preview](/editor/add-a-mockup).
  </Step>

  <Step title="Your shopper sees it on the product page">
    As they fill in the options, the preview updates with their choices on the real product.
  </Step>
</Steps>

## Where to next

<CardGroup cols={2}>
  <Card title="The mockup designer" icon="pen-nib" href="/mockups/mockup-designer">
    Mark out where artwork goes on a photo.
  </Card>

  <Card title="Warp and realism" icon="wand-magic-sparkles" href="/mockups/warp-and-realism">
    Make print follow the shape of the product.
  </Card>

  <Card title="Add a mockup preview" icon="image" href="/editor/add-a-mockup">
    Use a mockup in a design template.
  </Card>

  <Card title="The design and preview frames" icon="clone" href="/editor/design-and-preview-frames">
    How the editor's two canvases work.
  </Card>
</CardGroup>
