Printful Mockup Generator: How It Works, API Limits and Terms

Printful's mockup generator is free: after you sign up, you place your design on any product in Printful's catalog and download or publish the mockups from the Design Maker or your product's mockup library. The catch is scope. The mockups only cover Printful catalog products, the API version is an asynchronous task whose image links expire after 72 hours (per the v1 docs), and Printful's terms say the mockups may only be used to sell Printful products.

This guide covers how the generator works in the dashboard and through the API, the limits that matter at volume, and when it makes sense to render listing images from your own PSD instead.

Printful describes it plainly: "Create and download free mockups of your Printful products. No complicated software or upfront costs." It covers the whole catalog: "If it's in our Catalog, we have mockups for it", including apparel, accessories, home and living, and embroidery.

There are two ways in, according to Printful's help center:

1. Design Maker: open a product, add your design, click Preview, then Download mockup.
2. Mockup library: go to My products, open a product and use View all mockups to filter and download the images you need.

Printful also lets you upload your own mockups to a product as JPG, PNG or SVG, up to 30,000 x 30,000 px, as long as the product in the image closely matches the Printful product.

Printful does not publish a count of mockup styles per product. Its page says it keeps adding templates "from lifestyle shots to clean studio backgrounds".

Yes. The Free plan ($0 per month) lists "Free Design Maker and Mockup Generator". Printful Growth costs $24.99 per month and is free once annual sales reach $12K (printful.com/pricing, read 4 October 2026). It adds discounts and a few print perks. There is no separate paid mockup tier on the pricing page as of September 30, 2026.

What you pay for is the product. The mockups exist to sell items Printful prints and ships.

Developers reach the same catalog mockups through the Printful API. It needs a private token from the Developer Portal, sent as Authorization: Bearer {token}. Account-level tokens also need an X-PF-Store-Id header.

The flow is task based:

• v1: POST /mockup-generator/create-task/{id} with the product, variants and your file placement, then GET /mockup-generator/task?task_key=... for the result. Helper endpoints GET /mockup-generator/printfiles/{id} and GET /mockup-generator/templates/{id} return print areas and templates.
• v2 (open beta): POST /v2/mockup-tasks, then poll GET /v2/mockup-tasks?id=... or listen for the mockup_task_finished webhook.

Printful is explicit that this is not real time: "Mockup generation requires some time, that is why it cannot happen in real-time", and "The first request for a result should not be sooner than 10 seconds."

Limits worth planning around:

Printful: pick a catalog item, create a task, poll or wait for a webhook, then store the URL within 72 hours. PSD rendering: upload a template once, render with an artwork URL, and get the image in the response.

No. Printful's Terms of Service (section 4.6) say digital items "like mockups, templates, images and other design assets" belong to Printful and may only be used "in connection with the advertising, promoting, offering and sale of Printful's Products and may not be used for other purposes or in conjunction with products from other manufacturers."

In practice: if you also sell products printed by Gelato, Printify or your own shop, you cannot reuse Printful's mockups for those listings. The help center confirms the intended use is "your store listings or social media content" for Printful products.

Teams move to their own templates when:

1. The brand needs its own look. Catalog scenes are available to every Printful seller, so listings start to look alike.
2. They sell through more than one supplier. A PSD you own is not tied to one manufacturer's terms.
3. They render at volume. Hundreds of designs and colorways are easier with a synchronous render call than with tasks you poll and URLs you must copy before they expire.
4. They need large files. SudoMock renders up to 10,000 px.

SudoMock renders the PSD you upload to match Photoshop's own output, in under a second, and has served over 2 billion renders at 99.9% uptime. You send the artwork URL and, if needed, a color per smart object, and the response contains the finished image URL:

curl -X POST "https://api.sudomock.com/api/v1/renders" \
  -H "x-api-key: sm_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "mockup_uuid": "YOUR_TEMPLATE_UUID",
    "smart_objects": [
      {
        "uuid": "FRONT_PRINT_SMART_OBJECT_UUID",
        "asset": { "url": "https://yourcdn.com/designs/front.png", "fit": "fit" }
      },
      {
        "uuid": "GARMENT_COLOR_SMART_OBJECT_UUID",
        "color": { "hex": "#1E3A5F", "blending_mode": "multiply" }
      }
    ],
    "export_options": { "image_format": "webp", "image_size": 1024, "quality": 90 }
  }'

const response = await fetch('https://api.sudomock.com/api/v1/renders', {
  method: 'POST',
  headers: {
    'x-api-key': 'sm_your_api_key',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "mockup_uuid": "YOUR_TEMPLATE_UUID",
    "smart_objects": [
      {
        "uuid": "FRONT_PRINT_SMART_OBJECT_UUID",
        "asset": {
          "url": "https://yourcdn.com/designs/front.png",
          "fit": "fit"
        }
      },
      {
        "uuid": "GARMENT_COLOR_SMART_OBJECT_UUID",
        "color": {
          "hex": "#1E3A5F",
          "blending_mode": "multiply"
        }
      }
    ],
    "export_options": {
      "image_format": "webp",
      "image_size": 1024,
      "quality": 90
    }
  }),
});

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    "https://api.sudomock.com/api/v1/renders",
    headers={
        "x-api-key": "sm_your_api_key",
        "Content-Type": "application/json",
    },
    json={
        "mockup_uuid": "YOUR_TEMPLATE_UUID",
        "smart_objects": [
            {
                "uuid": "FRONT_PRINT_SMART_OBJECT_UUID",
                "asset": {
                    "url": "https://yourcdn.com/designs/front.png",
                    "fit": "fit",
                },
            },
            {
                "uuid": "GARMENT_COLOR_SMART_OBJECT_UUID",
                "color": {
                    "hex": "#1E3A5F",
                    "blending_mode": "multiply",
                },
            },
        ],
        "export_options": {
            "image_format": "webp",
            "image_size": 1024,
            "quality": 90,
        },
    },
)

print(response.json())

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := []byte(`{
  "mockup_uuid": "YOUR_TEMPLATE_UUID",
  "smart_objects": [
    {
      "uuid": "FRONT_PRINT_SMART_OBJECT_UUID",
      "asset": {
        "url": "https://yourcdn.com/designs/front.png",
        "fit": "fit"
      }
    },
    {
      "uuid": "GARMENT_COLOR_SMART_OBJECT_UUID",
      "color": {
        "hex": "#1E3A5F",
        "blending_mode": "multiply"
      }
    }
  ],
  "export_options": {
    "image_format": "webp",
    "image_size": 1024,
    "quality": 90
  }
}`)

	req, err := http.NewRequest("POST", "https://api.sudomock.com/api/v1/renders", bytes.NewBuffer(payload))
	if err != nil {
		panic(err)
	}
	req.Header.Set("x-api-key", "sm_your_api_key")
	req.Header.Set("Content-Type", "application/json")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

<?php

$payload = <<<'JSON'
{
  "mockup_uuid": "YOUR_TEMPLATE_UUID",
  "smart_objects": [
    {
      "uuid": "FRONT_PRINT_SMART_OBJECT_UUID",
      "asset": {
        "url": "https://yourcdn.com/designs/front.png",
        "fit": "fit"
      }
    },
    {
      "uuid": "GARMENT_COLOR_SMART_OBJECT_UUID",
      "color": {
        "hex": "#1E3A5F",
        "blending_mode": "multiply"
      }
    }
  ],
  "export_options": {
    "image_format": "webp",
    "image_size": 1024,
    "quality": 90
  }
}
JSON;

$ch = curl_init('https://api.sudomock.com/api/v1/renders');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'x-api-key: sm_your_api_key',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => $payload,
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

The image URL is in data.print_files[0].export_path. For big batches, set "is_async": true, then poll the job or register a webhook endpoint for render.succeeded.

Many sellers use both: Printful for printing and shipping, and their own PSD for the images that have to look like their brand.

Render one of your designs on your own PSD. The quickstart takes a Photoshop file to a rendered mockup in two requests, and SudoMock's library has 300+ Printful-compatible mockup templates if you have no PSD yet.

To run that render without code, use the n8n integration. The print on demand use case shows the same setup across a whole catalog.