Text layers

A text layer is live, editable type inside a PSD: a headline, a name, a price. SudoMock reads those layers on upload and lets you change the wording, font, size and colour at render time, so one template becomes a run of personalised images. Text output is checked side by side against Photoshop reference exports for the documented supported cases below. Validate each production template against that table before you ship it.

One template, an endless run of names. Each render swaps only the text.

What upload returns

Every POST /api/v1/psd/upload response lists the text layers it found under text_layers, each with its current values and the UUID you address it by.

{
  "uuid": "b7f2c1a0-9e34-4d21-8f0a-1c2b3d4e5f60",
  "name": "Headline",
  "text_content": "YOUR BRAND",
  "font_postscript_name": "Poppins-Bold",
  "font_size": 96,
  "color": "#1A1A1A",
  "font_available": true,
  "is_editable": true,
  "segment_count": 1,
  "has_stroke_effect": true,
  "stroke_count": 2,
  "has_color_overlay": false,
  "enclosing_group_layers": [
    "9d7e4b18-3a65-4c21-8f90-2b6d7e1a5c43"
  ]
}

Four of those fields decide what your integration can do with the layer. font_available is false when the layer’s font is not in your catalogue. is_editable is false when the layer keeps its original appearance in this version. segment_count above 1 marks a layer that mixes styles, which takes segments rather than text. has_color_overlay tells you the visible colour comes from a colour effect rather than the fill. The top-level group_layers array lists each editable enclosing outline group. Appearing in that list is the editability signal for a group.

Override at render time

Add up to 50 entries to text_layers, naming only the layers you want to change. Each entry needs the layer uuid and exactly one of text or segments. font, font_size and color are optional and fall back to the layer’s authored values.

{
  "mockup_uuid": "c315f78f-d2c7-4541-b240-a9372842de94",
  "text_layers": [
    {
      "uuid": "b7f2c1a0-9e34-4d21-8f0a-1c2b3d4e5f60",
      "text": "SUMMER SALE",
      "font": "Poppins-Bold",
      "font_size": 96,
      "color": "#C0392B"
    }
  ]
}

The same call with cURL, which is the fastest way to confirm a layer UUID is the one you think it is.

curl -s -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_MOCKUP_UUID",
    "text_layers": [
      { "uuid": "YOUR_TEXT_LAYER_UUID", "text": "SUMMER SALE" }
    ]
  }' | jq -r '.data.print_files[0].export_path'

text takes 1 to 500 characters. font is either a catalogue font uuid or its PostScript name from GET /api/v1/fonts; see Fonts. A render needs at least one entry across smart_objects, text_layers or group_layers, which means a text-only personalisation renders without any smart object at all.

import os, requests

NAME_LAYER = "b7f2c1a0-9e34-4d21-8f0a-1c2b3d4e5f60"
names = ["Jane Smith", "Alex Ruiz", "Priya Nair"]

for name in names:
    res = requests.post(
        "https://api.sudomock.com/api/v1/renders",
        headers={"x-api-key": os.environ["SUDOMOCK_API_KEY"]},
        json={
            "mockup_uuid": "c315f78f-d2c7-4541-b240-a9372842de94",
            "text_layers": [
                {"uuid": NAME_LAYER, "text": name}
            ],
        },
    )
    print(res.json()["data"]["print_files"][0]["export_path"])

Layers you leave out keep their authored text, so a template with six lines and one variable line takes a one-entry request.

Hidden layers are personalisation slots

Targeting a hidden text layer renders it. Keep the optional lines, a name, a date, a discount, hidden in the PSD and switch each one on only for the renders that need it.

{
  "mockup_uuid": "c315f78f-d2c7-4541-b240-a9372842de94",
  "text_layers": [
    {
      "uuid": "OPTIONAL_LINE_UUID",
      "text": "Limited edition, 1 of 200"
    }
  ]
}

Leave it out and the layer stays hidden, exactly as it was in the source file.

What renders (as of July 2026)

Feature	Status	Notes	What to do instead
Point text, single line	Supported	Renders with your text, matched to the original font, size and colour.
Edit text, font, size and colour	Supported	Override any of these per render, or leave them to render as designed.
Font catalogue, 2,000+ families	Supported	The full open-licensed Google Fonts library, by uuid or PostScript name.
Custom font upload	Supported	Your own TTF and OTF fonts, up to 5 MB each, on Pro and Scale.
Hidden text layers	Supported	Target a hidden layer to render it, which makes personalisation slots easy to build.
Stacked outline effects	Supported	Layered outlines render faithfully and recolour individually through a front-to-back `stroke_color` list.
Faux bold and italic	Supported	Photoshop’s synthetic bold and italic render true to the original, even when the family ships without those cuts.
Underline and strikethrough	Supported	Both decorations carry over exactly as set on the layer.
Letter spacing	Supported	Tight or loose tracking is preserved.
All caps and small caps	Supported	Both caps styles render as designed, including with new wording.
Superscript and subscript	Supported	Raised and lowered characters render at the correct size and position.
Baseline shift	Supported	Characters nudged above or below the baseline stay where the designer placed them.
Horizontal and vertical scale	Supported	Condensed or stretched text keeps its exact character width and height.
Text stroke	Supported	Keep each outline as authored, or recolour it with `stroke_color`.
Multi-line point text	Supported	Manual line breaks and leading render true to the original on every line.
Text opacity	Supported	Semi-transparent text renders at the exact fill opacity the designer set.
Mixed-style layers	Supported	A layer that mixes styles stays editable run by run, and every run keeps its own styling.
Paragraph, or box, text	Supported	Area text wraps to its box as designed, and text past the box renders clipped, matching the original behaviour.
Anti-alias mode	Supported	All five Photoshop settings are read from the layer and reproduced, so text edges match.
Latin, Cyrillic and Greek scripts	Supported	Latin-based scripts, including Turkish and accented characters, render exactly as designed.
Right-to-left scripts	Supported	Arabic and Hebrew render in the correct direction, with a fallback that keeps them readable when the chosen font lacks those glyphs.
Warped text	Supported	Ten warp styles render live with your new text: Arc, Arc Lower, Arc Upper, Arch, Bulge, Flag, Wave, Fish, Rise and Squeeze. The remaining warp styles render with their original appearance.	Using one of the remaining styles? Render your text as an image and place it in a warped smart object slot.
Rotated text layers	Supported	Text rotated to any angle renders live with your new text and keeps its exact angle. Rotation combined with mixed styles or a text box renders with its original appearance.
CJK layout	Not supported	CJK families are in the catalogue, and their full layout is currently being calibrated, so spacing may differ slightly.	Rasterise CJK text layers before upload, or render them as an image placed in a smart object slot.
Vertical text	Not supported	Not editable in this version, so it renders with its original appearance.	Convert the layer to horizontal point text in Photoshop before upload.
Justified alignment	Not supported	Not editable in this version, so it renders with its original appearance.	Switch the paragraph to left, centre or right alignment before upload.
Overflowing multi-line edits	Not supported	A multi-line edit that would overflow its slot renders the original rather than breaking the composition.	Shorten the replacement text, or design the slot with more room.

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

Ten warp styles render live with your new text, matched to the curve the designer set.

Rotated text keeps its exact angle, and mixed-style layers stay editable segment by segment.

Errors and warnings

An error blocks the render so you can fix the request. A warning rides along with a successful render so you know what happened. Both codes are stable, so your integration can branch on them. Each item in warnings carries only code and message.

Code	Type	What it means
`TEXT_LAYER_NOT_FOUND`	Error, 400	The text layer uuid in your request does not belong to this mockup.
`FONT_NOT_FOUND`	Error, 422	The font you explicitly requested is not in your catalogue. Upload it, pick a catalogue font, or omit `font`.
`FONT_AMBIGUOUS`	Error, 422	The font name matches more than one font available to you. The response carries a `candidates` list of uuids; send one as `font`.
`TEXT_SEGMENTS_REQUIRED`	Error, 422	This mixed-style layer needs `segments` rather than one `text` value.
`SEGMENT_INDEX_OUT_OF_RANGE`	Error, 422	The segment index is outside this layer’s range. Read valid indexes from the upload response.
`TEXT_SEGMENTS_UNSUPPORTED`	Error, 422	This single-style layer needs one `text` value rather than segment overrides.
`TEXT_SEGMENTS_LIMIT`	Error, 422	The request carries more than 200 segment overrides across its text layers.
`TEXT_TOO_LONG`	Error, 422	The effective combined segment text is longer than 500 characters for this layer.
`TEXT_FONT_FALLBACK`	Warning	The font for this layer was unavailable, so a default font was used. Upload the font or pick an available one, then render again.
`TEXT_FONT_AMBIGUOUS`	Warning	The layer’s font name matches more than one available font, so a default was used. Send an explicit `font` uuid for this layer.
`TEXT_FONT_MISSING_GLYPHS`	Warning	The selected font lacks some characters in the replacement text. Choose a font that supports the text.
`TEXT_WARP_BAKED`	Warning	The layer uses one of the remaining warp styles, so it rendered with its original appearance.
`TEXT_LAYER_NOT_EDITABLE`	Warning	This layer uses a structure or style not editable in this version, so it kept its original appearance.
`TEXT_FIT_SHRUNK`	Warning	You selected `shrink` and the text was scaled down to fit its area.
`TEXT_OVERRIDE_NOT_APPLIED`	Warning	The change could not be applied to this layer, so it kept its original content.
`TEXT_STROKE_NOT_PRESENT`	Warning	You sent `stroke_color` for a layer with no outline of its own. Use `group_layers` for an enclosing group outline.
`TEXT_COLOR_HIDDEN_BY_EFFECT`	Warning	A gradient effect covers the text, so the requested colour may not be visible.

Every other status code is in Errors.

Fitting and colour

Keep replacement text inside its box, and recolour text and outlines.

Fonts

The catalogue, custom uploads, and picking a font in a render.

Overview

PSD mockups

Photo mockups

Text and fonts

Integrations

Reference

Advanced

Changes

What upload returns

Override at render time

Hidden layers are personalisation slots

What renders (as of July 2026)

Errors and warnings

Fitting and colour

Fonts

​What upload returns

​Override at render time

​Hidden layers are personalisation slots

​What renders (as of July 2026)

​Errors and warnings

Fitting and colour

Fonts

What upload returns

Override at render time

Hidden layers are personalisation slots

What renders (as of July 2026)

Errors and warnings