You should refresh the prototype in your draft maze every time you change your prototype.
This will fetch the latest version of the prototype, while maintaining all blocks and paths in the draft maze.
How to refresh your prototype
When you refresh a prototype, Maze downloads the latest data from your design file.
To get the latest version of a prototype in your maze:
- Open the draft maze that contains the prototype to be updated.
- In the prototype preview panel on the right side, click Refresh my prototype. Depending on the size of your prototype, the prototype might take a few seconds to refresh.
If you’ve linked the same prototype in other mazes, you'll need to repeat these steps to refresh the prototype in each individual maze.
Making changes to a Figma prototype imported into Maze
We strongly recommend always refreshing a prototype right before sending the maze live. This ensures that Maze has the latest data.
Use the refresh button any time you make changes to a Figma file after importing it into Maze. This ensures that Maze has imported the latest data related to hotspots, success paths, etc., which is fundamental for the results and reports to work correctly.
Live embed
For any mazes created after Wednesday, September 12, 2023, Maze displays the prototype exactly as it is in your Figma file.
Any changes made to the linked Figma file will be immediately reflected and visible to testers.
Keep in mind that significant changes to the prototype may break the defined paths in your maze, or lead to incorrect heatmaps.
Learn more about updating Figma files after publishing a maze
Static embed (legacy)
If you're working on an older maze using the legacy static embed, you can only refresh a prototype when the maze is in a draft state.
However, updating the prototype in a live maze requires duplicating the maze, refreshing the prototype, and publishing the newest version.
Which version am I in?
If you notice changes made in Figma reflect immediately in Maze, you are already experiencing the new live embed.
If you need to refresh the prototype in order to see the changes, that means that your maze uses the legacy static embed.
If you're uncertain, please reach out to our Support team for help.
Troubleshooting
Sometimes, you might run into an error when refreshing your prototype. There are a few reasons these errors typically occur:
- There’s been a cache or integration issue: Check if the issue persists when opening the page in an incognito/private window or a different browser. If you don't see the error from there, clearing your browser's cache and cookies might help solve the issue.
- The file is too large and cannot load: Please ensure your file is optimized for Maze. Learn more about creating a Maze-ready Figma prototype
- The file is no longer available: Please ensure that the prototype has the correct sharing permissions. Learn more about the supported Figma permissions
If you continue to run into issues after following these steps, please reach out to our Support team.
Still need help?
If you have any questions or concerns, please let our Support team know — we'll be happy to help!