Why Connect Figma?

Much of the work between product and design happens inside Figma, in version history and, especially, in comments. Connecting Figma brings that activity into Samepage so Product Managers can track design progress without living in comment view. By connecting Figma, Samepage users can:

Build Signals that summarize recent design activity, decisions, and open questions
Spot comments awaiting a response so they can unblock design faster
Draft weekly updates, standups, and release notes that include design progress
Use the Samepage Copilot to answer questions or draft documents informed by Figma data

Integration Type

Personal integration. Each user connects their own Figma account using a personal access token. The Figma data imported is private to that user and not visible to others in the workspace. To see Figma data in their own account, each user must generate their own token, connect it, and wait for an import.

Data Imported

Samepage views and imports the following from Figma:

Comments: Comment text and author, a link back to the associated file, frame, or element, and the reactions on each comment
File versions: Version history for connected files, including who made a change and when, with a link to the file

This data is used to help Product Managers track design progress, surface open questions and feedback, and include design updates in their summaries.

Sync Behavior

Initial sync imports comments and version history from the projects and files you connect. Because Figma enforces strict API rate limits, the first import can take a while. Roughly 10 minutes is normal, even for a smaller account.
Ongoing syncs pull new comments and version activity for your connected projects on a recurring basis.

How to Connect

You must have an existing Samepage account. If you need one, sign up at samepage.ai.
Go to the Integrations page in Samepage and find Figma.
Create a Figma personal access token.
In Figma, click on your profile in the top-left and choose Settings (this is the same in the desktop app and the web version).
In the pop-up, select the Security tab and scroll down to Personal access tokens.
Click Generate new token, name the token, and set an expiration. Figma allows a maximum of 90 days, so you will need to repeat this every few months when the token expires.
Check the box to enable the five read-only scopes Samepage needs:

Current user (current_user:read)
File comments (file_comments:read)
File content (file_content:read)
File versions (file_versions:read)
Projects (projects:read)

Paste your token into Samepage and click Test Token to verify it. This also confirms the required scopes are enabled.
Tell Samepage which projects to import. Figma does not allow apps to list your files automatically, so you point Samepage at them by link. You connect multiple teams or projects:
To share all projects in a team: in Figma, select the team in the left sidebar and click All projects. At the top, click the small arrow next to the team name and choose Copy link. Paste that link into Samepage. This is a team link, with a URL like figma.com/files/team/<id>/all-projects. You can add multiple links.
To share a single project: open the project, click the arrow next to the project name, and choose Copy link. Paste that link into Samepage instead.
You can add more than one link. Samepage imports exactly what you point it to.
Click Continue. Samepage will begin importing your Figma data. The initial import can take around 10 minutes due to Figma's rate limits.

What You Can Do After Connecting

Create Signals that track design activity, e.g., "Summarize recent design progress" or "Which Figma comments are still awaiting a response?"
Chat with Copilot about Figma data, e.g., "What did design change this week?" or "What open questions are designers waiting on me to answer?"
Combine with other data by cross-referencing Figma comments with Slack discussions, Linear tickets, or meeting notes for a complete view of design work

Signal Examples Using Figma

Signal	What It Does
Design Progress Digest	Summarizes recent design changes and discussion across connected Figma projects
Awaiting Your Reply	Surfaces comments directed at you or left unanswered so you know where design is blocked
Feedback Sentiment Tracker	Rolls up reactions and comment sentiment to highlight what landed well and what's contested
Weekly Design Update	Drafts a concise design section for your weekly update, with links to the relevant files and comments

Example Signal Prompt

Here's a detailed prompt you can paste into a Signal's instructions field to get a design progress overview:

Summarize the recent activity in Figma, including key design changes, team discussions from comments, and any patterns in reactions or feedback sentiment. Focus on what's changed, what decisions were made (or are still pending), and any unresolved issues or next steps.

What Changed: Summarize notable updates to connected files based on recent version history and comments. Note who made the change where it's clear.

Discussion & Decisions: Pull out the substantive threads from comments. Call out decisions that were made and questions that are still open.

Awaiting You: Flag comments that appear to be waiting on a response, especially anything directed at the PM, so nothing blocks design.

Sentiment: Note where reactions and replies were clearly positive or where a thread is unresolved or contested.

Keep it to a concise summary. Embed links to the relevant Figma files and comments wherever possible so I can jump to the source.

FAQ

Does this integration provide clickable links back to the source? Yes. Figma comments and file versions include links that take you to the associated file, frame, or element in Figma. When Signals or Copilot reference Figma activity, you can click through to view it in Figma itself.

Why do I have to create a personal access token instead of just logging in? Figma's API access for the data Samepage needs is provided through personal access tokens rather than a one-click login. You generate a token in your own Figma settings, choose its scopes, and paste it into Samepage. The Test Token button confirms the token works and has the right scopes before you continue.

Which scopes does my token need? Five read-only scopes, in the order Figma lists them: Current user (current_user:read), File comments (file_comments:read), File content (file_content:read), File versions (file_versions:read), and Projects (projects:read). Set each to Read. Samepage only ever reads this data. The connection screen shows the scope names in a tooltip, and Test Token will tell you if any are missing.

Why do I have to paste in project links? Can't Samepage just find my files? No. Figma does not allow third-party apps to list all of the files in an account automatically. To work within that, you tell Samepage which projects to import by pasting links: the All projects link to bring in everything, or individual project links to limit the scope. You can add as many links as you like.

Can I limit which projects Samepage imports? Yes. Instead of the All projects link, paste the link to just the specific projects you want (for example, only Marketing or Website). Samepage imports exactly what you point it to, and you can add more links later.

Why does the first import take so long? Figma enforces strict API rate limits on how quickly data can be exported. As a result, the initial import can take around 10 minutes, even for a smaller account. Once the first import finishes, ongoing syncs keep your data current.

My token expired, what happens? Figma tokens last a maximum of 90 days. When a token expires, generate a new one in Figma and reconnect it in Samepage to resume syncing.

Privacy

Figma data is never used to train AI models. Data is processed only to generate Signal outputs and Copilot responses.

Figma Integration