# Figma Node

### Overview

The Figma Loader Node allows you to extract content and metadata from Figma components (nodes). It enables access to specific elements within Figma designs through node IDs, making it useful for incorporating design content and specifications into your flow.

Usage cost: 1 credit

### Configuration

#### Settings

1. **Authentication**
   * Figma Tool\*: Select a configured Figma integration
     * Must be set up in Knowledge & Tools section
     * Contains API access token
2. **File Configuration**
   * File Key\*: Unique identifier of the Figma file
     * Found in Figma file URL: `figma.com/file/{file_key}/filename`
   * Node IDs\*: Specific elements to extract
     * Comma-separated without spaces
     * Can specify multiple elements

#### Output Ports

1. `documents` (List\[Document]):
   * List of Document objects containing Figma elements
   * Includes content and metadata
   * Element properties and specifications
2. `documents_content` (List\[string]):
   * Extracted text content from elements
   * Raw content without metadata

### Best Practices

1. **File Access**
   * Ensure file sharing permissions are correct
   * Use appropriate view access levels
2. **Performance**
   * Limit number of nodes per request

### Common Issues

* Authentication token expiration
* Invalid file keys
* Incorrect node IDs
* File access permission errors


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.waterflai.ai/studio/studio-builders/flow-components-nodes/figma-node.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.