Skip to main content
Permanently remove multiple nodes from the Figma document in a single operation. This is significantly more efficient than calling delete_node repeatedly.

Parameters

string[]
required
Array of node IDs to delete

Response

Returns a result object with details about the deletion operation.

Examples

Delete multiple specific nodes

Delete all text nodes in a frame

Cleanup by node type

Delete nodes matching a condition

Batch delete with progress tracking

Batch Deletion Benefits

Performance

delete_multiple_nodes is optimized for bulk operations:
  • Single round-trip: One WebSocket message instead of N separate calls
  • Atomic operation: All deletions processed together in Figma’s plugin context
  • Reduced overhead: Eliminates per-request latency and validation overhead
  • Progress tracking: Built-in chunking for large deletion sets (100+ nodes)

Efficiency Comparison

Error Handling

Batch deletion continues even if individual nodes fail:

Notes

  • Deletion is permanent and cannot be undone via the API
  • The operation continues even if some nodes fail to delete
  • Results include success/failure status for each node
  • For very large deletions (1000+ nodes), consider batching into groups of 100-200
  • Locked nodes and protected frames will fail to delete but won’t stop the operation
  • Performance scales logarithmically rather than linearly with node count

See Also