> 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

Discover how to set up Mimeeq's print-on-demand feature to create customizable products with text and images.

With our Print on Demand Widget, your customers can easily put their own images or designs (like logos, stickers, photos, etc) on all kinds of products. They'll use a simple tool to add and move their images, and they can even see how their designs look in 3D or in their room with AR. This guide will show you how to get your products ready in our app for the best results.

## How to add print area to your product

**Admin Settings**

1. Open product, navigate to the Options tab, and click "New Option Block."
2. Select "Print on Demand" as the mode type.
3. Configure parameters for your print area and Save your work. Below is a table detailing various options for the print area and their descriptions.

<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>Max Number of Logos</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>Select Material</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>Texture size</td><td>Specify texture sizes for desktop devices. This overrides the default 3D product settings.</td></tr><tr><td>4</td><td>Mobile Texture Size</td><td>Specify texture sizes for mobile devices. This overrides the default 3D product settings.</td></tr><tr><td>5</td><td>AR Texture Size</td><td>Sets texture sizes specifically for Augmented Reality experiences. Helps optimize AR performance and visual fidelity.</td></tr><tr><td>6</td><td>Code</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>Visibility Code</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>Full Screen View</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>By default open as</td><td>Defines if the widget opens in an options panel or goes directly to full screen.</td></tr><tr><td>10</td><td>Opaque Background</td><td>Controls whether the background is transparent or opaque. When disabled, texture below remains visible.</td></tr><tr><td>11</td><td>Generate Cropped View</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 a Media Library, allowing to use a single file rather than multiple separate image files.</td></tr><tr><td>12</td><td>Print Area</td><td>Upload layers to define the print area. Follow the <a href="#how-to-upload-layers">provided order guide</a> for your layers bellow.</td></tr><tr><td>13</td><td>2D Preview</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>Measurement Type</td><td>Select whether the print area is measured in inches or centimeters.</td></tr><tr><td>15</td><td>Real Width</td><td>Set the <strong>real-life</strong> width of the print area on the product.</td></tr><tr><td>16</td><td>Real Height</td><td>Set the <strong>real-life</strong> height of the print area on the product.</td></tr><tr><td>17</td><td>Required DPI</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>Description</td><td>Provide details or instructions for the widget, displayed below the title <em>(optional)</em></td></tr><tr><td>19</td><td>Accepted Formats</td><td>List the file formats that can be uploaded for printing - PNG, JPG, WEBP, SVG, AI, HEIC, EPS or PDF files. File size can not be larger then 50 MB</td></tr></tbody></table>

![How to add Print Area to your product](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

To set up the print area, start by uploading layers in the correct order. Begin with the base layer, which will act as the 2D preview image of your product. This image helps guide users and doesn't have to be grey — it can be any design you choose. Next, add a mask layer on top of this guide image. The mask must be in SVG format and defines the printable area. Usually, these two layers are enough.

However, if you need to include fixed elements in the design, like non-removable labels, upload these as additional layers above the mask. Remember to leave the "Exclude from texture" option unchecked for these layers, so they remain visible and intact on your product.

{% hint style="info" %}
Note: 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 %}

![How to upload 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'll need to create at least two files: a user guide and a mask.

{% stepper %}
{% step %}

### Create a user guide image

If you've got your product ready in our app, you can generate an image of the part you'd like to print on. This will be your user guide. Alternatively, you can prepare this image with any other tool or resources that you have. Save it as a PNG or JPG file. On this image, mark out the print area. You could outline it or shade it in — whatever helps your customers see where their design will go.
{% endstep %}

{% step %}

### Prepare a clipping mask

After you have a 2D preview of your product with the printed area, define a mask using an app like Photoshop. The mask tells the widget where designs can be printed. Save this mask as an SVG file with the vector object (once a user uploads an image, it will only be visible in this mask area) and transparency (uploaded images will not be visible on this part of the mask).

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

![How to organise layers](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 UV texture

To make sure your designs show up correctly in 3D, the mask you make must match the UV texture of the 3D model. If you need a hand with 3D models or UV maps, just 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

To download print files that customers have uploaded, go to the Media Library. Then, choose Download POD files, enter configuration shortcode and click Download Files. This will give you a ZIP file with all the designs customers added for the product in their original format.

![Media Library -> Download POD files](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)

![Enter configuration shortcode and download 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 to provide a configuration shortcode. The location of this code depends on your setup — either using the Mimeeq Basket or a Shopify integration.

#### If you are using the 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 in Mimeeq Basket](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)

#### If you are using 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, you can 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 Shopify](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)

## Configurator View Appearance

With Print on Demand widget your customers can bring their custom designs to life on your products and see them in 3D instantly! Here's what your customers can do:

* 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 -> Desktop 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 a seamless experience on mobile devices 📲

![Print on Demand -> Mobile 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)

**Here is a working example to try**

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


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.