> For the complete documentation index, see [llms.txt](https://docs.optis.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.optis.me/product-options/advanced-setup/other-popular-features/product-personalizer-live-mockup-settings.md).

# Product Personalizer - Live Mockup Settings

## What is Product Personalizer/Live Mockup? <a href="#id-1-what-is-it" id="id-1-what-is-it"></a>

Live Mockup allows shoppers to see their customizations applied to the product **in real time** before adding it to the cart. As customers select options (text, images, colors, buttons, swatches, etc.), the product preview updates instantly, showing exactly how the final product will look.

## What Live Mockup Can Do <a href="#id-1-what-live-preview-can-do" id="id-1-what-live-preview-can-do"></a>

Live Mockup works seamlessly with your product options and variants to:

* Instantly reflect option changes on the product image
* Display text inputs, uploads, or selections directly on the product
* Update visuals without page reloads
* Support multiple option types: [Text box](https://help.optis.me/en/article/create-a-textbox-xq9qlw/), [File upload](https://help.optis.me/en/article/create-a-file-upload-1bdv45s/), [Image & Color Swatch](https://help.optis.me/en/article/create-a-swatch-4cklgo/) (Note: **Text box’s live mockup** can be combined with [Color picker](https://help.optis.me/en/article/create-a-color-picker-ovw276/), [Color Swatch](https://help.optis.me/en/article/create-a-swatch-4cklgo/), Font Picker (coming soon) to preview text color and styling in real time).

Customers can interact with options and immediately see the result — no guessing, no surprises.

**👉 View demo:** [Personalize Phone Case](https://optis-product-options-variant.myshopify.com/products/custom-phone-case), [Custom Tote Bag](https://optis-product-options-variant.myshopify.com/products/custom-tote-bag?variant=51026051793174), [Custom Pet Necklace](https://optis-product-options-variant.myshopify.com/products/custom-pet-necklace?variant=51026045436182)

## When to Use Live Mockup <a href="#id-1-when-to-use-live-preview" id="id-1-when-to-use-live-preview"></a>

If customers need to *see it to trust it*, Live Mockup is the right solution 🤩.

| **Use cases**                             | **Typical examples**                                                                    | **Why Live Mockup matters**                                                        |
| ----------------------------------------- | --------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| **Personalized products**                 | Engraved names or messages.- Custom text on apparel, mugs, phone cases                  | Customers see exactly how their custom requests look on the product before buying. |
| **Visual option differences**             | Color or material selection- Pattern or style changes                                   | Instantly updates the product image, making comparisons easy and intuitive         |
| **Print-on-demand & custom designs**      | Uploading personal logos or images- Choosing print positions- Previewing artwork layout | Helps customers confirm design placement before checkout, reducing order errors    |
| **Paid add-ons & upgrades**               | Gift wrapping styles- Extra decorations or finishes- Paid engraving or personalization  | Visualizing upgrades makes added costs easier to justify                           |
| **Made-to-order or non-returnable items** | Personalized or custom-built products                                                   | Visual confirmation is critical when products can’t be resold or returned          |

**Result:** Shoppers feel confident in their choices, while merchants benefit from higher conversions, fewer errors, and reduced support requests.

## How To Set Up <a href="#id-1-how-to-set-up" id="id-1-how-to-set-up"></a>

### A. Explaining the setting panels <a href="#id-2-a-explaining-the-setting-panels" id="id-2-a-explaining-the-setting-panels"></a>

1. Live Mockup tab

For options that support Live Preview (Text box, File Upload, Swatch), you’ll see a **Live mockup** tab located at the top right.

* What it does: The **Live mockup** tab controls how the option appears in the live preview on your product page.
* How it works with Option Content tab: The Product personalizer uses values from Option Content, so we recommend setting those up first.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FIrntsWtlGbanhuM76DE2%2F1.png?alt=media&amp;token=fe484b21-a526-443d-afd7-19554234e6c6" alt=""><figcaption></figcaption></figure>

2. Preview panel: **Select background**&#x20;

When Live Mockup is enabled, start by selecting the Background first.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Ff8mE9bQs3LOE72EuNMQO%2F2.png?alt=media&amp;token=c6da7764-f950-4971-b905-7891945732cd" alt=""><figcaption></figcaption></figure>

**Select background**

![](https://storage.crisp.chat/users/helpdesk/website/-/2/2/4/2/22429817467a0000/image_bbmbw0.png)

**Preview**\
After choosing a background, decide where the preview should appear:

| **All product images (default)** | The preview appears on all product images. When customers switch between images, the preview remains visible on each image.                                                                                                    |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **First product image only**     | The preview appears only on the first product image. If customers switch to another image, the live preview will no longer be shown.                                                                                           |
| **Variant image only**           | The preview appears only on the selected variant’s image. When customers change variants, the background updates to the corresponding variant image, and the preview is shown on that image instead of the main product image. |
| **Last product image only**      | The preview appears only on the last image in the product’s media list.                                                                                                                                                        |
| **Specific product image**       | The preview appears only on a specific product image, based on its position in the product’s media list. Enter the image order number to select which image the preview should appear on.                                      |

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fhl1cYYIUbg04EpGEA0mg%2F3.png?alt=media&amp;token=8bcc4149-b8f4-479b-8794-bf6546f4f2dc" alt=""><figcaption></figcaption></figure>

**Note:** The preview may look smaller during setup. Use **Zoom In** to check details. The final preview on your live store will display as expected.

![](https://storage.crisp.chat/users/helpdesk/website/-/2/2/4/2/22429817467a0000/image_4f6glb.png)

### How to set up the Product Personalizer (Live Mockup) <a href="#id-2-how-to-set-up-the-product-personalizer-live-preview" id="id-2-how-to-set-up-the-product-personalizer-live-preview"></a>

1. Decide which options need Live Preview (whether it is Text box / Swatch / File upload)
2. Set up the option settings first
3. Enable Live Preview in the **Live mockup** tab
4. Select background & preview options
5. Configure the Live Preview → Save → Choose product/customer condition for the option set

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FaGejXbcLuWwEZldcPAZe%2F1.png?alt=media&amp;token=ec40deb0-c0ca-4c0e-ac9e-0a209c2b61f0" alt=""><figcaption></figcaption></figure>

**Configurations explanations:**

* **Font, Color, Size, Opacity, Curve, X-axis, Y-axis, Rotation:** Default settings used in the preview and will be applied to the final product
* **Allow customer to Change position / Change size:** You can choose whether customers are allowed to: Change preview content’s position or/and size. Disable these options to lock the design.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FKkuSL5StWc7OAF3roz4d%2F2.png?alt=media&amp;token=8988ec99-64cb-4141-8a56-d48bada5db2e" alt=""><figcaption></figcaption></figure>

**Text box**

* **Default text for preview:** The default text shown in the preview. If a Default value is set in Basic settings, it will be used automatically. If not, enter a sample value here (for example: “Add text”). Changes here affect preview only and won’t sync back to Basic settings.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fj3gWxs8n58muH9LSHnuc%2F3.png?alt=media&amp;token=b93e7fed-a34e-4d1f-8c96-b42e81413ff8" alt=""><figcaption></figcaption></figure>

* **Linked with other options - Swatch** (applicable for Color Swatch only): Use when you want to allow customers to select predefined colors for the text.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fx2bi9PE6RG3X12TvRQb4%2F4.png?alt=media&amp;token=1d0233d0-aa09-4953-86f7-9303ae0ef8b6" alt=""><figcaption></figcaption></figure>

* **Linked with other options - Color picker**: Use when you want to allow customers to select their preferred color for the text.

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2Fixvm4qVunXWTQBnJG0FL%2F5.png?alt=media&amp;token=89c7ba61-81f1-4913-8066-878564609998" alt=""><figcaption></figcaption></figure>

**File upload & Swatch**

* **Preview shape**: Choose a basic shape or upload a custom PNG mask

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FXy8wENmSZvldR8tFdKWk%2FScreenshot.png?alt=media&amp;token=664de551-932d-4bbe-a364-8ca43897163d" alt=""><figcaption></figcaption></figure>

**Swatch**

<figure><img src="https://1821185975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRFiuDpHWm2HwzxPH4lfM%2Fuploads%2FTIt4qdSWIQG58lYrFFRO%2F7.png?alt=media&amp;token=758cd5b0-ffc4-4792-9411-0c8f7dfdf760" alt=""><figcaption></figcaption></figure>

![](https://storage.crisp.chat/users/helpdesk/website/-/2/2/4/2/22429817467a0000/image_1kfumh7.png)
