UserTesting Figma integration: Setup, permissions, and best practices

This article applies to: UserTesting 

On this page:

• What is the UserTesting Figma integration?
• Why does UserTesting need access to your Figma account?
• What data does UserTesting access?
• What if I don’t want to connect my Figma account?
• Who needs to enable the integration?
• Where to set up the integration
• Disconnecting the integration

What is the UserTesting Figma integration?

The UserTesting Figma integration allows you to test Figma prototypes and gather enriched interaction data, such as click events and heatmaps. This helps you to understand how participants interacted with the screens and components in your prototype.

The Figma integration uses the Figma API and the Figma Embed kit to provide a controlled frame in which participants engage with a Figma prototype and capture data on what elements within the prototype participants interact with. This data is then translated into clear, actionable insights that you can use to assess the usability of your prototypes.

Why does UserTesting need access to your Figma account?

To fully utilize the Figma API and provide enriched interaction data, UserTesting must connect to your Figma account.

What data does UserTesting access?

When you connect the UserTesting Figma integration, you are agreeing to allow UserTesting access to your Figma account, and you are providing permission to:

• Read files you have access to
• Read comments for files you have access to
• Read projects you have access to
• Read components and styles you have access to
• Read your name, email, and profile image

While these are the standard Figma permission terms, in reality in order to retrieve the data events needed, UserTesting only accesses information like frames, images and components within the prototypes you connect.

What if I don’t want to connect my Figma account?

If you want to test a Figma prototype but don’t want to connect your Figma account, you can still use other UserTesting methods like a Navigation task within an Interaction test or the classic UT unmoderated test, which does not require the Figma integration.

Who needs to enable the integration?

Each individual user must enable the integration separately by connecting their Figma and UserTesting accounts.

• Required for:
  • Connecting Figma prototypes in a Figma task.
  • Configuring success paths.
    
    
• Not required for:
  • Configuring tests outside of connecting the prototype.
  • Viewing test results.
  • Using other UserTesting methods like Navigation tasks.

Where to set up the integration

You can connect the Figma integration from:

• • The Integrations tab in Settings.
  • Within the Test Builder, when adding a Figma task.

Disconnecting the integration

• You can disconnect the Figma integration anytime from the Integrations tab in Settings.
• Previously captured Figma task data will remain accessible.

Related content