Troubleshooting

Solutions for common GitFig issues.

Authentication Issues

"Authorization pending" won't go away

• Complete authorization on GitHub
• Check correct GitHub account
• Get a new device code

"Session expired"

Device codes expire after 15 minutes. Start again.

Wrong account connected

1. Sign out from GitFig
2. Revoke at github.com/settings/applications
3. Sign in with correct account

Sync Issues

No variables created

• Check JSON has $value fields
• Verify file mappings configured
• Check browser console for errors

Variables not updating

• Click Pull after changes
• Check correct branch
• Verify JSON file changed

Push fails

• Check write access to repo
• Branch may be protected
• Token may have expired

Connection Issues

"Repository not found"

• Use owner/repo format
• Verify repo access
• Check spelling

"Branch not found"

• Click Refresh for branch list
• Create branch on GitHub first

CORS Errors

"Access-Control-Allow-Origin" error

• Server may need redeployment
• Check oauth.gitfig.com is accessible
• Try again in a few minutes

Performance Issues

Sync is slow

• Large JSON files take longer
• Many variables = more processing
• Network affects API calls

Plugin unresponsive

• Close and reopen plugin
• Check Figma memory usage
• Restart Figma if needed

Understanding Error Messages

GitFig provides actionable error messages. Here's what common messages mean:

Error Message	Cause	Solution
"Authentication expired"	GitHub token invalid	Sign out and sign back in
"Permission denied"	Insufficient repo access	Check repo permissions, try signing out/in
"Rate limit reached"	Too many GitHub API calls	Wait a few minutes, then retry
"Network error"	Connection issue	Check internet, try again
"Repository not found"	Repo doesn't exist or no access	Verify repo name and permissions
"Branch already exists"	Duplicate branch name	Choose a different branch name
"Invalid JSON"	Syntax error in token file	Check file for JSON syntax errors
"No file mappings"	Missing configuration	Go to Settings to map JSON files

Still Having Issues?

If your issue isn't covered above:

1. Check the browser console (Figma DevTools) for error messages
2. Note the exact steps to reproduce the issue
3. Ask in the GitFig Community Q&A
4. Or report a bug in Bug Reports

The community is the fastest way to get help and connect with other GitFig users.