Skip to content
Privacy Requests
Guides
Custom Request Fields
Form Builder

Form Builder

This feature requires Fides Cloud or Fides Enterprise. For more information, talk to our solutions team. (opens in a new tab)

The form builder lets you visually design the intake form that data subjects see when they submit a privacy request — no JSON editing required. You can add fields, configure their properties, set up conditional visibility rules, reorder fields with drag-and-drop, and preview the form as the end user will see it.

For the equivalent JSON-based approach, see Configuration.

Accessing the form builder

  1. Navigate to Properties in the Admin UI sidebar.
  2. Select the property you want to configure.
  3. Under the privacy request action, click Edit form.

The form builder opens in a three-panel layout:

  • Left panel — AI assistant that can help generate or modify your form.
  • Center panel — Form canvas showing all fields. This is where you add, reorder, and preview fields.
  • Right panel — Properties panel for configuring the currently selected field.
Form builder three-panel layout

Adding fields

Click the Add field button above the form canvas. Fields are organized into two categories:

Identity fields

Identity fields collect standard identifying information and map directly to the privacy request's identity inputs:

FieldMaps to
Nameidentity_inputs.name
Emailidentity_inputs.email
Phoneidentity_inputs.phone

Each identity field can only be added once. Once added, you can configure whether the field is required or optional.

Custom fields

Custom fields collect additional information specific to your use case. The following field types are available:

Field typeDescription
TextSingle-line free-text input.
SelectSingle-choice dropdown.
Multi-SelectMulti-choice dropdown allowing multiple selections.
RadioRadio button group showing all options at once.
LocationCountry/region picker using ISO 3166 codes.
DateDate picker in ISO 8601 (YYYY-MM-DD) format.
File UploadFile attachment with size and type constraints.

Configuring field properties

Select a field in the canvas to open its properties in the right panel. The available settings depend on the field type.

Common properties

All fields support:

PropertyDescription
LabelDisplay text shown to the data subject.
RequiredWhether the field must be filled before submitting.
PlaceholderHint text shown inside the empty input.

Text field properties

PropertyDescription
Default valuePre-filled value.
HiddenIf enabled, the field is not shown to the user but its default value is still submitted. Useful with Query param key for passing values via URL.
Query param keyURL query parameter name used to pre-populate the field when the Privacy Center is opened via a deep link.

Select, Multi-Select, and Radio properties

PropertyDescription
OptionsThe list of choices available to the data subject. Use the options editor to add, remove, and reorder items.
Default valuePre-selected option(s).

Location properties

PropertyDescription
IP geolocation hintWhen enabled, pre-fills the field based on the user's IP address.

Date properties

PropertyDescription
MinEarliest selectable date (YYYY-MM-DD).
MaxLatest selectable date (YYYY-MM-DD).

File Upload properties

PropertyDescription
Max file sizeMaximum upload size in bytes. Defaults to 10 MB (10,485,760 bytes).
Allowed file typesAccepted file extensions (e.g., pdf, jpg, png). See Attachments for the full list of supported types.
Properties panel showing configuration for a Select field

Reordering fields

Drag and drop fields in the canvas to change their display order. The order you set here is the order data subjects will see when filling out the form.

Conditional visibility

You can configure fields to appear only when certain conditions are met — for example, showing a "Tell us more" text area only when a specific option is selected.

To add a visibility condition:

  1. Select the field you want to conditionally show.
  2. In the properties panel, find the Visibility section.
  3. Add one or more conditions using:
SettingDescription
Source fieldThe field whose value is evaluated.
OperatorThe comparison to perform.
ValueThe value to compare against (not required for all operators).

Supported operators

OperatorMeaning
EqualsSource field value equals the specified value.
Does not equalSource field value does not equal the specified value.
ContainsSource field value contains the specified string.
Is setSource field has been filled in.
Is emptySource field has not been filled in.

You can add multiple conditions to a single field. When multiple conditions are present, the field is shown only when all conditions are met.

For the JSON-based equivalent, see Conditional Display and Validation.

Visibility condition editor in the properties panel

Edit vs. Preview mode

The form canvas has two modes:

  • Edit mode (default) — All fields are displayed regardless of visibility conditions. You can select, configure, and reorder fields.
  • Preview mode — Shows the form exactly as the end user will see it, with visibility conditions active. Fields are hidden or shown based on the values you enter in the preview.

Use Preview mode to verify that your conditional visibility rules work as expected before saving.

Saving the form

Click Save to persist your changes. The form builder validates your configuration before saving:

  • No duplicate field names — each field must have a unique identifier.
  • At least one identity field — the form must include at least one identity field (e.g., Email).
  • At least one required identity field — at least one identity field must be marked as required.

When saved, the form builder writes the configuration to the property's underlying custom_privacy_request_fields JSON, identity_inputs, and field_order settings. Changes are reflected immediately in the Privacy Center for that property.

Some advanced configuration options — such as hidden fields with default_value and query_param_key — are also available through the form builder. For the full set of JSON attributes, see Configuration.

Field type mapping

If you work with both the form builder and JSON configuration, the table below maps between the two:

Form Builderconfig.json field_typeNotes
Texttext
Selectselect
Multi-Selectmultiselect
RadioradioRadio button group showing all options at once.
LocationlocationCountry/region picker using ISO 3166 codes.
DatedateDate picker in ISO 8601 (YYYY-MM-DD) format.
File UploadfileSee Attachments for upload configuration.