Troubleshooting

This document contains typical troubleshooting questions and answers that you might run into while working with fides.js.

FidesJS detected that it was already loaded on this page, aborting execution!

fides.js is only designed to be loaded once per page. While loading it more than once may work in some cases, the behavior is unsupported.

There are a number of common reasons that this might occur.

Common Causes

Dynamic Script Tag Rendering

Often times during an implementation fides.js might be added to a website that uses dynamic script tag rendering (e.g. NextJS). In these situations we recommend that the correct settings from the framework in question are applied so that fides.js is only rendered once.

Fides Re-initialization

If you intend to re-initialize Fides the recommended way of doing so is to call window.Fides.init() again instead of removing and re-adding the script to the page.

Suppressing the Error message

If you decide that you need to continue to load Fides more than once you can suppress this error message by setting: fides_unsupported_repeated_script_loading to enabled_acknowledge_not_supported.

This can be done through the Privacy Center as documented in the Privacy Center server settings or through the FidesOptions.

Side Effects

If you load fides.js multiple times, your consent settings will load as expected, however, you may see some unexpected event behavior.

If you are seeing many more Fides Events than you expect it is possible that you are loading fides.js more than once. You might be able to use Chrome's getEventListeners function (opens in a new tab) to confirm this by checking the number of listeners configured for Fides Events.