When importing and using Figma prototypes, you might run into certain issues. Follow our advice to ensure your prototype works as expected in Maze.
Our team has been continuously working to make our Figma integration as smooth as possible. If you have any feedback about the current limitations, or are running into issues that you believe go beyond them, please reach out to our team — we'll be happy to help!
Security and privacy
Importing
- Why am I seeing a "File is too large" warning when I import my Figma prototype?
- Why am I seeing a "Large images" warning when I import my Figma prototype?
- Why am I seeing a "Restricted Figma file" or a "The prototype is not available" error when I try to import my Figma prototype?
- Why am I seeing a "Missing screens or interactions" error when I try to import my Figma prototype?
- Why am I seeing a "Large frames" error when I import my Figma prototype?
- Why am I seeing a "Multiple pages" warning when I import my Figma prototype?
- Why am I seeing a “Linking prototype failed, something went wrong” error?
- Why isn't my Figma prototype loading in the prototype preview in Safari?
- When importing a Figma prototype, you'll see hotspot hints in the Build mode preview. Despite that, hotspot hinting doesn't work in the maze preview or in the live maze — even if you have hotspot hinting enabled in your Figma prototype. The goal is to avoid introducing bias when testers complete the task.
Prototype
- Why can't I find all screens from my prototype in Maze?
- Why is the fixed footer not displaying correctly in my maze test?
- Maze doesn't formally support variables. Testing prototypes with variables may lead to unexpected behavior, especially when viewing results.
Publishing
- Why am I getting an "Invalid mission path" error when I try to launch my maze live?
- Why am I getting a "Duplicated pages" error when I try to launch my maze live?
- Why am I getting a "Missing page" error when I try to launch my maze live?
- Why am I getting an "Invalid blocks" error when I try to launch my maze live?
Opening mazes
- Why is my maze not loading after importing a Figma prototype?
- Why do testers see a “This maze cannot be explored right now” error?
Known limitations when using interactive components
- Why am I getting an "Invalid mission path" error when I try to launch my maze live?
- Why are my testers getting stuck on my prototype with interactive components?
- Why are my interactive components with overrides displaying the default version of the component in the results and report?
- Why are the results for certain missions not being recorded?
Best practices
We recommend checking out our best practices for optimizing your Figma files for Maze: Creating a Maze-ready Figma prototype
Still need help?
If you have any questions or concerns, please let our Support team know — we'll be happy to help!