Principle Figma Import Not Working

How to fix it

// try these in order, the most common fix is first

1. FIX 1Sign out and back in to Figma

   Copy steps
   1. 01Open Principle > Settings and disconnect your Figma account
   2. 02Quit Principle, reopen it and sign in again
   3. 03Retry the import
   Did this fix it? Yes No

2. FIX 2Update Principle

   Copy steps
   1. 01Principle > Check for Updates
   2. 02Install the latest 6.x version and retry
   Did this fix it? Yes No

3. FIX 3Use copy and paste instead

   Copy steps
   1. 01In Figma select the frames, Cmd+C
   2. 02In Principle paste onto the canvas with Cmd+V
   Did this fix it? Yes No

4. FIX 4Turn off VPN or proxy

   Copy steps
   1. 01Disable VPN, retry import
   2. 02Check figma.com loads in a browser
   Did this fix it? Yes No

Symptoms

Import dialog spins on "Getting documents", shows a connection error, or your file list is empty.

Why it happens

• C-01Expired Figma login token inside Principle
• C-02Figma-side API problem (reported and later fixed in Oct 2025)
• C-03Outdated Principle build
• C-04Firewall, VPN or proxy blocking the Figma API

// this guide also covers

• principle figma import not working
• principle for mac figma import
• principle getting documents figma

Other Principle errors

• Principle for Windows: Is There a Version?
• Principle Mirror Not Connecting to iPhone
• Principle Video or GIF Export Not Working
• Principle Share to Web Not Working
• Principle App Crashing or Running Slow
• Principle License Renewal and Updates Explained
• Cancel Principle and Get a Refund
• Principle .prd File Won't Open