# Figma

Figma is a great tool to create and discuss designs in a cross-functional setting. Finally, with Kitemaker, everyone working on the same work item will quickly discover and join discussions happening in Figma.

{% hint style="info" %}
Kitemaker will always pull designs from Figma when you paste them into descriptions and comments. However, you need to set up the integration to get the full set of features.

To install the integration, go to "Organization settings" in the ⚙️ menu next to your organization name and click on “Integrations” in the side bar, or search for “Integration settings” the Kitemaker command (`cmd/ctrl`+`k`). Then select the Discord or Slack integration and follow the installation steps. Then select Figma to set the integration up to make all the magic happen.
{% endhint %}

## Reference work items from Figma

Suppose a discussion happening in Figma is relevant for a work item. In that case, you can simply reference the work item by it’s number, and the comment will appear in the work item’s activity feed, and the members will be notified. To do this, copy the work item number (Ctrl+I or ⌘+I) and add it to the comment in Figma. This creates an activity with the content of your comment and a link to it. We will also notify any assignees or watchers about the update. This is a great way to ensure that the team never loses a relevant discussion or comment.

## Embed designs in work items

When Figma designs are embedded into a work item or theme description, then two magical things will happen:

1. The thumbnail will automatically update after design changes
2. New comment threads in the embedded design will appear in the activity feed.

<figure><img src="/files/AHBtEq8mTjX8uHrHg6WD" alt=""><figcaption></figcaption></figure>

Please note that embedding designs are ‘node’ dependent. Meaning:

* If you link to a Figma file, all comments in the file will be shown in the work item
* If you link to a page in a Figma file, only comments on that page will be shown in the work item
* If you link to a single node (or frame), only comments inside that node (or frame) will be shown in the work item.

<figure><img src="/files/FIwGWH7bgQjPrhvO7NM9" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Please note that the updates do not happen in real-time, and it may take a minute for files and comments to show up in Kitemaker.
{% endhint %}


---

# 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://guide.kitemaker.co/integrations/figma.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.