Edit in GitHubLog an issue

TextLayerCreateOptions

An object literal can be constructed with any of the following properties and passed to Document.createTextLayer. As a type, TextLayerCreateOptions can be used in Typescript development.

Note: When using the position option, keep in mind that the top-left corner of the text layer will vary based on the properties. When using the Text Tool, the click sets the bottom-left corner of the layer. The position option here uses that bottom-left corner. A value of {x: 0, y: 0}` will likely result in the new layer not appearing "on the canvas" since it landed just above at y of 0. For this reason, the default position is the center of the document.

Copied to your clipboard
const options = {
name: "myTextLayer",
contents: "Hello, World!",
fontSize: 24,
position: {x: 200, y: 300}
};
await require('photoshop').app.activeDocument.createTextLayer(options);
NameTypeDefaultMin VersionDescription
blendMode
NORMAL
22.5
Blend mode of the newly created layer or group.
color
NONE
22.5
Label color of the newly created layer or group.
contents
string
"Lorem Ipsum"
24.2
Text content of the newly created text layer.
fontName
string
"MyriadPro-Regular"
24.2
Font PostScript name of the newly created text layer.
fontSize
number
12px
24.2
Font size of the newly created text layer in pixels.
group
boolean
false
22.5
Whether to use previous layer to create clipping mask.
mode
NORMAL
22.5
Deprecated, please use `blendMode` above as it will override this value.
name
string
-
22.5
Name of the newly created layer. If no value is provided, then a name will be generated following the template, "Layer #".
opacity
number
100
22.5
Opacity of the newly created layer or group.
position
document center
24.2
Insertion coordinates of the newly created text layer, in pixels
textColor
black
24.2
Text color of the newly created text layer.
Was this helpful?
  • Privacy
  • Terms of Use
  • Do not sell or share my personal information
  • AdChoices
Copyright © 2025 Adobe. All rights reserved.