> ## 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.

# Pictures and photos

> Add a fixed picture, a picture that changes with the customer's choice, or a free stock photo.

There are two kinds of picture you can put on a template, and picking the right one at the start saves a lot of rework.

* An **Image** is one picture that stays put. Your logo, a frame, a decorative flourish.
* A **Dynamic Image** is a slot that swaps between several pictures. It is what you use when the customer picks a hair style, a skin tone, or a shirt colour and the artwork has to change to match.

Both live at the top of the **Elements** tab, the first icon on the left rail.

<Frame caption="Dynamic Image and Image sit near the top of the Elements list.">
  <img src="https://mintcdn.com/nexlify/jObu3-blJWj5gxav/images/editor/elements-images.png?fit=max&auto=format&n=jObu3-blJWj5gxav&q=85&s=336bc2dae50b59c5bcf63f5cbe49acc9" alt="The Elements panel in the template editor with the Dynamic Image and Image entries highlighted in the list, alongside Text, Crossword, Word Search, QR Code, and other elements." width="3840" height="2400" data-path="images/editor/elements-images.png" />
</Frame>

Click either one to drop it on the canvas, then drag and resize it like any other layer.

## Free stock photos

The second icon on the rail opens **Photos**, a library of free stock photography you can use straight away. Type what you want into the search box, or scroll the trending shots.

<Frame caption="Search the built-in photo library, then click a photo to place it on the canvas.">
  <img src="https://mintcdn.com/nexlify/jObu3-blJWj5gxav/images/editor/photos-panel.png?fit=max&auto=format&n=jObu3-blJWj5gxav&q=85&s=3b703610f02af120a2ff537006d575e7" alt="The Photos panel in the editor showing a highlighted Search photos box above a grid of trending photographs with photographer credits underneath." width="3840" height="2400" data-path="images/editor/photos-panel.png" />
</Frame>

Clicking a photo places it on the canvas as a picture layer. It is a fast way to mock up a design before your own artwork is ready.

## Setting up a Dynamic Image

Select a dynamic picture layer and the right-hand panel fills with everything about it.

<Frame caption="A dynamic picture layer: the Asset it points at, the pictures inside it, and each one's Option ID.">
  <img src="https://mintcdn.com/nexlify/jObu3-blJWj5gxav/images/editor/image-layer-settings.png?fit=max&auto=format&n=jObu3-blJWj5gxav&q=85&s=898249aa555cbf321e07c1e6ca44a5ae" alt="The editor with layer number 13, Short Hair, selected. The right panel shows Image Options with an Asset picker set to Short Hair, five picture choices each labelled Option ID one to five, then Customer permissions, Use as Mask, and Transform settings." width="3840" height="2400" data-path="images/editor/image-layer-settings.png" />
</Frame>

**Asset** is the set of pictures this layer can show. Pick one and every picture inside it appears below.

Each picture carries an **Option ID**: a plain number, 1, 2, 3. That number is the bridge to your option set. When a customer picks the second hair style, the option set asks for Option ID 2 and this layer draws that picture. Keep those numbers stable, because renumbering them quietly changes what each customer choice produces.

<Tip>
  Two layers can point at the same asset. Give both the same layer number and a single customer choice will change both figures at once, which is how a two-person design keeps the couple's outfits in step.
</Tip>

## Letting the customer move the picture

Under **Customer permissions** there is one toggle, **Allow customer to edit**. On a picture layer it does not mean the shopper may swap the photo. It means they may nudge and rotate the picture inside its frame. See [What customers can change](/editor/customer-permissions) for how that pairs with photo uploads.

**Use as Mask** turns the layer into a cut-out for the layer beneath it, so a photo shows only through this shape. A heart-shaped photo slot is a mask over a picture, not a heart-shaped picture.

## Position, size, and flip

The **Transform** section gives you exact numbers rather than dragging by eye:

| Field          | What it sets                                           |
| -------------- | ------------------------------------------------------ |
| Position X / Y | Where the layer's corner sits on the canvas, in pixels |
| Size W / H     | How wide and tall it is, in pixels                     |
| Rotation       | The angle, in degrees                                  |
| Opacity        | How see-through it is, as a percentage                 |

With a single picture layer selected, two extra buttons join the bar under the canvas: **Flip horizontal** and **Flip vertical**. Flipping is the usual trick for making two figures face each other rather than both facing the same way.

<Warning>
  The editor has no crop tool and no background remover. Prepare artwork the way you want it before you bring it in. Cutting out a shape is done with **Use as Mask**, not by cropping.
</Warning>

## Where to next

<CardGroup cols={2}>
  <Card title="Layers and arranging" icon="layer-group" href="/editor/layers-and-arranging">
    Stack, lock, and rename the pictures you added.
  </Card>

  <Card title="What customers can change" icon="lock-open" href="/editor/customer-permissions">
    Decide who may edit or upload a picture.
  </Card>

  <Card title="Connect an option set" icon="link" href="/optionsets/connect-to-a-template">
    Make a customer choice swap the picture.
  </Card>

  <Card title="Moving around the canvas" icon="up-down-left-right" href="/editor/canvas-and-view">
    Zoom, align, and flip what you just placed.
  </Card>
</CardGroup>
