Text Layers

What Text Layer Rendering Means

A text layer is live, editable type inside a PSD, the kind a designer uses for a headline, a name, or a price. SudoMock reads those layers on upload and lets you swap the wording, font, size, and color at render time, so one template becomes an endless run of personalized images. Most PSD mockup tools flatten or ignore text; SudoMock renders it and stays faithful to the style the designer built.

What You Get on Upload

Every POST /api/v1/psd/upload response lists the text layers it found under text_layers. Each one carries its current text, font, size, color, whether that font is available in your catalog, and whether it can be edited in this version.

1{
2  "success": true,
3  "data": {
4    "uuid": "c315f78f-d2c7-4541-b240-a9372842de94",
5    "name": "Greeting Card Front",
6    "smart_objects": [ /* ... */ ],
7    "text_layers": [
8      {
9        "uuid": "b7f2c1a0-9e34-4d21-8f0a-1c2b3d4e5f60",
10        "name": "Headline",
11        "text_content": "YOUR BRAND",
12        "font_postscript_name": "Poppins-Bold",
13        "font_size": 96,
14        "color": "#1A1A1A",
15        "font_available": true,
16        "is_editable": true,
17        "segment_count": 1
18      }
19    ],
20    "collections": []
21  },
22  "message": ""
23}

Personalizing at Render Time

Add a text_layers array to your render request with only the layers you want to change. Each entry needs the layer uuid and the new text; font, font_size, and color are optional and fall back to the layer's original values. The font value is either a catalog font uuid or its PostScript name from GET /api/v1/fonts.

1{
2  "mockup_uuid": "c315f78f-d2c7-4541-b240-a9372842de94",
3  "smart_objects": [
4    {
5      "uuid": "128394ee-6758-4f2f-aa36-e2b19b152bd9",
6      "asset": { "url": "https://your-cdn.com/design.png", "fit": "cover" }
7    }
8  ],
9  "text_layers": [
10    {
11      "uuid": "b7f2c1a0-9e34-4d21-8f0a-1c2b3d4e5f60",
12      "text": "SUMMER SALE",
13      "font": "Poppins-Bold",
14      "font_size": 96,
15      "color": "#C0392B"
16    }
17  ]
18}

Editing Mixed-Style Layers

When a single layer mixes styles, like a thin first name next to a bold surname, the upload response marks it with segment_count greater than 1 and lists each run under segments. Personalize it by sending a segments array with only the runs you want to change, each by its index. Every segment keeps its own font, size, and color, and any run you leave out keeps its original text.

1{
2  "mockup_uuid": "c315f78f-d2c7-4541-b240-a9372842de94",
3  "text_layers": [
4    {
5      "uuid": "b7f2c1a0-9e34-4d21-8f0a-1c2b3d4e5f60",
6      "segments": [
7        { "index": 0, "text": "Jane " },
8        { "index": 1, "text": "SMITH" }
9      ]
10    }
11  ]
12}

Fonts

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.

List, search, and filter the catalog with GET /api/v1/fonts. On Pro and Scale plans, upload your own fonts with POST /api/v1/fonts (TTF and OTF, up to 5 MB each) and remove them with DELETE /api/v1/fonts/{uuid}. Pro includes 10 custom fonts; Scale is unlimited.

1curl -X POST https://api.sudomock.com/api/v1/fonts \
2  -H "X-API-KEY: sm_your_api_key" \
3  -F "[email protected]" \
4  -F "license_confirmed=true"

When a Font Is Missing

When a text layer's original font is in your catalog, SudoMock renders with it automatically. When it is not, the layer still renders in a default font and the response flags it, so you can upload the exact font or pick a catalog one and render again. Nothing is dropped and nothing fails silently.

A fallback never fails the render. It succeeds and attaches a warning so you can decide what to do next: upload the exact font, or pick a catalog font and render again.

1{
2  "success": true,
3  "data": { "print_files": [ /* ... */ ] },
4  "warnings": [
5    {
6      "code": "TEXT_FONT_FALLBACK",
7      "text_layer_uuid": "b7f2c1a0-9e34-4d21-8f0a-1c2b3d4e5f60",
8      "message": "Original font not in catalog; rendered in a default font."
9    }
10  ]
11}

What Is Supported (as of July 2026)

A few layer types and styles -- warped, rotated, and vertical text, and justified alignment -- are not editable in this version, so they render exactly as they look in the PSD. Each has a one-step workaround in the table above, so your layout still survives the upload.

Optical kerning nuances and ligature toggles may differ slightly from the original.

Errors and Warnings

Errors block a render so you can fix the request; warnings ride along with a successful render so you know exactly what happened. The codes are stable, so you can branch on them in your integration.

The full feature matrix, including everything beyond text, lives on the PSD Compatibility page, and the request and response fields are documented on Render Mockup.

Frequently Asked Questions