GPP API
When Fides is configured to support the IAB's Global Privacy Platform (GPP), FidesJS includes the GPP API so that downstream services can call it to get a user's privacy preferences and ensure that advertising and other services are loaded according to user preferences.
You can inspect the GPP API and your current preferences by calling:
__gpp('ping', (data) => {console.log({data})})from your browser console.
When GPP is supported in your jurisdiction, an object will be returned with information about the API and current user preferences. For more information about the GPP API, see the spec from the IAB in Github (opens in a new tab).
Forcing GPP inclusion
In some cases it may be necessary to always support GPP, even when visiting from an unsupported jurisdiction. Forcing the inclusion of the GPP API can be accomplished by including query parameter gpp=true on the FidesJS script:
<script src="path/to/fides.js?gpp=true"></script>Forcing inclusion makes the GPP API available in every location, but it doesn't change which GPP sections apply. Those still depend on where the user is and on your US approach (the us_approach GPP setting). When no section applies, applicableSections is set to [-1], which tells downstream services that no restrictions apply.
| User location | US National (national) | US state-by-state (state) | US National and state-by-state (all) |
|---|---|---|---|
| US state with its own GPP section (for example, California) | [7] (usnat) | That state's section (for example, [8] for usca) | That state's section, or [7] if the experience has no notices for that state |
| US state with a privacy law but no GPP section of its own (for example, Maryland) | [7] (usnat) | [-1] | [7] (usnat) |
| US state without a privacy law (for example, New York), setting off | [7] (usnat) | [-1] | [7] (usnat) |
| US state without a privacy law (for example, New York), setting on | [-1] | [-1] | [-1] |
| Outside the US | [-1] | [-1] | [-1] |
"Setting" refers to Send no GPP section in U.S. states without a privacy law in Consent settings. With the setting off, the US National approach and the US National and state-by-state approach support every US location, so users in the US never receive [-1]. Users in the EEA receive the TCF EU section instead when TCF is enabled and the GPP TCF EU string setting is on.
Sending no section in US states without a privacy law
Some businesses don't want to send a US National (usnat) signal to users in states that have no privacy law. Turning on Send no GPP section in U.S. states without a privacy law makes FidesJS report applicableSections: [-1] for those users under the national and all approaches. Under the state approach the setting is always on, because state-by-state already sends no section outside regulated states.
For an example setup, see Configuring the Global Privacy Platform. Fides maintains the list of states with a privacy law, so you don't need to update it as new laws take effect. The setting relies on the user's state. If FidesJS can't determine the state, it sends usnat as before.
Opt-outs from users in states without a privacy law, whether from GPC or the privacy modal, are still recorded in Fides consent. However, GPP can't carry them, because no section applies and applicableSections is [-1].
If you've signed the IAB Multi-State Privacy Agreement (MSPA), note that from December 31, 2026 it asks signatories to apply the US National approach to every US resident. Turning this setting on sends no section in some US states, so check it against your MSPA obligations. Fides allows the setting alongside MSPA coverage and repeats this note in the setting's tooltip, because the decision is yours.
With the setting on, FidesJS includes the GPP API for US users, so ?gpp=true isn't needed in the US. It's harmless to keep it on the same script, though, and you still need it to make __gpp available outside the US.
To test forced inclusion, visit from a location outside the US, or override the location with the geolocation query parameter (for example, fides.js?gpp=true&geolocation=gb).