WP Residence Help WP Residence Help

  • WpEstate
  • WPRESIDENCE
  • Video Tutorials
  • Client Support
  • API
Home / 13. WPResidence / WPEstate CRM / How Contact Forms Auto-Create Records in the WPResidence CRM

How Contact Forms Auto-Create Records in the WPResidence CRM

16 views 0

Most records in your real estate CRM arrive without you ever having to type them. Every time a visitor submits a contact form on your WPResidence site, the CRM receives the submission, matches it against an existing contact (or creates a new one), records an enquiry, and logs the event to the activity timeline.

This article explains which forms feed the CRM, what data ends up where, and how the auto-match logic works.

Forms That Feed the CRM

Every major contact form in the WPResidence theme creates a CRM record automatically:

Form Creates enquiry type
Property contact form (single property page) Property Inquiry
Schedule tour / viewing form Schedule Tour
Contact page form General Question
Agent page form Property Inquiry
Footer contact form General Question

No configuration is required. As long as the CRM plugin is active, submissions route to it automatically.

What Happens When a Form Is Submitted

  1. The form is validated (email required and syntactically valid).
  2. The CRM searches the contacts database for a match on the email address.
  3. If a match is found, the existing contact is used. The contact’s data is merged (newer phone, address, etc.), not overwritten.
  4. If no match is found, a new contact is created. Name is split into first and last name on the first space, and the lifecycle stage is set to New Lead.
  5. A tracking cookie is set on the visitor’s browser so their future property page views are tied to this contact.
  6. An enquiry record is created with the appropriate type.
  7. A form_submission activity is recorded.
  8. If the form was submitted on a property page, the contact’s buyer preferences are auto-populated from that property’s attributes.
  9. Downstream hooks fire — email notifications, SMS alerts, HubSpot sync, webhooks, and automations all get their chance to respond.

Who the Lead Gets Assigned To

The CRM picks an owner in this order:

  1. If the form includes an agent ID (for example, the form on an agent’s profile page), the lead is assigned to that agent.
  2. Else if a property ID is included, the lead is assigned to the property’s listing author.
  3. Otherwise, the lead is assigned to the site administrator.

Buyer Preferences Auto-Fill

When the form submission includes a property ID, the CRM fills the contact’s buyer preferences:

  • Property type and location copied from the listing.
  • Bedrooms and bathrooms copied directly.
  • Price range set to 80%–120% of the listing’s price.
  • Area range set to 80%–120% of the listing’s size.

These are only populated for fields the contact has not already filled — existing preferences are never overwritten.

How to Tell If a Contact Came From a Form

Check the contact detail page:

  • Lead source will be set to website.
  • Lifecycle stage will start at New Lead.
  • The activity timeline will show a form_submission entry with the form type and linked property.

GDPR and Consent

The theme’s GDPR consent checkbox (if enabled) gates the form submission. If the visitor does not check the consent box, the submission is blocked before the CRM ever sees it. The CRM itself does not force consent.

Best Practices

  • Review the contact detail page for each new contact — the auto-filled data is a starting point, not the last word.
  • Use the “Attribution” part of the activity timeline (source, landing page URL, property) to understand where demand is coming from.
  • If you find duplicates, check whether prospects are submitting with different email addresses. The CRM only deduplicates by email.

Related Articles

See the Contacts, Enquiries, and Activity articles for how each record type looks after creation. See the HubSpot CRM integration guide for pushing auto-created contacts into HubSpot.

13. WPResidence / WPEstate CRM

Related Articles

  • WPResidence CRM Security Model — Developer Reference
  • CRM Security and Data Privacy
  • WPResidence CRM Installation and Updates — Developer Reference
  • Installing and Updating the WPResidence CRM

WP Residence Documentation

  • 01. Getting Started
    • How to Get Support
    • Get your buyer license code.
    • Use SSL / https
    • Server / Theme Requirements
  • 02. Installation & Setup
  • 03. Installation FAQ
  • 06. Search & Filtering
    • Advanced Search Display Settings
    • Advanced Search Form
    • Geolocation Search for Half Map
    • Save Search Theme Options
    • Advanced Search Colors
  • 09. Agent, Agency & Developers
  • 08. Property Pages & Layouts
  • 07. Property Lists, Categories & Archive
  • 14. WPResidence Elementor Studio
  • 10. Blog Posts & Blog List
  • 11. Shortcodes
    • Contact Form
    • Featured Agency/Developer
    • Membership Packages
    • Testimonials
    • Google Map with Property Marker
    • Listings per Agent, Agency or Developer
    • Display Categories
    • Agent List
    • Recent Items Slider
    • Recent items
    • List Properties or Articles by ID
    • Featured Agent
    • Featured Article
    • Featured Property
    • Login & Register Form
    • Icon Content Box Shortcode
  • 12. Widgets
  • 04. Theme Options & Global Settings
    • General Settings
    • User Types Settings
    • Appearance
    • Logos & Favicon
    • Header
    • Footer Style and Colors
    • Price & Currency
    • Property Custom Fields
    • Features & Amenities
    • Listing Labels
    • Theme Slider
    • Permalinks
    • Splash Page
    • Social & Contact
    • Map Settings
    • Pin Management
    • How read from file works
    • General Design Settings
    • Custom Colors Settings
    • Header Design & Colors
    • Mobile Menu Colors
    • User Dashboard Colors
    • Print PDF Design
    • Property, Agent, Blog Lists Design Settings
    • Sidebar Widget Design
    • Font management
    • How to add custom CSS
    • Custom Property Card Unit – Beta version
    • Email Management
    • Import & Export theme options
    • reCaptcha settings
    • YELP API Integration
    • iHomefinder Optima Express IDX
    • MEMBERSHIP & PAYMENT Settings
    • Property Submission Page
    • PayPal Setup
    • Stripe Setup
    • Wire Transfer Payment Method
  • 20. Translations & Languages
  • 26. FAQ
  • 10. Pages
  • 11. Header
  • 12. Footer
  • 05. Maps & Location Settings
  • 18. Payments & Monetization
  • Plugins
    • 19. Included Plugins
    • 22. Third Party Plugins – IDX Compatibility
    • 21. Third-Party Plugins – Multi-Language
    • 23. Third party Plugins – Other
  • Technical
    • 24. Technical how to | Custom Code Required
    • 25. Technical: Child Theme

Join Us On

Powered by WP Estate - All Rights Reserved
  • WpEstate
  • WPRESIDENCE
  • Video Tutorials
  • Client Support
  • API