# Pardot Form Field Catalog
> Reference document for dormakaba Salesforce Account Engagement (SFAE) forms.  
> Based on template: **FL4-pro | FORM MLANG gMaps-dd-Icons-BckDetect**

---

## Form Metadata

| Property | Description | Example |
|---|---|---|
| **Name** | `[Region Code] \| [Campaign Short Name] \| Forms [Locale]` | `C18 \| Skyra Promo \| Forms CH-de` |
| **Folder** | `/[BU or Region]/[Campaign Folder]` | `/GLOBAL DEMAND GENERATION/C18- Skyra` |
| **Campaign** | `[Type] \| [Campaign Code] - [Campaign Name]` | `DG \| C18 - Skyra` |
| **Tracker Domain** | Primary tracker URL for the region | `https://www2.emea.dormakaba.com` |
| **Link** | Full Pardot form handler URL | `https://www2.emea.dormakaba.com/l/{form-id}/{date}/{hash}` |
| **Layout Template** | Pardot layout template name | `FL4-pro\| FORM MLANG gMaps-dd-Icons-BckDetect` |
| **Submit Button Text** | Label on the submit button | `Submit` |
| **Always Display Form** | Show form even after submission | `Disabled` |

---

## Field Notation

Fields in the form builder use the following inline flags:

| Flag | Meaning |
|---|---|
| `(r)` | Required — field must be filled before submission |
| `(a)` | Autoresponder — value is used in the confirmation email |

---

## Field Type Reference

Each field belongs to one of two types:

- **Default Field** — standard Pardot prospect fields (CRM-native, always available).
- **Custom Field** — organisation-specific fields created in the SFAE account.

---

## Custom Field Prefix Conventions

Custom fields follow a naming prefix schema that signals their purpose:

| Prefix | Category | Behaviour |
|---|---|---|
| `TRA_` | Tracking | Hidden fields auto-populated by JS or URL params |
| `QUA_` | Qualification | Captures lead-scoring data entered by the prospect |
| `QUA_AI_` | AI Enrichment | Auto-filled via enrichment service (e.g. Clearbit/6sense) — hidden |
| `QUA_H_` | Hidden Qualification | Hidden tracking fields for form URL / touchpoint data |
| `QUA_TRA_` | Qualification + Tracking | Dual-purpose: visible to prospect AND used in routing/tracking |

---

## Default Fields

Standard Pardot prospect fields included in this template.

| Field Label | Pardot Default Field | Required | Autoresponder | Notes |
|---|---|---|---|---|
| Salutation | `Salutation` | | | Dropdown: Mr./Ms./Dr./etc. |
| First Name | `First Name` | ✓ | | |
| Last Name | `Last Name` | | | |
| Phone | `Phone` | | | |
| Email | `Email` | ✓ | ✓ | Triggers autoresponder |
| Company | `Company` | | | |
| Job Title | `Job Title` | | | |
| Country (ISO2) | `Country` | | | Expects 2-letter ISO code |
| Address | `Address One` | | | Excluded from placeholder-label transform (see JS) |
| City | `City` | | | Excluded from placeholder-label transform |
| State / Province | `State` | | | Excluded from placeholder-label transform |
| Zip | `Zip` | | | Excluded from placeholder-label transform |
| QUA_AI_ Company Website (from email) | `Website` | | | Hidden; AI-enriched from email domain |
| QUA_AI_ Company Annual Revenue | `Annual Revenue` | | | Hidden; AI-enriched |
| QUA_AI_ Company Employees | `Employees` | | | Hidden; AI-enriched |
| QUA_AI_ Company Industry | `Industry` | | | Hidden; AI-enriched |
| QUA_AI_ Company Years In Business | `Years In Business` | | | Hidden; AI-enriched |
| How can SKYRA support your project? | `Comments` | ✓ | ✓ | Label changes per campaign; maps to Comments |

---

## Custom Fields

Organisation-specific fields. Internal API name shown in brackets.

### Tracking Fields (`TRA_`) — Hidden, auto-populated

| Field Label | Custom Field API Name | Notes |
|---|---|---|
| TRA_ Autoresponder header img url | `Autoresponder header img url` | URL of the image shown in the autoresponder email header |
| TRA_ Lang-Browser | `Lang_Browser` | Detected from `navigator.language` via JS |
| TRA_ Current Page's Language | `Language` | Detected from page `lang` attribute or URL segment |
| TRA_ Autoresponder Subject | `Autoresponder_Subject` | Subject line for the confirmation email |
| TRA_ Autoresponder body text | `Autoresponder body text` | Body copy for the confirmation email |
| TRA_ Doc_Img_Url | `Doc_Img_Url` | Thumbnail image URL of the asset/document |
| TRA_ Doc_Name | `Doc_Name` | Display name of the downloadable asset |
| TRA_ Doc_Download_Url | `Doc_Download_Url` | Direct download URL of the asset |
| Enquiry Type (How can we help you?) | `TRA_ Enquiry Type (prev: How can we help you?)` | Hidden; set via URL param or dependency rule |

### Hidden Qualification Fields (`QUA_H_`)

| Field Label | Custom Field API Name | Notes |
|---|---|---|
| QUA_H_ Form URL | `QUA_H_FormUrl Touchpoints` | Captures the form page URL for touchpoint tracking |

### Qualification + Tracking Fields (`QUA_TRA_`)

| Field Label | Custom Field API Name | Notes |
|---|---|---|
| QUA_TRA_Intent Request | `QUA_TRA_Intent Request` | Hidden; routing/intent signal |
| Interest | `QUA_TRA_Interest_in_Vertical` | Visible dropdown; prospect's vertical of interest |
| What kind of product are you interested in? | `QUA_TRA_Interest in Product_Cat` | Visible dropdown; product category interest |

### Qualification Fields (`QUA_`)

| Field Label | Custom Field API Name | Notes |
|---|---|---|
| Project Name | `QUA_ Project Name` | Free text |
| Project Address | `QUA_ Project Address` | Free text |
| Sector | `QUA_Sector` | Dropdown |

### Other Custom Fields

| Field Label | Custom Field API Name | Required | Autoresponder | Notes |
|---|---|---|---|---|
| Customer Type (Profession Detailed List) | `Customer Type` | | | Dropdown |
| Profession | `I am` | | | Dropdown |
| Project Detail | `Project Detail` | | | Textarea |
| How did you hear about our products? | `How did you hear about our products?` | | | Dropdown |
| *(unlabelled)* | `Add-to-all-Newsletter-Lists` | | | Hidden; checkbox or hidden field for list subscription |
| *(unlabelled)* | `Opt-in` | ✓ | ✓ | Consent / GDPR opt-in checkbox |

---

## Field Order (Standard Sequence)

The recommended field order for this layout template:

1. Salutation *(Default)*
2. QUA_TRA_Intent Request *(Custom — hidden)*
3. TRA_ Autoresponder header img url *(Custom — hidden)*
4. First Name *(Default — required)*
5. Last Name *(Default)*
6. Phone *(Default)*
7. Email *(Default — required, autoresponder)*
8. Company *(Default)*
9. Job Title *(Default)*
10. Country (ISO2) *(Default)*
11. QUA_AI_ Company Website (from email) *(Default — hidden)*
12. Customer Type *(Custom)*
13. Profession *(Custom)*
14. Interest *(Custom)*
15. Address *(Default)*
16. City *(Default)*
17. State / Province *(Default)*
18. Zip *(Default)*
19. QUA_H_ Form URL *(Custom — hidden)*
20. TRA_ Lang-Browser *(Custom — hidden)*
21. TRA_ Current Page's Language *(Custom — hidden)*
22. TRA_ Autoresponder Subject *(Custom — hidden)*
23. TRA_ Autoresponder body text *(Custom — hidden)*
24. TRA_ Doc_Img_Url *(Custom — hidden)*
25. TRA_ Doc_Name *(Custom — hidden)*
26. TRA_ Doc_Download_Url *(Custom — hidden)*
27. QUA_AI_ Company Annual Revenue *(Default — hidden)*
28. QUA_AI_ Company Employees *(Default — hidden)*
29. QUA_AI_ Company Industry *(Default — hidden)*
30. QUA_AI_ Company Years In Business *(Default — hidden)*
31. Enquiry Type *(Custom)*
32. What kind of product are you interested in? *(Custom)*
33. Project Name *(Custom)*
34. Project Address *(Custom)*
35. Project Detail *(Custom)*
36. Sector *(Custom)*
37. How did you hear about our products? *(Custom)*
38. Comments / Campaign-specific question *(Default — required, autoresponder)*
39. Add-to-all-Newsletter-Lists *(Custom — hidden)*
40. Opt-in *(Custom — required, autoresponder)*