set_effect
Apply effects or effect styles to specific nodes in Figma using node IDs. Supports single or batch updates for streamlined design modifications.
Instructions
Set effect(s) directly or by style variable on one or more nodes in Figma.
Returns:
content: Array containing a text message with the updated node(s) ID(s) or a summary.
Input Schema
Name | Required | Description | Default |
---|---|---|---|
entries | Yes | One or more effect set operations to perform. Can be a single object or an array. |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"entries": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"effectStyleId": {
"description": "Optional. The ID of the effect style variable to apply.",
"maxLength": 100,
"minLength": 1,
"type": "string"
},
"effects": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"effectStyleId": {
"description": "The ID of the effect style to apply. Must be a non-empty string. Maximum length 100 characters.",
"maxLength": 100,
"minLength": 1,
"type": "string"
},
"nodeId": {
"description": "The unique Figma node ID to update. Must be a string in the format '123:456' or a complex instance ID like 'I422:10713;1082:2236'.",
"type": "string"
}
},
"required": [
"nodeId",
"effectStyleId"
],
"type": "object"
},
{
"items": {
"$ref": "#/properties/entries/anyOf/0/properties/effects/anyOf/0"
},
"maxItems": 20,
"minItems": 1,
"type": "array"
}
],
"description": "Effect or array of effects to set directly."
},
"nodeId": {
"description": "The unique Figma node ID to update.",
"type": "string"
}
},
"required": [
"nodeId"
],
"type": "object"
},
{
"items": {
"$ref": "#/properties/entries/anyOf/0"
},
"maxItems": 100,
"minItems": 1,
"type": "array"
}
],
"description": "One or more effect set operations to perform. Can be a single object or an array."
}
},
"required": [
"entries"
],
"type": "object"
}