Overview
We use Figma's prototype embed feature when loading Figma prototypes so that your prototypes render exactly as they appear in Figma. This allows you to take advantage of many of their native features, but it also means that you may encounter issues when loading particularly large Figma prototypes or files in Maze.
Mobile device users in particular can struggle to open tests associated with large Figma files or prototypes because of the relatively small amount of memory they have. On iOS devices, the memory limits implemented by Apple may cause the test to time out and crash completely or you may be returned to the welcome screen repeatedly.
For these reasons, we recommend that our customers optimize their Figma prototypes and files to ensure the best possible experience for their testers. Importing your working design file with multiple pages could severely impact loading times and cause issues when importing and testing. This is particularly true if those pages contain large numbers of frames (such as a page containing an icon or component library) or particularly large frames.
If your Figma file contains multiple pages, you'll see the following warning before importing your prototype:
Multiple pages: Files with more than one page may load slowly or time out during testing. Consider using a single page.
Solution
If you're seeing this warning, we recommend creating a dedicated file for testing with Maze:
- Duplicate your working Figma file.
- In the duplicate file, remove all pages except the one that contains the prototype you'll be testing
- Use that copy when testing with Maze.
Removing all pages that are not relevant to testing helps ensure a clean and lightweight testing file for your testers and reduces the risk that they may run into trouble with Figma's prototype embed.