Labels and names
Every field has two identifiers, and confusing them is the most common configuration mistake in Tap.Label
The human-readable text the visitor reads — “What’s your work email?”. Cosmetic. Change it whenever you like.
Name
The stable machine key the answer is stored under, and the key your CRM mapping points at. Structural.
name by slugifying the label. Two fields labelled “Notes” become notes and notes-1. Because the key is derived from the label at creation time, later editing the label does not change the key — which is exactly what keeps your mapping stable.
The default form
A brand-new account with no saved form collects four fields, in this order:1
Full Name
full-name — text2
email — email3
Mobile
phone-mobile — tel4
Note
note — textareaIf you save a form with no fields at all, Tap restores these four rather than presenting visitors with an empty form. Clearing the form is not a way to disable capture.
Built-in fields
These fields have reserved keys with known meaning, which is what lets Tap map them to your CRM’s standard properties automatically. Prefer them over custom fields wherever one fits.Contact and identity
Company
Phone
Location
Notes
A handful of older keys —
mobile-number, primary-email, secondary-email, primary-phone, secondary-phone, address, image — remain valid for accounts created before the current field set. They still work and still map. You don’t need to migrate them, but use the modern keys above for anything new.Custom fields
Anything the built-in set doesn’t cover — “Which product are you interested in?”, “Booth number”, “Event name” — becomes a custom field with a slugified key. Custom fields work exactly like built-in ones except for CRM mapping: Tap can’t guess where they belong, so you must map them by hand. See Field mapping.Where the form comes from
A profile can get its capture fields from three places. They resolve in this order, first match winning:Where a profile's capture fields come from
1
The profile's template
If the profile uses a template that defines lead capture fields, those fields are used. This is how an admin forces every rep to collect the same data.
2
The member's own saved form
Otherwise, the fields the member saved for themselves.
3
The default four
If the member has never saved a form, the default set above is used — and created for them on first load.
Prefill from a connected profile
When a visitor is themselves a Tap user, the form can prefill from their profile — name, email, company already filled in before they type anything. Anything the visitor types wins over the prefilled value. Prefill is a convenience, never an override.Best practices
Four to six fields, hard limit
Four to six fields, hard limit
Completion rate falls off sharply past six fields. Anything you could enrich later from an email address — company size, industry, location — doesn’t belong on the form.
Put the note field last
Put the note field last
Free-text fields are the most likely to be abandoned. Placing the note after the contact details means a visitor who gives up partway has still given you a usable lead.
Use built-in keys wherever one fits
Use built-in keys wherever one fits
A custom field called “Work Email” needs manual mapping in every CRM. The built-in
email field maps itself.Use a tag for the event, not a form field
Use a tag for the event, not a form field
Don’t ask visitors to type the event name. Apply a tag to the leads afterwards — it’s more accurate and costs the visitor nothing.
Next: collecting leads
How capture actually works in the field.
