Skip to main content

Support for large files using the Maze plugin in Figma

Laura Cunha
  • Updated

The Maze plugin in Figma makes it faster and more reliable to import very large Figma files into Maze.

Requirements

  • Users on all plans can install and use the Maze plugin in Figma.
  • You must have an Editor role in your Figma team to access the plugin.
  • We recommend running the plugin in the Figma desktop app, rather than the web version. The plugin’s performance tends to be better when used within the Figma desktop app.

When should I use the plugin?

Use the Maze plugin in Figma to import large files, especially if they take a long time or fail to import.

After importing a Figma file, there isn’t a difference in functionality depending on the import method (i.e. between the regular import or the import using the plugin).

How to run the Maze plugin in Figma

To run the plugin:

  1. Open the Maze plugin page in Figma community. 
  2. Click Open.
    figma-community-maze-plugin.jpg

Alternatively, open Figma > Plugins > Manage plugins… Search for Maze and click Run.

Why can’t I find the plugin?

If your Figma organization has plugin approval enabled, an admin must approve the Maze plugin before you can run it.

Learn more about approved plugins in the Figma documentation

How to import files using the plugin

Prevent breaking changes in your prototype after importing it into Maze. Due to technical restrictions, breaking changes aren’t flagged for prototypes imported via the plugin. Learn more

To import files using the plugin:

  1. Open the maze where you want to use the Figma prototype.
  2. Follow the steps to add a Figma prototype.
    maze-builder-prototype-test-link-file.jpg
  3. Paste your Figma link and click Import with plugin.
    maze-builder-prototype-test-import-figma-with-plugin.jpg
  4. Click Copy plugin link.
    maze-builder-prototype-test-plugin-import-copy-link.jpg
  5. Open your Figma file and run the Maze plugin.
  6. Paste the secure plugin link you copied in Step 4 (e.g. https://maze-prototypes.maze.co/import/figma-plugin/...) and click Next.
    You must click the Copy plugin link button mentioned in Step 4. Your regular maze share link won't work: if your pasted link looks like https://t.maze.co/..., the import will fail.
    figma-plugin-paste-plugin-link.jpg
  7. Select the flows you’d like to import and click Next.
    figma-plugin-select-flows.jpg
  8. You should see a loader showing the import progress. Import may take a few minutes.
    figma-plugin-import-in-progress.jpg
  9. When you reach the success screen, click Close, and return to Maze to continue setting up your test.
    figma-plugin-import-successful.jpg

Learn more about importing your Figma files into Maze

Still need help?

If you have any questions or concerns, please let our Support team know — we'll be happy to help!

Related articles