> For the complete documentation index, see [llms.txt](https://help.dscout.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.dscout.com/integrations/figma-integration/set-up-the-figma-integration.md).

# Set up the Figma integration

With Dscout’s Figma integration, you can take your usability tests to the next level by letting your participants interact directly with your design concepts and prototypes. The integration also allows Dscout to collect click event data and generate heat maps you can use during analysis.

{% hint style="info" %}
**Note:** It is possible to add prototypes to usability tests without the Figma integration. However, analysis won’t include click event data or heat maps.
{% endhint %}

## Requirements

To use the Figma integration, you’ll need:

* A Figma account.
* Access to the Figma files you want to use in Dscout missions.

{% hint style="info" %}
**Note:** The Figma integration is enabled on the user level rather than the account level. This means individual teammates can choose to connect to Figma or disconnect at any time.
{% endhint %}

## Connect Dscout to Figma

You can connect Dscout to your Figma account from within your profile settings or directly within the builder when creating a usability test.

{% hint style="success" %}
**Tip:** Connect Dscout to Figma before adding prototypes to your missions. If you’ve already added prototypes, be sure to re-sync them once you’ve connected to Figma to collect click event data and generate heat maps. For more information, see [Re-sync a prototype](/study-basics/testing-prototypes/add-a-figma-prototype-to-a-study.md#h_01K49QBWD3TW1JKRAQH7N5R4K1).
{% endhint %}

**To connect to Figma from your profile settings:**

{% stepper %}
{% step %}
On the [**Profile settings**](https://app.dscout.com/settings/profile) page, click **Integrations** in the left sidebar.
{% endstep %}

{% step %}
Under Figma, click **Connect Figma account**.

![](/files/5387547684bbb522859b4d258d444d0ea1195a00)
{% endstep %}

{% step %}
Log in to your Figma account, granting Dscout access when prompted.
{% endstep %}
{% endstepper %}

Now, you’re returned to your profile settings where you’ll see a **Connected** badge letting you know the integration was successfully enabled. Next, add a prototype to a usability test! For more information, see [Add a Figma prototype to a study](/study-basics/testing-prototypes/add-a-figma-prototype-to-a-study.md).

![](/files/404cdb3b06f7b59b75c809ebd25ad338bd85732b)

**To connect to Figma from within a usability test:**

{% stepper %}
{% step %}
Navigate to the **Usability test** tab of your study.
{% endstep %}

{% step %}
Click **Task URLs** at the top of the builder. The **Manage Task URLs** modal is displayed.

![](/files/a1e32e6a4d7588baa8d1e5f687895d241854b099)
{% endstep %}

{% step %}
Click **Manage Figma integration**.

![](/files/1eaf39f3ddeef45f26dadfa08028ef08cab493d5)
{% endstep %}

{% step %}
Click **Connect Figma**.

![](/files/2837c28ac7c7754df88756953b8d6ef4ecbde5fd)
{% endstep %}

{% step %}
Log in to your Figma account, granting Dscout access when prompted.
{% endstep %}
{% endstepper %}

Now, you’re returned to your usability test where you’ll see a **Connected** badge letting you know the integration was successfully enabled. Next, add a prototype to a usability test! For more information, see [Add a Figma prototype to a study](/study-basics/testing-prototypes/add-a-figma-prototype-to-a-study.md).

![](/files/53aeb6cea11e0ac726c282e157c0f71aa5aca084)

## Disconnect Dscout from Figma

If you wish to disconnect Dscout and your Figma account, you can do so at any time from either your profile settings or from within a usability test.

{% hint style="info" %}
**Note:** Any prototypes added prior to disconnecting your Figma account will remain connected, meaning they will still collect click event data and generate heat maps. If you wish to disconnect these prototypes, you can delete them from your missions individually.
{% endhint %}

**To disconnect Figma from your profile settings:**

{% stepper %}
{% step %}
On the [**Profile settings**](https://app.dscout.com/settings/profile) page, click **Integrations** in the left sidebar.
{% endstep %}

{% step %}
Under Figma, click **Disconnect Figma account**. A confirmation modal is displayed.

![](/files/5b47dbe1e6f3ccffb4345972a3d139a96da34e45)
{% endstep %}

{% step %}
Click **Disconnect** to confirm.
{% endstep %}
{% endstepper %}

Now, Dscout is no longer connected to your Figma account. You can reconnect at any time by repeating the process above.

**To disconnect Figma from within a usability test:**

{% stepper %}
{% step %}
Navigate to the **Usability test** tab of your study.
{% endstep %}

{% step %}
Click **Task URLs** at the top of the builder. The **Manage Task URLs** modal is displayed.

![](/files/a1e32e6a4d7588baa8d1e5f687895d241854b099)
{% endstep %}

{% step %}
Click **Manage Figma integration**.

![](/files/1eaf39f3ddeef45f26dadfa08028ef08cab493d5)
{% endstep %}

{% step %}
Click **Disconnect Figma**. A confirmation modal is displayed.

![](/files/99590edf0869f07b46244a9f3d31546e1ee88e07)
{% endstep %}

{% step %}
Click **Disconnect** to confirm.
{% endstep %}
{% endstepper %}

Now, Dscout is no longer connected to your Figma account. You can reconnect at any time by repeating the process above.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.dscout.com/integrations/figma-integration/set-up-the-figma-integration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.