Field Mapping

Field mapping connects your WordPress form fields to CareHQ contact fields. When someone submits a form, the plugin uses these mappings to send the right data to CareHQ.

CareHQ Contact Fields

Each form submission maps to the following CareHQ fields:

CareHQ Field Description
first_name Contact's first name
last_name Contact's last name
email Email address
phone Phone number
message Enquiry details or message

How to Map Fields

  1. Open the Mappings tab and select a form.
  2. Go to the Field Mappings sub-tab.
  3. For each CareHQ field, choose the matching field from your form using the dropdown.
  4. Save your mappings.

Tip: Use separate First Name and Last Name fields in your form rather than a single Name field. This maps cleanly to CareHQ's first_name and last_name fields.

Testing Your Mapping

  1. Submit a test form on the front end of your site.
  2. Check the Logs tab to confirm the submission was successful.
  3. Verify the data appears correctly in your CareHQ account.
← Form Setup Next: Conditional Routing →