Troubleshooting prototype tests
Krystal Taylor avatar
Written by Krystal Taylor
Updated over a week ago

Common questions

I can’t add my prototype!

  • Make sure you’ve authenticated with Figma (the window might be underneath the browser). To confirm you have successfully authenticated, you can check the Connected apps section of your account settings in Figma to make sure we're there.

  • Is your prototype very large? If you have 200+ screens, duplicate your flow into a separate Figma file to reduce the time it takes to render your frames.

  • Check your privacy settings in Figma, and make sure they are set to “Anyone with the link” "can view". Any other setting (e.g can view prototypes) will prevent your prototype from loading correctly here in your UsabilityHub test.

I've made changes to my prototype in Figma, but my prototype test isn’t up to date with my Figma file.

You may need to re-sync your prototype with Figma. This will pull the latest changes from Figma and update the prototype test on our end.

I've tried to re-sync but it isn’t doesn't update my prototype test.

If you're having issues getting your file to sync, you can try creating a new version of your Figma file. A new version can “force” your UsabilityHub re-sync to pull new changes in. Check out Figma's article on file versions to save a new version of your file. Figma: Create and name versions of your Figma file

My prototype preview won't load (using Safari browser).

Safari has included a privacy setting that prevents third-party sites from setting cookies, but this security feature can sometimes prevent Figma prototypes from loading correctly. To test for this, head to Preferences→Privacy in Safari and uncheck Prevent cross-site tracking to disable this feature:

This issue is not limited only to UsabilitHub and seems to also affect other products that embed Figma prototypes. To avoid experiencing further issues, we recommend using any recent version of Chrome or Firefox browsers if you would prefer to leave this privacy setting turned on in Safari.

Why isn't my prototype scaling to the right size?

When you add your Figma flow link, we'll automatically use the scaling option that has been set within Figma. Try selecting a different scaling option within the test builder. This will adjust the size of your prototype to ensure it's displayed clearly on your test.

Clicks seem to be missing from my results page.

We plan to support overlays and overscroll behavior in our upcoming update for prototype tests.

How do I add a device frame around my prototype?

Set device frames in Figma and we will show them in UsabilityHub

Why can't I highlight clicks on my prototype heatmap?

We don’t support this right now, but this may be added in a future update!

Do you have additional questions that aren't answered here? Chat with our support team or send us an email at

Did this answer your question?