What is a PSD mockup template?

A PSD mockup template is a pre-designed Photoshop file containing Smart Objects that allow you to automatically replace placeholder content with your own designs. These templates enable batch generation of product images without manual editing, making them essential for e-commerce and print-on-demand businesses.

How do Smart Objects work in PSD mockups?

Smart Objects are special layers in Photoshop that act as containers for your design. When you replace the content of a Smart Object, the transformation, perspective, and effects are automatically applied. This allows mockup APIs to programmatically insert designs while maintaining realistic appearance.

Can I use PSD mockup templates without Photoshop?

Yes, with a mockup API like SudoMock, you can use PSD templates without having Photoshop installed. The API processes the PSD file server-side, replacing Smart Objects with your designs and returning the final rendered image.

How many Smart Objects can a PSD mockup template have?

A PSD mockup template can have multiple Smart Objects - typically 1-5 for product mockups. Each Smart Object can be targeted independently, allowing you to replace different areas of the design (e.g., front and back of a t-shirt, or multiple product variants in one scene).

What file formats can I export from PSD mockup templates?

PSD mockup templates can be rendered to multiple formats including PNG (for transparency), JPEG (for web optimization), and WebP (for modern browsers). Most mockup APIs support configurable output formats, quality settings, and dimensions.

What's the maximum file size for PSD templates?

300MB maximum. This generous limit supports complex multi-layer mockups. Smaller files process faster, so optimize when possible.

What's the maximum image dimension for PSD templates?

10,000×10,000px for both the PSD canvas and Smart Object internal dimensions. This is also the maximum export size.

Which blend modes are supported in SudoMock?

All 27 standard Photoshop blend modes are supported, including: normal, dissolve, darken, multiply, color burn, linear burn, darker color, lighten, screen, color dodge, linear dodge, lighter color, overlay, soft light, hard light, vivid light, linear light, pin light, hard mix, difference, exclusion, subtract, divide, hue, saturation, color, and luminosity.

What export formats are available?

Three formats: WebP (default, smallest file size), PNG (lossless, supports transparency), and JPG (universal compatibility). Quality can be set from 1-100, default is 95.

Do layer effects (shadows, strokes) work with Smart Objects?

Layer styles on the Smart Object layer are preserved. However, effects inside the Smart Object itself may not render as expected. Apply effects at the container level for best results.

Do layer masks on Smart Objects work?

Layer masks on the Smart Object layer affect the canvas-level display, not the exported image. For masking in the final output, use clipping masks or adjust the Smart Object content directly.

Are nested Smart Objects supported?

Yes. SudoMock fully supports nested Smart Objects with no depth limit. Each nested Smart Object can be targeted independently for content replacement.

What does the 'quad' field mean in the API response?

The quad field contains four [x, y] coordinate pairs representing the corners of the Smart Object's visible area after transformation. This is useful for positioning overlays or understanding the final placement of your design.

PSD Mockup Template Guide: Automation Tips

Professional-Grade Capabilities

Built for high-resolution workflows

Large

Files

Complex PSDs

High

Res

Print-Ready

∞

layers

No Limit

modes

Blend Support

What Makes a Good Mockup Template?

A well-prepared PSD template is the foundation of automated mockup generation. Whether you're building a print-on-demand business or creating marketing assets at scale, your template quality directly impacts output quality.

Supported Blend Modes

SudoMock supports all 27 standard Photoshop blend modes. These are extracted directly from the PSD and applied pixel-perfectly during rendering:

27 Supported Blend Modes

All Photoshop blend modes implemented

+ normal, pass through, dissolve

Darken

darkenmultiplycolor burnlinear burndarker color

Lighten

lightenscreencolor dodgelinear dodgelighter color

Contrast

overlaysoft lighthard lightvivid lightlinear lightpin lighthard mix

Inversion

differenceexclusionsubtractdivide

HSL

huesaturationcolorluminosity

Blend Mode Recommendations

Fabrics (t-shirts, hoodies): Multiply - shows texture through design
Hard surfaces (phones, laptops): Normal - clean, solid colors
Glossy materials: Overlay or Soft Light - adds depth
Paper/print mockups: Multiply at 80-90% opacity

Layer Masks vs Clipping Masks

Understanding how masks work with Smart Objects is crucial for creating reliable mockup templates. SudoMock supports both layer masks and clipping masks, but they behave differently:

Critical: Smart Object Layer Masks

Layer masks applied to the Smart Object layer itself affect the canvas-level display, not the embedded content. When you replace Smart Object content via API, the mask stays on the layer but does not clip the new design. This is standard Adobe Photoshop behavior.

Solution: If you need masking on the design itself, use a clipping mask layer above the Smart Object, or apply the mask inside the PSB (embedded Smart Object).

Best Practice for T-Shirt/Fabric Mockups

If your t-shirt mockup has a layer mask that shapes the design area, consider:

Using Multiply blend mode instead of masks for natural fabric integration
Placing the mask on a group containing the Smart Object, not directly on the SO
Using clipping mask layers above the Smart Object for shape constraints

Nested Smart Objects

Unlike some competitors, SudoMock

fully supports nested Smart Objects

. You can have Smart Objects inside Smart Objects, with all transforms and blend modes preserved at each level.

Example Nested Structure

text

Layer Effects on Smart Objects

SudoMock renders layer effects (layer styles) applied to Smart Object layers. Here's what's supported:

Effects Inside vs Outside Smart Object

Effects on the SO layer: Preserved when content is replaced
Effects inside the PSB: Replaced along with the content

Keep decorative effects on the Smart Object layer itself for consistent rendering across all designs.

Step-by-Step: Creating Your Template

Set Up Your Canvas

Start with your product photo as the base. SudoMock accepts PSDs with these specifications:

Max dimensions: 10,000×10,000px
Max file size: 300MB
Format: Standard PSD (Photoshop CC compatible)

Create the Smart Object

The Smart Object is where designs will be placed. This is the most critical step:

Create a new layer or shape where the design should appear
Right-click → Convert to Smart Object
Double-click to open the embedded .psb file
Set the PSB canvas to your desired design resolution
Save and close the .psb

Smart Object Size Limits

Smart Object internal canvas can be up to 10,000×10,000px. The API will extract the exact dimensions and return them in the size field of the response, which you should use to prepare designs at the optimal resolution.

Apply Transforms

Make the design fit your product naturally using Photoshop's transform tools:

Edit → Transform → Distort for perspective
Edit → Transform → Warp for curved surfaces (mugs, fabric folds)
Edit → Transform → Perspective for angled views

All transforms are preserved. The API extracts quad coordinates that represent the four corner points of the transformed Smart Object.

Set Blend Mode

Choose from 27 supported blend modes. The most commonly used for mockups:

Name Your Layers

Layer names appear in API responses. Use clear, descriptive names:

Good Layer Naming

text

Optimize File Size

While SudoMock supports large files, smaller files process faster and upload quicker:

Delete Cropped Pixels: Image → Crop with "Delete Cropped Pixels" enabled removes hidden content outside canvas
Flatten background layers that don't need editing
Delete hidden layers you're not using
Rasterize text layers that won't change
Use "Purge All" (Edit → Purge) to clear history and clipboard
Merge visible layers for non-essential decorative elements
Save a copy to avoid bloated history states

Pro Tip: Smart Object Dimensions

Smart Object internal canvas (PSB) size affects file size significantly. If your design area is 2000×2000px, don't create a 10,000×10,000px Smart Object "just in case". Size it appropriately for your use case.

Recommended PSD Structure

Here's the recommended layer organization for a mockup template:

Recommended PSD Structure

📁 T-Shirt-Mockup.psd

│

├──📁 Overlays(Group)

└──Texturesoft light 15%

│

├──📦 Design_FrontSmart Object

├──blend:multiply

├──transform:warp

└──size:3500×4000px

│

├──🖼️ Product(locked)

│

└──🎨 Background(flattened)

Smart Object Response Data

When you upload a PSD, the API extracts detailed metadata from each Smart Object. Understanding this data helps you build better integrations:

Smart Object Response Structure

What you get after uploading a PSD

SmartObjectResponse

uuidstringrequired

namestringrequired

size{width, height}required

position{x, y, w, h}required

quad[[x,y], ...]optional

blend_modestringoptional

size vs position

size (embedded dimensions)

Original Smart Object canvas

→ Design at this resolution

position (bbox)

Where it renders on mockup

→ Use for previews

Example API Response

json

size vs position

size = Original Smart Object canvas (embedded PSB dimensions)
position = Where it appears on the mockup (bounding box)
quad = Four corner points if transformed (warp/perspective)

Prepare your designs at the size dimensions for best quality.

Export Options

When rendering mockups, you have full control over the output format and quality:

Export Options

DEFAULT

🖼️

WebP

Smallest size

Quality: 1-100

🎨

PNG

Lossless, transparency

Best quality

📷

JPG

Universal support

Quality: 1-100

Render with Export Options

javascript

Quick Reference Checklist

Before Upload

☐ File size under 300MB
☐ Dimensions under 10,000×10,000px
☐ Smart Objects converted (not rasterized)
☐ Descriptive layer names

Smart Object Settings

☐ Blend mode set (multiply for fabrics)
☐ Transforms applied (warp, perspective)
☐ Visible (not hidden)
☐ Positioned correctly on canvas
☐ Internal canvas sized appropriately

Related Resources

Upload PSD API Reference

Complete documentation for the upload endpoint

Render API Reference

All render options and parameters

API Data Model Guide

Understanding API response structures

Quickstart Guide

Get your first mockup in 5 minutes

PSD Mockup Template Guide: Best Practices for Automation

TL;DR

Key Takeaways:

What Makes a Good Mockup Template?

Supported Blend Modes

Layer Masks vs Clipping Masks

Nested Smart Objects

Layer Effects on Smart Objects

Step-by-Step: Creating Your Template

Set Up Your Canvas

Create the Smart Object

Apply Transforms

Set Blend Mode

Name Your Layers

Optimize File Size

Recommended PSD Structure

Smart Object Response Data

Export Options

Quick Reference Checklist

Before Upload

Smart Object Settings

Related Resources

Upload PSD API Reference

Render API Reference

API Data Model Guide

Quickstart Guide

Frequently Asked Questions

Related Articles

5 Ways to Scale Your POD Business with API

Complete Guide to Smart Objects in Mockups

Ready to Try SudoMock?