capabilities.work

Text Layer Personalization

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

Recipe · 6 steps

Text Layer Personalization

Rewrite a PSD text layer with new copy and styling, then render it.

  1. Request the document manifest so the text layer names, ids, and existing content can be confirmed before rewriting copy.
  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. Rewrite the named text layer with the supplied copy, character style, and paragraph alignment, writing the edited document out as a PSD.
  4. Poll until the text edit job reports succeeded. A failed status here most often means the requested font was unavailable and manageMissingFonts was set to fail.
  5. Render the personalized PSD to a flat PNG for delivery.
  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.
  • textLayerName: Name of the text layer to edit (e.g. "headline").
  • textContent: The replacement text string to set on the layer.
  • fontPostScriptName: PostScript name of the font to apply to the text.
  • fontSize: Font size to apply to the text.
  • alignment: Paragraph alignment for the text layer.
  • manageMissingFonts: Behavior when a font is unavailable, fail or useDefault.
  • psdOutputUrl: Pre-signed PUT URL where the edited PSD is written.
  • renditionOutputUrl: Pre-signed PUT URL where the flat rendition is written.
For your developer

Arazzo workflow adobe-photoshop:text-layer-personalization, 6 operations: getDocumentManifest → getPsdJobStatus → editTextLayer → getPsdJobStatus → createRendition → getPsdJobStatus. Specs on APIs.io.