Overview


Formulayt integrates with Usercentrics so that key parts of the platform respect the consent choices your visitors make in the Usercentrics banner.


With the Usercentrics app enabled, you can use UC consent categories to control three main areas:

  • Formulayt Event System (Custom JavaScript)

  • Formulayt Performance Tracking (Reporting)

  • Formulayt Contact Data Pre-Population


You decide which Usercentrics categories must be accepted for each of these areas to be considered “allowed”.


If Usercentrics is not running on the page, the integration has no effect – Formulayt behaves as normal and all features are treated as permitted.

How Formulayt and Usercentrics work together


Usercentrics groups your tools and tags into categories (for example, Essential, Functional, Performance, Marketing). The user sees those categories in the UC banner or preference centre and decides which to accept.


Formulayt:

  1. Checks which Usercentrics categories are currently “active” – in other words, where the user has given consent (or the category is Essential).

  2. Compares that to your Formulayt configuration for Events, Reporting and Pre-pop.

  3. Decides whether each of those features should be treated as allowed or not allowed for that user.


Form rendering and submission are not blocked by Usercentrics – your gates will still show and forms still submit. The integration only controls the three functional areas listed above. The core Formulayt script should be considered essential and loaded outside of Usercentrics to ensure that forms can always render.

Configuring the Usercentrics app in Formulayt


In the Formulayt UI, go to:


Apps → Usercentrics


Here you configure the rules that connect UC categories to Formulayt features.


You do this separately for:

  • Formulayt Event System (Custom JavaScript)

  • Formulayt Performance Tracking (Reporting)

  • Formulayt Contact Data Pre-Population


For each area, you have two ways to choose categories: built-in toggles or explicit slugs.

Option 1: Built-in category toggles


This is the simplest option and will work for most setups.


For each feature (Events, Reporting, Pre-pop), you’ll see toggles for the common UC categories:

  • Essential

  • Functional

  • Performance

  • Marketing


Tick one or more categories for each feature. Formulayt will then treat that feature as allowed if the user has consented to any of the categories you’ve chosen.


If you don’t select any categories for a feature (and you’re not using the override inputs), Formulayt does not block that feature based on Usercentrics – it’s treated as permitted.

Option 2: Explicit category slugs (advanced)


Usercentrics internally identifies categories by a slug – for example, essential, functional, performance, marketing. In some configurations you might also have additional custom categories with their own slugs.


If you want complete control, you can enable the override option:

  • I want to explicitly list category slugs to allow


Once you switch this on, you’ll see a text box for each feature where you can enter one or more category slugs, one per line.


For example:


functional
performance

In that case, Events would be allowed if either the functional or performance category is active for that user, regardless of which built-in toggles are ticked (for that feature).


If the override is on and you leave a feature’s list empty, Formulayt will not block that feature based on UC – it will be treated as permitted.

What “allowed” vs “not allowed” means in practice


For each user, based on their UC choices and your configuration, Formulayt decides whether each feature is allowed. Here’s how that affects behaviour:


1. Event System (Custom JavaScript)

  • Formulayt determines whether the Event System is considered “allowed” based on the configured categories.
  • You can also use the Usercentrics data source(s) described below inside your event code to decide whether to call third-party tools or run tracking logic for more detailed control.


2. Performance Tracking (Reporting)


If Reporting is not allowed under your UC configuration for a particular user:

  • Formulayt does not send its performance tracking data for that user into Formulayt reports.


If it is allowed, Formulayt tracking behaves as normal.


3. Contact Data Pre-Population


If Pre-pop is not allowed:

  • Formulayt does not pre-populate personal data from:

    • Marketing automation cookies (e.g. Eloqua, Marketo).

    • Previously submitted form data stored in the browser.


Non-personal pre-pop (such as UTM parameters or other context) is not affected by the UC integration.


If Pre-pop is allowed, those sources can be used as normal.

Usercentrics data sources in Formulayt


When the Usercentrics app is active, Formulayt exposes several data sources you can use in:

  • Field rules (e.g. show/hide, read-only logic), and

  • Event System (your custom JavaScript).


You’ll see these under the Usercentrics section when selecting data sources.


  • Usercentrics active categories (slugs, comma-separated)
    • Provides a comma separated list of the category slugs that the user has opted-in to
  • In addition, data sources are provided for each Formulayt feature area to indicate whether that feature is currently active based on the user's choices


You can use these in the Event System to add your own fine-grained handling. For instance:

  • Only send an analytics call if Events allowed is true.

  • Only call your MA platform if both Events allowed and Pre-pop allowed are true.

  • Use Active categories to change messaging or form behaviour based on how privacy-conscious the user is.

What happens if Usercentrics is not present?


If the UC script is not loaded on a page:

  • Formulayt assumes Usercentrics is not in use on that page.

  • The Usercentrics integration does not block any features.

  • Events, Reporting and Pre-pop behave as if UC were not configured.

  • Usercentrics data source values will either be empty or reflect that UC is unavailable.


This means you can safely enable the Usercentrics app across your account even if only some domains or pages actually use UC – those that don’t will simply fall back to normal behaviour.

Summary

  • Usercentrics controls how tags and tools are grouped into categories like Essential, Functional, Performance, and Marketing.

  • Formulayt reads which categories the user has actually consented to and then applies your rules for:

    • Event System (custom JS),

    • Performance Tracking (Reporting),

    • Contact Data Pre-Population.

  • You configure the mapping in Apps → Usercentrics using:

    • Built-in category toggles, or

    • Explicit category slugs (advanced).

  • Form rendering and submission are never blocked; the integration only affects tracking, events and pre-pop..

  • Use the Usercentrics data sources in Formulayt to align your own logic (fields and events) with the user’s consent choices.