> For the complete documentation index, see [llms.txt](https://help.mimeeq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.mimeeq.com/configurator/options-and-widgets/print-on-demand.md).

# Print on Demand

Let customers put their own logos and images on your products and preview them in 3D and AR. Learn how to set up print areas, prepare files and download designs.

With the Print on Demand widget, your customers can put their own images or designs (like logos, stickers and photos) on all kinds of products. They add and move their images with a simple tool, and can see how their designs look in 3D or in their room with AR. This guide shows you how to get your products ready in Mimeeq for the best results.

***

## How to add a print area to your product

1. Open the product, navigate to the **Options** tab and click **New Option Block**.
2. Select **Print on Demand** as the mode type.
3. Configure the parameters for your print area and save your work.

<table><thead><tr><th width="56.62890625">#</th><th width="222.5">Name</th><th>Description</th></tr></thead><tbody><tr><td>1</td><td><strong>Max Number of Logos</strong></td><td>Controls how many image layers can be added to a print area. Allows customers to layer multiple images.</td></tr><tr><td>2</td><td><strong>Select Material</strong></td><td>Sets the base material texture visible in areas where uploaded images have transparency. Usually set to "transparent" but can be specific materials like "silver" if needed.</td></tr><tr><td>3</td><td><strong>Texture size</strong></td><td>Specify texture sizes for desktop devices. This overrides the default 3D product settings.</td></tr><tr><td>4</td><td><strong>Mobile Texture Size</strong></td><td>Specify texture sizes for mobile devices. This overrides the default 3D product settings.</td></tr><tr><td>5</td><td><strong>AR Texture Size</strong></td><td>Sets texture sizes specifically for Augmented Reality experiences. Helps optimise AR performance and visual fidelity.</td></tr><tr><td>6</td><td><strong>Code</strong></td><td>Unique identifier for the POD option that can be used in various places. For example, in SKU.</td></tr><tr><td>7</td><td><strong>Visibility Code</strong></td><td>Optional field that controls when and where the POD option appears. Used for SKU, pricing or any place allowing dynamic codes.</td></tr><tr><td>8</td><td><strong>Full Screen View</strong></td><td>Toggles whether the POD editor can be viewed in full screen mode. When enabled, adds a full screen icon to the editor interface.</td></tr><tr><td>9</td><td><strong>By default open as</strong></td><td>Defines if the widget opens in an options panel or goes directly to full screen.</td></tr><tr><td>10</td><td><strong>Opaque Background</strong></td><td>Controls whether the background is transparent or opaque. When disabled, texture below remains visible.</td></tr><tr><td>11</td><td><strong>Generate Cropped View</strong></td><td>Creates a single combined image output that merges all layers when you select to <a href="#how-to-download-the-print-files">download POD files</a> from the Media Library, allowing you to use a single file rather than multiple separate image files.</td></tr><tr><td>12</td><td><strong>Print Area</strong></td><td>Upload layers to define the print area. Follow the <a href="#how-to-upload-layers">layer order guide</a> below.</td></tr><tr><td>13</td><td><strong>2D Preview</strong></td><td>After uploading layers to define the print area, a 2D preview of the print area will be displayed here.</td></tr><tr><td>14</td><td><strong>Measurement Type</strong></td><td>Select whether the print area is measured in inches or centimetres.</td></tr><tr><td>15</td><td><strong>Real Width</strong></td><td>Set the <strong>real-life</strong> width of the print area on the product.</td></tr><tr><td>16</td><td><strong>Real Height</strong></td><td>Set the <strong>real-life</strong> height of the print area on the product.</td></tr><tr><td>17</td><td><strong>Required DPI</strong></td><td>Define the print file's resolution in dots per inch. The higher the DPI, the sharper the printed result will be.</td></tr><tr><td>18</td><td><strong>Description</strong></td><td>Provide details or instructions for the widget, displayed below the title <em>(optional)</em>.</td></tr><tr><td>19</td><td><strong>Accepted Formats</strong></td><td>List the file formats that can be uploaded for printing: PNG, JPG, WEBP, SVG, AI, HEIC, EPS or PDF files. File size cannot be larger than 50 MB.</td></tr></tbody></table>

![Print on Demand option block settings on the product Options tab](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FkdK9jy7vDSCpII2FCsaj%2Fhelp-pod-admin-settings_1keeobj.png?alt=media)

### How to upload layers

Upload the print area layers in this order:

1. **Base layer:** the 2D preview image of your product. It guides users and doesn't have to be grey — it can be any design you choose.
2. **Mask layer:** placed on top of the guide image. The mask must be in SVG format and defines the printable area.
3. **Fixed elements (optional):** if you need fixed elements in the design, like non-removable labels, upload them as additional layers above the mask. Leave the **Exclude from texture** option unchecked for these layers, so they remain visible and intact on your product.

Usually, the first two layers are enough.

{% hint style="info" %}
The mask should be an SVG file and it's automatically excluded from the final texture. Your guide image can be a PNG or JPG, and you can choose to include it in the texture or not.
{% endhint %}

![Print Area layers uploaded in order: guide image, SVG mask and optional fixed layers](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FrYwhCyweRiJZv777tSkA%2Fpod-admin-settings-2_1hopk30.png?alt=media)

***

## How to prepare files for Print on Demand

To set up the Print on Demand widget, you need at least two files: a user guide and a mask.

{% stepper %}
{% step %}

### Create a user guide image

If your product is ready in Mimeeq, you can generate an image of the part you'd like to print on. This will be your user guide. Alternatively, prepare this image with any other tool or resources you have. Save it as a PNG or JPG file.

On this image, mark out the print area. Outline it or shade it in — whatever helps your customers see where their design will go.
{% endstep %}

{% step %}

### Prepare a clipping mask

Once you have a 2D preview of your product with the print area, define a mask using an app like Photoshop. The mask tells the widget where designs can be printed. Save it as an SVG file with:

* **The vector object:** once a user uploads an image, it will only be visible in this mask area.
* **Transparency:** uploaded images will not be visible on this part of the mask.

{% hint style="info" %}
Uploaded images are only placed within the mask area. You can clip in multiple areas of the mask, but any part of the image outside the mask is trimmed off. In the example below, the mask has a circle in the centre, meaning the image will not be displayed there. This lets you create any complex mask you need.
{% endhint %}

![Layer example showing the guide image and an SVG mask with a cut-out circle in the centre](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FOmB9h2kOQeVJywDPBofo%2Fpod-article-layers_11jm7rx.png?alt=media)
{% endstep %}

{% step %}

### Map the UV texture

To make sure designs show up correctly in 3D, the mask must match the UV texture of the 3D model. If you need help with 3D models or UV maps, get in touch with us.
{% endstep %}

{% step %}

### Organise your files

We suggest storing these files in the Media Library. For each product, create a "POD" folder within its product folder and upload your files there. This keeps everything tidy and easy to find.
{% endstep %}
{% endstepper %}

***

## How to download the print files

Download the files customers uploaded from the Media Library:

1. Go to the **Media Library**.
2. Choose **Download POD files**.
3. Enter the configuration shortcode.
4. Click **Download Files**.

You receive a ZIP file with all the designs customers added for the product, in their original format.

![Download POD files option in the Media Library](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FpJAbIFBnZIUP8N2YX1dw%2Fpod-article-downlod-files-1_8s5o98.png?alt=media)

![Configuration shortcode field and Download Files button for the ZIP file](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FHxTWPcdWZKztiM2ggeZj%2Fpod-article-downlod-files-2_169nyfj.png?alt=media)

***

## Where to find the shortcode

To download print files, you need a configuration shortcode. Where to find it depends on your setup: the Mimeeq Basket or a Shopify integration.

{% tabs %}
{% tab title="Mimeeq Basket" %}

1. Go to the **Business Panel**.
2. Navigate to **Baskets → Submitted Baskets**.
3. Open a basket containing a product with Print on Demand.
4. Locate the product and find the **Configuration Ref**.
5. Copy the code and paste it into the download field.

![Configuration Ref code on a submitted basket in the Business Panel](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FsrRmR1cLn5w4X8APD4Oa%2Fpod-article-shortcode-1_4rlm9l.png?alt=media)
{% endtab %}

{% tab title="Shopify" %}

1. Go to your **Shopify Admin**.
2. Open **Products**.
3. Select a product created with Print on Demand widgets.
4. Find the **Custom Design Ref** in the product header. Alternatively, copy it from the **Metafields** section under **Mimeeq Configuration Shortcode**.
5. Copy the code and paste it into the download field.

![Custom Design Ref code in the Shopify product header](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FYxeZvMcFHPfvG5NIhink%2Fpod-article-shortcode-2_1y6tdff.png?alt=media)
{% endtab %}
{% endtabs %}

***

## Configurator view appearance

With the Print on Demand widget, your customers can bring their custom designs to life on your products and see them in 3D instantly. Customers can:

* Upload graphics to a library and organise them in layers
* Rotate, resize, duplicate and move their designs within the specified print area
* Share their created designs easily with a URL

![Print on Demand editor in the desktop configurator view](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2FjVy3Fs6CcFVFT2SdjN2V%2Fpod-article-image-configurator_9rtwuv.png?alt=media)

All features are fully optimised for mobile devices.

![Print on Demand editor in the mobile configurator view](https://621103948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsqWfi8ifBhTdkvf1vOlY%2Fuploads%2Fznqu1Jc0NdjY1UPMN7tM%2Fpod-article-image-configurator_8djam.png?alt=media)

**Try a working example:**

{% embed url="<https://codepen.io/mimeeq/embed/OJGEYzm/b6062550917b534b7b8b8315a4880ad8?default-tab=>" %}
CODEPEN DEMO
{% endembed %}

***

## Related articles

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Custom Fonts</strong></td><td>Upload and organise fonts for the Text &#x26; Engraving Widget and PDFs.</td><td><a href="/configurator/options-and-widgets/custom-fonts.md">Custom Fonts</a></td></tr><tr><td><strong>Colour Picker Widget</strong></td><td>Let customers pick any colour or choose from presets.</td><td><a href="/configurator/options-and-widgets/colour-picker-widget.md">Colour Picker Widget</a></td></tr><tr><td><strong>Hiding Options</strong></td><td>Control which options appear in the option panel and specifications.</td><td><a href="/configurator/options-and-widgets/hiding-options.md">Hiding Options</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.mimeeq.com/configurator/options-and-widgets/print-on-demand.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
