What gets indexed
- Design files - File names, page names, and document structure
- Components - Component names and descriptions
- Text content - All text elements within designs
- Comments - Comment threads, replies, and resolution status
- FigJam boards - Same content types as design files
Both Figma design files and FigJam boards are indexed. The connector extracts text content directly from TEXT nodes in your designs, making your copy searchable.
Setup
Connect to Grapevine
- In Grapevine, go to Integrations and click on Figma
- Click Connect Figma Account to begin the authorization process
Authorize connection
- You’ll be redirected to Figma to authorize the Grapevine integration
- Log into Figma if needed
- Review the requested permissions
- Click Allow access to grant access
Select teams
- After authorization, you’ll be redirected back to Grapevine
- Select which Figma teams you want to index
- Click Save to confirm your selection
Permissions
- All indexed Figma content is visible to all users in the Grapevine tenant
- Admin permissions required for initial setup
Sync behavior
- Initial sync - Indexes all files from selected teams
- Real-time updates - Via webhooks for file updates, deletions, and new comments (paid plans only)
- Periodic sync - Runs periodically to catch any missed updates and sync teams without webhook support
- Deletions - Deleted files are removed from the index automatically
Rate limits
Figma enforces API rate limits that vary based on your seat type and plan. The user who connects Figma to Grapevine must have a Dev or Full seat for acceptable performance.Dev/Full seat rate limits
| Tier | Starter | Professional | Organization | Enterprise |
|---|---|---|---|---|
| Tier 1 | 10/min | 15/min | 20/min | 20/min |
| Tier 2 | 25/min | 50/min | 100/min | 100/min |
| Tier 3 | 50/min | 100/min | 150/min | 150/min |
View/Collab seat rate limits (not recommended)
| Tier | Starter | Professional | Organization | Enterprise |
|---|---|---|---|---|
| Tier 1 | 6/month | 6/month | 6/month | 6/month |
| Tier 2 | 5/min | 5/min | 5/min | 5/min |
| Tier 3 | 10/min | 10/min | 10/min | 10/min |
For the best experience, ensure the user connecting Figma has a Dev or Full seat on a Professional or higher plan. This provides both real-time webhooks and adequate API rate limits for syncing.
Limitations
- Real-time webhooks require Figma Professional plan or higher (Starter/Free plans use periodic sync only)
- Rate limits may slow initial sync for large workspaces
- File attachments and embedded images are not indexed (only text and metadata)
- Only files from selected teams are indexed