Structures define the format of data collected and processed in PalDock. They describe which fields are included, how those fields behave, and how the data is used across forms, APIs, feeds, and integrations.
By using structures, you ensure that all data in PalDock is consistent and reusable.
Types of Structures
- Form Structure – defines the fields collected when a lead is created. Used in forms, APIs, and partner integrations.
- User Structure – defines the fields collected when users register or manage their account. Separate structures exist for Affiliate partners and Advertisers.
- Feed Structure – defines the format of product feeds (e.g. product name, price, availability) imported into PalDock and used in affiliate display or lead distribution.
Fields in Structures
Each structure is made of fields. Fields determine what kind of data is collected (e.g. text, number, email). To keep structures consistent and avoid duplication, PalDock supports three levels of fields:
- Global fields – predefined system fields used across all workspaces (e.g. First Name, Email).
- Local fields – workspace-wide fields created by admins, reusable across multiple structures.
- Custom fields – fields created directly inside one structure, specific to that structure.
👉 We recommend using global fields whenever possible, and local or custom fields only when necessary.
How structures are used
A structure on its own collects nothing. It becomes active when something is attached to it:
- A form structure is attached to an offer, and an offer can have more than one. That is how two landing pages that differ by a single field share one offer. See Multiple Structures for Offers and Integrations.
- An integration is built on exactly one structure. The fields in that structure are what you map into the advertiser’s request.
- A user structure is used by the registration and account forms for affiliate partners and advertisers, so it is not attached to anything.
The same structure serves the form, the embeddable form and the API. A field added to the structure appears in all three, and in the API documentation your partners see.
Advanced Options
All structures can use the same advanced features:
- Field settings – define labels, placeholders, default values, and visibility rules.
- Validation – enforce correct data formats or check values against external services.
- Modify – fill or transform a field value, either from another field or from an external service.
- AutoComplete – suggest values to the user while they are typing.
- Translations – localize field labels and placeholders into multiple languages.
⚠️ Validation, Modify and AutoComplete are powerful features, but because they can rely on external services, a misconfiguration can break the entire system, preventing the form from being submitted and the lead from being created.
