Skip to content
TeamLoop

Figma Integration

Connect Figma to search design files, track version history, and capture design feedback across your teams.

What You Can Query

Section titled “What You Can Query”
Content TypeDescription
Design FilesFigma files with page structure
VersionsNamed version history and checkpoints
CommentsDesign feedback and review threads
ProjectsFile groupings within teams
PagesTop-level pages within design files

Connecting Figma

Section titled “Connecting Figma”
  1. Log into TeamLoop at app.teamloop.io
  2. Navigate to Settings > Integrations
  3. Click Connect next to Figma
  4. Enter your Figma Personal Access Token (PAT)
  5. TeamLoop validates the token and saves it encrypted

Creating a Figma PAT

Section titled “Creating a Figma PAT”
  1. Go to figma.com/settings
  2. Scroll to Personal access tokens
  3. Click Generate new token
  4. Give it a description (e.g., “TeamLoop”)
  5. Copy the token and paste it into TeamLoop

Your PAT provides read access to all teams and files your Figma account can access. We never modify your design files.

Example Queries

Section titled “Example Queries”

Search Design Files

Section titled “Search Design Files”
teamloop_query:
  query: "mobile app redesign"
  sources: "figma"

Find Design System Components

Section titled “Find Design System Components”
teamloop_query:
  query: "design system button components"
  sources: "figma"

Track Design Feedback

Section titled “Track Design Feedback”
teamloop_query:
  query: "checkout flow review comments"
  sources: "figma"

Automatic Change Tracking

Section titled “Automatic Change Tracking”

TeamLoop automatically tracks changes from Figma via the version history API.

Version Timeline

Section titled “Version Timeline”

When you query a design file, TeamLoop fetches its version history:

  • Named versions (save points)
  • Version descriptions
  • Author of each version
  • Timestamps for every version checkpoint

Comment Activity

Section titled “Comment Activity”

Design review comments are captured with:

  • Comment text and author
  • Thread context
  • Timestamps

Entity Extraction

Section titled “Entity Extraction”

Figma content maps to TeamLoop entity types:

Figma ContentTeamLoop Entity
Design fileDOCUMENT
ProjectPROJECT
CommentDOCUMENT
VersionCHANGE
Comment authorPERSON

Temporal Queries with Figma

Section titled “Temporal Queries with Figma”

Point-in-Time

Section titled “Point-in-Time”

See what design files were known on a specific date:

teamloop_query:
  query: "onboarding flow"
  sources: "figma"
  mode: "as_of"
  as_of: "2024-06-01"

Evolution

Section titled “Evolution”

Track how a design evolved over time:

teamloop_evolution:
  query: "mobile app design"
  from_date: "2024-01-01"
  to_date: "2024-06-30"

Troubleshooting

Section titled “Troubleshooting”

No Results

Section titled “No Results”
  • Verify the Figma integration is connected
  • Check that your Figma account has access to the team
  • Try broader search terms
  • Figma search matches on file names

Missing Files

Section titled “Missing Files”
  • Check team membership in Figma
  • Ensure your account can access the project
  • Files in other teams require your account to be a member of those teams

Security

Section titled “Security”
  • API tokens are encrypted at rest using pgcrypto
  • Tokens can be revoked from Figma settings
  • TeamLoop only reads, never writes
  • You can disconnect at any time from TeamLoop settings
  • Connected tokens show a hint so you can identify which token is in use

Next Steps

Section titled “Next Steps”