# Figma

<figure><img src="https://823733684-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F00tYLwhz5RyR7fJEhrWy%2Fuploads%2Fgit-blob-2163a982d3e3daf6efa9c3dd7718fc79fe70c369%2Fimage%20(8)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1).png?alt=media" alt="" width="264"><figcaption><p>Figma Node</p></figcaption></figure>

Figma is a collaborative web application for interface design. This module provides functionality to load and process content from Figma files, including text, components, and metadata.

This module provides a sophisticated Figma document loader that can:

* Load content from specific Figma files
* Extract text from selected nodes
* Process content recursively
* Handle authentication with Figma API
* Process content with text splitters
* Customize metadata extraction

## Inputs

### Required Parameters

* **File Key**: The unique identifier for the Figma file (from file URL)
* **Node IDs**: Comma-separated list of node identifiers to extract
* **Connect Credential**: Figma API credentials (access token)

### Optional Parameters

* **Recursive**: Whether to process nodes recursively
* **Text Splitter**: A text splitter to process the extracted content
* **Additional Metadata**: JSON object with additional metadata
* **Omit Metadata Keys**: Comma-separated list of metadata keys to omit

## Outputs

* **Document**: Array of document objects containing metadata and pageContent
* **Text**: Concatenated string from pageContent of documents

## Features

* API-based content extraction
* Node-level content selection
* Recursive processing
* Text splitting support
* Metadata customization
* Error handling
* Authentication management

## File Key Format

The file key can be found in the Figma file URL:

```
https://www.figma.com/file/:key/:title
```

Example: In `https://www.figma.com/file/12345/Website`, the file key is `12345`

## Node IDs

To get Node IDs:

1. Install the Node Inspector plugin in Figma
2. Select the desired elements
3. Copy the Node IDs from the inspector
4. Use comma-separated format: "0, 1, 2"

## Notes

* Requires valid Figma access token
* Node IDs must be valid for the file
* Supports recursive content extraction
* Can process multiple nodes at once
* Handles API rate limits and errors
* Preserves node hierarchy in metadata
* Supports custom metadata addition