capabilities.work

Smart Object Template Personalization

A 6-step recipe with Adobe Photoshop. We can help you get access.

Recipe · 6 steps

Smart Object Template Personalization

Personalize a PSD template by replacing Smart Object content and rendering it.

  1. Request the manifest of the PSD template so the layer tree, layer ids, and Smart Object layers can be confirmed before any write is attempted.
  2. Poll the PSD service status endpoint until the manifest job completes. The submit call returns the absolute status URL in _links.self.href; the jobId this operation requires is the final path segment of that URL, so a runner takes that segm
  3. Replace the embedded content of the named Smart Object layer with the supplied artwork, writing the personalized document out as a PSD.
  4. Poll until the Smart Object replacement job reports succeeded. The jobId is the final path segment of the returned status URL.
  5. Render the personalized PSD to a flat JPEG at the requested width so it can be delivered to a catalog, ad slot, or email template.
  6. Poll until the rendition job reports succeeded and the flat image has been written to the output URL.
What you'll need to have ready
  • templateUrl: Pre-signed GET URL of the source PSD template.
  • smartObjectLayerName: Name of the Smart Object layer to replace (e.g. "product-shot").
  • replacementArtworkUrl: Pre-signed GET URL of the artwork to embed in the Smart Object.
  • replacementMediaType: MIME type of the replacement artwork.
  • psdOutputUrl: Pre-signed PUT URL where the personalized PSD is written.
  • renditionOutputUrl: Pre-signed PUT URL where the flat rendition is written.
  • renditionWidth: Target width in pixels for the flat rendition.
For your developer

Arazzo workflow adobe-photoshop:smart-object-template, 6 operations: getDocumentManifest → getPsdJobStatus → replaceSmartObject → getPsdJobStatus → createRendition → getPsdJobStatus. Specs on APIs.io.