Add Text to Mug Mockups over the API

Drop a different name or message onto the wrap of your mug PSD and render a ready-to-list image, one call per gift.

per rendered mug: 1 credit; per rendered mug
a name without a redesign: Per order; a name without a redesign

Custom-name mugs are a personalization staple, and you do not need a new PSD for each one. Keep the wrap message as a text layer, and SudoMock lets you send a fresh name or line at render time. The mug template stays fixed while the wording changes per order.

How text personalization works on a mug

Three steps take one mug template to repeatable personalized outputs, with one render call per output.

Step 1
Keep the wrap message editable
Leave the "World's Best ___" line, or whatever your mug says, as a text layer on the wrap. That single slot is what every order will personalize.
Step 2
Pull the message layer id
The upload response lists the wrap text layer with its font, size, and color. Note its uuid so each order can target exactly that line.
Step 3
Render one image per recipient
Send one render call per gift order with the recipient's name as the new text. Each call returns one listing-ready mug image that matches the original layout and typeface.

Styled segments

Mixed-style text on a mug, editable run by run

A gift line where a small "World's Best" caps a large recipient word.

World's Best DAD

The small caption and the big word can share one layer while staying separately editable. Change "DAD" to "GRANDMA" and the large weight follows the longer word without touching the caption above it.

Representative render request

Swap just the large word on a gift-mug wrap.

POST /api/v1/renders -- mug text

{
  "mockup_uuid": "7b2a9c10-4d3e-4f21-9a8b-0c1d2e3f4a5b",
  "text_layers": [
    { "uuid": "11111111-1111-4111-8111-111111111111", "text": "GRANDMA", "font_size": 120 }
  ],
  "export_options": { "image_format": "png", "image_size": 1600 }
}

Replace mockup_uuid and each text-layer uuid with values from the upload response, then send only the layers you want to change.

What powers every mug render

SudoMock renders the text layers in your PSD, so you can swap the wording, font, size, and color at render time and get back an image that keeps the look the designer built.

2,000+ open-licensed font families, free for commercial use
Custom TTF and OTF font upload, up to 5 MB each, on Pro and Scale
Styled segments: mixed-style layers stay editable run by run
Box text: area text wraps inside its box and clips exactly as designed

The built-in font catalog is the full open-licensed Google Fonts library (2,000+ families under OFL, Apache, and UFL licenses), free to use in commercial work. Pro and Scale plans can also upload their own TTF and OTF fonts.

Questions about mug text mockups

Can I make custom-name mugs from a single mug mockup?

Yes. Keep the name line as a text layer, then send each order's name in its own render call. The wrap layout, font, and color stay put while only the name changes, so one PSD covers your whole personalized catalog.

How do I change the message color to match different mug colors?

Send a color value on the text layer in the render call. You can pair the same message with a light color for dark mugs and a dark color for light mugs, all from the same template.

Text on other products

Text on tote bag mockups Text on sticker mockups Text on poster mockups

Personalize your mug mockups over the API

Start free with 500 credits. Upload a PSD, send your text, get a finished image URL back.

Start free See all categories