Layer

Layer from Adobe Illustrator API

Creative CloudDesignIllustratorVector Graphics

Properties

Name	Type	Description
id	string	Unique identifier of the layer.
name	string	Name of the layer.
visible	boolean	Whether the layer is visible.
locked	boolean	Whether the layer is locked.
printable	boolean	Whether the layer is printable.
preview	boolean	Whether the layer is in preview mode.
dimPlacedImages	boolean	Whether to dim placed images.
color	string	The layer highlight color.
opacity	number	Layer opacity as a percentage (0-100).
blendingMode	string	Blending mode for the layer.
isClippingMask	boolean	Whether the layer is a clipping mask.
sliced	boolean	Whether the layer is sliced.
hasSelectedArtwork	boolean	Whether the layer contains selected artwork.
pathItemCount	integer	Number of path items in the layer.
textFrameCount	integer	Number of text frames in the layer.
sublayerCount	integer	Number of sublayers.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/adobe-illustrator/refs/heads/main/json-schema/adobe-illustrator-scripting-layer-schema.json",
  "title": "Layer",
  "description": "Layer from Adobe Illustrator API",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique identifier of the layer.",
      "example": "example_value"
    },
    "name": {
      "type": "string",
      "description": "Name of the layer.",
      "examples": [
        "Layer 1"
      ],
      "example": "Example Artboard"
    },
    "visible": {
      "type": "boolean",
      "description": "Whether the layer is visible.",
      "example": true
    },
    "locked": {
      "type": "boolean",
      "description": "Whether the layer is locked.",
      "example": true
    },
    "printable": {
      "type": "boolean",
      "description": "Whether the layer is printable.",
      "example": true
    },
    "preview": {
      "type": "boolean",
      "description": "Whether the layer is in preview mode.",
      "example": true
    },
    "dimPlacedImages": {
      "type": "boolean",
      "description": "Whether to dim placed images.",
      "example": true
    },
    "color": {
      "type": "string",
      "description": "The layer highlight color.",
      "enum": [
        "Red",
        "Orange",
        "Yellow",
        "Green",
        "Blue",
        "Violet",
        "Gray",
        "LightBlue",
        "LightGreen",
        "LightRed"
      ],
      "example": "Red"
    },
    "opacity": {
      "type": "number",
      "description": "Layer opacity as a percentage (0-100).",
      "minimum": 0,
      "maximum": 100,
      "example": 72.0
    },
    "blendingMode": {
      "type": "string",
      "description": "Blending mode for the layer.",
      "enum": [
        "Normal",
        "Multiply",
        "Screen",
        "Overlay",
        "Darken",
        "Lighten",
        "ColorDodge",
        "ColorBurn",
        "HardLight",
        "SoftLight",
        "Difference",
        "Exclusion",
        "Hue",
        "Saturation",
        "Color",
        "Luminosity"
      ],
      "example": "Normal"
    },
    "isClippingMask": {
      "type": "boolean",
      "description": "Whether the layer is a clipping mask.",
      "example": true
    },
    "sliced": {
      "type": "boolean",
      "description": "Whether the layer is sliced.",
      "example": true
    },
    "hasSelectedArtwork": {
      "type": "boolean",
      "description": "Whether the layer contains selected artwork.",
      "example": true
    },
    "pathItemCount": {
      "type": "integer",
      "description": "Number of path items in the layer.",
      "example": 1024
    },
    "textFrameCount": {
      "type": "integer",
      "description": "Number of text frames in the layer.",
      "example": 1024
    },
    "sublayerCount": {
      "type": "integer",
      "description": "Number of sublayers.",
      "example": 1024
    }
  }
}