PSD compatibility

A feature is listed as supported here only when its output is verified against Photoshop’s own render. Where faithful reproduction is not possible, the row says so and points at the mechanism that gets you the same look.

Core features

Feature	Status	Notes
Smart objects, embedded	Supported	Artwork replacement, nested smart objects, and several smart objects per template.
Smart objects, linked	Supported	Rendered from their placement geometry, so Embed Linked is not required before upload.
Layer masks	Supported	Honoured and rendered to match Photoshop.
Blend modes, all 27	Supported	Photoshop-accurate compositing. Pass Through is additionally accepted as a group blending mode.
Smart object warps, mesh	Supported	Warp meshes render to match Photoshop’s own output, verified pixel for pixel.
Perspective transforms	Supported	Four-point perspective placement on smart objects.
Layer effects: Drop Shadow, Stroke, Blend If	Supported	Rasterize Glow and Bevel in Photoshop before upload.
Text layers	Supported	Point, multi-line and area text render with editable wording, font, size and colour. Rotated text and ten warp styles render live with your new text; the remaining warp styles and vertical text render as authored.
International scripts	Supported	Latin-based scripts, including Turkish and accented characters, render as designed. Arabic and Hebrew render right-to-left, with a readable fallback when the chosen font lacks those glyphs. CJK families are in the catalogue with layout still being calibrated.

Colour modes other than RGB are converted on upload. Duotone and Multichannel currently render in grayscale, so convert those files to RGB in Photoshop while you still hold the ink values.

Rasterize these before upload

Feature	What to do instead
Glow, Bevel and Emboss	Rasterize the styled layer. The result is fixed pixels that render exactly.
3D layers	Render the 3D pass to pixels in Photoshop and keep it as a static layer.
Video layers	Export the frame you want and place it as a pixel layer.
Adjustment layers outside a smart object	Clip the adjustment to the smart object, or send the values as `adjustment_layers` at render time.

Hidden layers

How a hidden layer behaves depends on its type, and the two rules point in opposite directions. A smart object that is hidden in Photoshop is not exposed as a slot and is not rendered. Make the layer visible and upload the file again. An upload that contains one comes back flagged.

Upload warning on a hidden smart object

{
  "code": "PSD_HIDDEN_SMART_OBJECTS",
  "message": "This PSD contains hidden smart object layers. Make them visible in Photoshop and re-upload to use them."
}

A text layer that is hidden in Photoshop is kept as a fillable slot. It renders only when you fill it and stays hidden when you leave it empty, exactly as it was in your source file. One template can therefore carry optional lines, personalized fields or language variants that appear only on the renders you choose to fill.

Turning on a hidden text layer for one render

{
  "mockup_uuid": "c315f78f-d2c7-4541-b240-a9372842de94",
  "text_layers": [
    {
      "uuid": "b7f2c1a0-9e34-4d21-8f0a-1c2b3d4e5f60",
      "text": "Limited edition"
    }
  ]
}

Linked smart objects

Linked content renders from its placement geometry. When a linked smart object carries no usable placement geometry, the render returns a permanent 422 and retrying the same file returns it again.

422 LINKED_SMART_OBJECT_CONTENT_MISSING

{
  "success": false,
  "error_code": "LINKED_SMART_OBJECT_CONTENT_MISSING",
  "message": "A linked smart object has no usable placement geometry.",
  "detail": "Embed the smart object in Photoshop, or supply the design at render time."
}

Run Layer > Smart Objects > Embed Linked and upload again, or send the artwork in the render body.

Smart filters

Smart filters are non-destructive filters on smart object layers, and support is filter-specific. Perspective Warp, Curves, Gaussian Blur, Box Blur, Brightness/Contrast, Invert, Displace, Find Edges and the one-click filters render today, with no extra parameters in the request body. A PSD with a live Perspective Warp renders like any other

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": "c315f78f-d2c7-4541-b240-a9372842de94",
    "smart_objects": [
      {
        "uuid": "128394ee-6758-4f2f-aa36-e2b19b152bd9",
        "asset": {
          "url": "https://your-cdn.com/design.png",
          "fit": "crop"
        }
      }
    ]
  }),
});

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

<?php

$payload = <<<'JSON'
{
  "mockup_uuid": "c315f78f-d2c7-4541-b240-a9372842de94",
  "smart_objects": [
    {
      "uuid": "128394ee-6758-4f2f-aa36-e2b19b152bd9",
      "asset": {
        "url": "https://your-cdn.com/design.png",
        "fit": "crop"
      }
    }
  ]
}
JSON;

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

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

echo $response;

import requests

payload = {
    "mockup_uuid": "c315f78f-d2c7-4541-b240-a9372842de94",
    "smart_objects": [
        {
            "uuid": "128394ee-6758-4f2f-aa36-e2b19b152bd9",
            "asset": {
                "url": "https://your-cdn.com/design.png",
                "fit": "crop"
            }
        }
    ]
}

response = requests.post(
    "https://api.sudomock.com/api/v1/renders",
    headers={"x-api-key": "sm_your_api_key"},
    json=payload,
)

response.raise_for_status()
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.sudomock.com/api/v1/renders")
request = Net::HTTP::Post.new(uri)
request["x-api-key"] = "sm_your_api_key"
request["Content-Type"] = "application/json"

request.body = <<~JSON
  {
    "mockup_uuid": "c315f78f-d2c7-4541-b240-a9372842de94",
    "smart_objects": [
      {
        "uuid": "128394ee-6758-4f2f-aa36-e2b19b152bd9",
        "asset": {
          "url": "https://your-cdn.com/design.png",
          "fit": "crop"
        }
      }
    ]
  }
JSON

response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts response.body

package main

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

func main() {
	payload := []byte(`{
  "mockup_uuid": "c315f78f-d2c7-4541-b240-a9372842de94",
  "smart_objects": [
    {
      "uuid": "128394ee-6758-4f2f-aa36-e2b19b152bd9",
      "asset": {
        "url": "https://your-cdn.com/design.png",
        "fit": "crop"
      }
    }
  ]
}`)

	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")

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

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

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

String payload = """
{
  "mockup_uuid": "c315f78f-d2c7-4541-b240-a9372842de94",
  "smart_objects": [
    {
      "uuid": "128394ee-6758-4f2f-aa36-e2b19b152bd9",
      "asset": {
        "url": "https://your-cdn.com/design.png",
        "fit": "crop"
      }
    }
  ]
}
""";

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.sudomock.com/api/v1/renders"))
    .header("x-api-key", "sm_your_api_key")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(payload))
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());

using System.Net.Http;
using System.Text;

var payload = """
{
  "mockup_uuid": "c315f78f-d2c7-4541-b240-a9372842de94",
  "smart_objects": [
    {
      "uuid": "128394ee-6758-4f2f-aa36-e2b19b152bd9",
      "asset": {
        "url": "https://your-cdn.com/design.png",
        "fit": "crop"
      }
    }
  ]
}
""";

var request = new HttpRequestMessage(HttpMethod.Post, "https://api.sudomock.com/api/v1/renders");
request.Headers.Add("x-api-key", "sm_your_api_key");
request.Content = new StringContent(payload, Encoding.UTF8, "application/json");

var client = new HttpClient();
var response = await client.SendAsync(request);

Console.WriteLine(await response.Content.ReadAsStringAsync());

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": "c315f78f-d2c7-4541-b240-a9372842de94",
    "smart_objects": [
      {
        "uuid": "128394ee-6758-4f2f-aa36-e2b19b152bd9",
        "asset": {
          "url": "https://your-cdn.com/design.png",
          "fit": "crop"
        }
      }
    ]
  }'

Camera Raw Filter, Filter Gallery, Liquify, Lens Correction, randomized filters such as Clouds, and Average are currently not rendered, because they rely on proprietary Adobe algorithms or on data the PSD does not store. Each one has a recommended alternative in the full matrix on Smart filters.

What to do with an unsupported feature

Every unsupported row routes to something that does render: geometric filters rebuild as Warp or Perspective Warp, tonal filters rebuild as Curves or Brightness/Contrast clipped to the smart object, and decorative or random textures rasterize into a static pixel layer. A texture that is the same on every design belongs above the print area as its own layer with a blend mode.

The same look through a blend mode

{
  "uuid": "128394ee-6758-4f2f-aa36-e2b19b152bd9",
  "asset": {
    "url": "https://your-cdn.com/design.png",
    "fit": "crop"
  },
  "color": { "hex": "#8B5E3C", "blending_mode": "soft_light" }
}

Keep supported features live rather than baking them into pixels. A live feature stays accurate for every design you send.

Preparing a PSD

The authoring checklist that keeps these rows on the supported side.

Errors

Every upload and render error code, with the action for each.

Overview

PSD mockups

Photo mockups

Text and fonts

Integrations

Reference

Advanced

Changes

PSD compatibility

Core features

Rasterize these before upload

Hidden layers

Linked smart objects

Smart filters

What to do with an unsupported feature

Preparing a PSD

Errors

​Core features

​Rasterize these before upload

​Hidden layers

​Linked smart objects

​Smart filters

​What to do with an unsupported feature

Preparing a PSD

Errors

Core features

Rasterize these before upload

Hidden layers

Linked smart objects

Smart filters

What to do with an unsupported feature