Figma

We use Figma at Linear and our integration makes it easy for you to collaborate on design.

Overview

The Figma integration embeds artboards or files into Linear descriptions and comments. They can be previewed in Linear or clicked to open the file in Figma.

Configure

Connect to Figma under Settings > Workspace > Integrations > Figma. We recommend that you do this in a browser and not the desktop client. Once connected, the integration will work across your full workspace.

Basics

Embed files

Simply copy a link to a specific artboard or file and paste it into a Linear issue description or comment. We automatically convert the link into a design preview. Even if the file changes, the snapshot in Linear remains as it appeared when the comment or description was created.

Open files

Click to preview the embedded file without having to leave Linear. We currently support interactive in-app preview of publicly shared Figma files only. We're considering building support for private files in the future. We built this as a custom integration using Figma's API with their OAuth2 authentication instead of using their standard embed to create a faster experience.

Refresh files

By default, we do not refresh the Figma preview so that you maintain the context of related comments and issue descriptions. To update the preview, go into Edit mode in the issue or comment, then hover over the Figma file. You'll see a Refresh button appear, which you can click to pull the latest version. This action cannot be undone.

Loading

It can still take some time to load the files and is one of the few places in the app where you might see a loading icon.

FAQ

My Figma integration stopped working. How do I fix it?

First, check that the Figma integration is connected in settings. We'll disable integrations if we notice they're not working anymore (admins should receive an email if we do) and it's also possible that someone on your team removed the integration, intentionally or not.

If the Figma integration is enabled and it's still not working, try removing and then reconnecting the integration.

1. Open Linear in the browser and remove the integration.
2. Go to linear.app/reset
3. Reconnect to Figma via the browser.

Reach out to us in support if you still have trouble after taking those steps.

Can I collapse or hide the Figma embed?

By default, any Figma links added to Linear will embed and there is no way to hide it. The workaround is to hyperlink text in a comment or description instead of pasting the full link.

I keep getting prompted to login to Figma yet cannot view the preview. Help?

We've noticed this issue specifically for If your Brave shield is up you must manually allow "cross-site cookies" to be able to view authenticated Figma embeds.

I'm seeing the error message "unable to embed from Figma" when linking a Figma file.

This error message typically also references "Insufficient permissions to access the file". While you yourself may have access to the file, it's important that the installer of the Figma integration in Linear also has access to the file. If they don't this error message will appear. The solution here is to share the file with the team member who installed the Figma integration.