Skip to main content
Fit decides where artwork lands inside an area. Blend mode decides how that artwork sits on the material underneath it. Between them they account for most of how a render looks, and they behave the same way whether the template came from a PSD or from a product photo. Reach for these two values when you need to:
  • Keep a design whole: the artwork stays fully visible inside the area, with nothing cut off.
  • Cover a product edge to edge: an all over print fills the area and the overflow is trimmed.
  • Match a brand colour: the artwork keeps its own colours instead of taking on the material.

​
Choose a fit mode

fit controls how your artwork meets the area it is placed into. It is asset.fit on a PSD smart object and placement.fit on a photo mockup print area, and it takes the same values in both places.
​
fit | fill | crop
default:"fit"
How the artwork is scaled into the area. Possible values:
  • fit: scaled until it fits inside, proportions kept, so space can be left over. The whole design stays visible.
  • fill: stretched to the bounds, proportions not kept, so the design can distort. Send it when the artwork already carries the area’s proportions.
  • crop: covers the area and cuts the overflow, proportions kept. This is the all over print.
contain and cover are the older names for fit and crop. They are still accepted and will stay accepted, so nothing you have already shipped needs to change.
The default never distorts. A call that says nothing about fit is not asking to have its artwork stretched, so the default is fit. Send fill explicitly when you want the stretch.
An unrecognised value returns 422 instead of quietly resolving to a default. A typo that renders a wrong image without an error costs far more than a rejected request, because nobody sees it until a customer does.
The PSD editor prints these same three words on its buttons, so the value you send is the word a seller clicks. The same value travels in two places, one per template type. The highlighted line carries it in each body below.

​
Choose a blend mode on a photo mockup

adjustments.blend_mode controls how artwork blends with the product surface in the photograph. It is set per print area, so one area can hold an exact logo while another carries a printed looking graphic.
​
string
default:"multiply"
How the artwork sits on the surface underneath it. Possible values:
  • multiply: keeps the material texture visible, and is the best choice on light fabric. A light artwork can get swallowed on a dark garment.
  • normal: reproduces the artwork colours exactly, whatever the product colour.
  • screen: lightens the artwork against the surface. The default already adapts to a dark garment, so reach for this only when you want the lighter result there.
  • lighten: keeps the artwork only where it is brighter than the surface.
  • soft_light: a subtle, low contrast finish that follows the surface.
  • overlay: deepens contrast so the artwork reads as part of the material.
  • darken: keeps the artwork only where it is darker than the surface.
Reach for multiply on garments and textured surfaces: it lets the material texture show through, so the design looks printed rather than pasted on. It behaves like real ink, which is why a white logo comes out grey on a black tee, and why normal is the answer when a brand colour has to match the file you supplied. Keeping an exact brand colour on one area:
Match a brand colour

​
Recolour a PSD layer with a blend mode

blending_mode sits beside hex in the color object on a smart object, and it decides how that colour overlay meets the layer underneath. It accepts all 27 Photoshop layer blend modes, with an underscore or a space as the separator: soft_light and soft light both work.
​
string
default:"normal"
How the colour overlay meets the layer underneath. Possible values, by family:
  • Normal and special: normal, dissolve
  • Darken: darken, multiply, color_burn, linear_burn, darker_color
  • Lighten: lighten, screen, color_dodge, linear_dodge, lighter_color
  • Contrast: overlay, soft_light, hard_light, vivid_light, linear_light, pin_light, hard_mix
  • Inversion: difference, exclusion, subtract, divide
  • HSL components: hue, saturation, color, luminosity
Recolouring a smart object with a blend mode:
Recolour with a blend mode
Pass Through is supported as a group blending mode. It applies to a group rather than to a layer, so it is not one of the 27 values above.

​
API reference

For the full request contract behind this page, with runnable examples, see Render a PSD mockup and Render a photo mockup. Errors lists every code these routes can answer with.

Artwork placement

Place, size, rotate and recolour artwork in a design area.

Print areas and surfaces

Where artwork can land on a photo mockup, and how to move it.

Smart filters

How Perspective Warp and the other smart filters render.