Image Placeholder is a fixed image layer on the product: a frame, a mockup, a logo, a mask. Shoppers cannot change it, but it can be colorized by a connected color option and shown or hidden by conditions.

Add it in the product editor (Product Options → Customize → Add option) and click its row to open the settings panel: Basic (label, required, charge, type settings), Personalizer (how it is drawn on the preview) and Advanced (tooltip, field heading, hide from cart, custom cart label, conditional logic). The settings every option shares are in Option settings every type shares; this page covers what is specific to this type.

Static elements have no input. Their label is admin-only — it names the row in your Options list and is never shown to shoppers or saved on the order.

Settings (Personalizer tab)

  • Image (upload or pick from Assets), Crop, Layer Top or Bottom of the product image, Grayscale.
  • Type: Dynamic — a normal visible layer; Mask only — the image is a shape through which connected uploads show (a photo inside a heart); Watermark — on the preview but not on the print file when Hide background in order image is on; No preview — kept in the list, not drawn.
  • Connect it to a Color Choices or Color Picker option to let shoppers colorize it (listed under that option’s Image fields).

Typical use

One placeholder per variant with a condition on Variant title, over a Blank Canvas background — the way to show variant mockups when a product has several views: Preview images per variant.

More questions from support

Answers our team gave to merchants who read this article and still had a question. Each is a real case, with the store details removed.

How do I show extra images in the preview without creating another view?

Image Placeholders are fixed image layers that appear on the preview without requiring a separate view or new personalization option. Add an Image Placeholder element in the product editor, upload the image you want to display, and use conditional logic to show it only when specific options are selected. This keeps your product focused on personalization while displaying additional mockups or reference images.

Why is the uploaded image showing outside the phone mockup shape?

The mockup PNG is transparent in the wrong places. The area around the phone shape must be opaque (filled) so it hides the uploaded image, while only the phone screen area stays transparent to show the upload through. Prepare the PNG so it is filled everywhere except where the image should show, then re-upload it to the image placeholder. If you have multiple phone models, add conditional logic so each mockup image placeholder shows only when that model is selected via a Button or Radio option.