How Theme Contact Forms Work in WPResidence
This help explains how the built-in WPResidence contact forms work, where each form sends emails, and how the recipient is selected.
WPResidence includes several built-in contact forms:
- Property page contact forms
- Agent, Agency, and Developer profile page contact forms
- Contact Page template form
- Footer contact form
These forms can also work with the WPEstate CRM plugin, so messages can be tracked as leads.
Video Guides
Contact page and theme contact forms
HubSpot integration for contact forms
Add and assign agents from wp-admin
Agency and Developer roles
Property Page Contact Form
The property page contact form sends emails to the email address of the profile assigned to that property.
The assigned profile can be:
- Agent
- Agency
- Developer
This form can appear in:
- The property page sidebar
- Below the property details
- The property gallery lightbox
The email message includes a link to the property page where the form was submitted.
Check the assigned profile
Edit the property and go to:
Properties > Edit Property > Property Details > Agent
Make sure a main agent, agency, or developer profile is selected.
Check the profile email
Edit the assigned agent profile and check the email from:
Agents > Edit Agent > Agent Settings > Email
Profile Page Contact Forms
Profile page contact forms are used on:
- Agent pages
- Agency pages
- Developer pages
These forms send the email to the email address added in that profile.
The message also includes the link to the page where the form was submitted.
How Property Contact Forms Decide Who Receives Emails
The property page contact form sends the message to the profile assigned to the property.
If an agent, agency, or developer is assigned correctly, the contact form sends the email to that assigned profile email address.
If you use a different Main Agent and a different User for the same property:
- The Main Agent is the profile shown on the property page and the profile that receives contact notifications.
- The User is the WordPress account that can manage the property from the front-end dashboard.
- If the Main Agent is different from the User, the User does not receive the property contact form emails.
This setup is useful when one profile handles communication and another account manages the property listing.
How to Assign Users and Agents to Properties from Admin
An Agent, Agency, or Developer can be assigned to a property from the WordPress admin area.
If you want to create users manually from admin, go to:
Agents > Add New, Agencies – Add New or Developers – Add New
Then edit the property from admin and go to:
Properties > Edit Property > Property Details > Agent
From this section, you can select:
- Main Agent – controls the profile shown on the property page and the contact form recipient.
- User – controls which user account can manage the property from the front-end dashboard. Let users register in front end https://help.wpresidence.net/article/1-3-50-1-agency-agents-developers-and-users-separation-how-to-manage-these-new-options/
Make sure the assigned user role has an email set from:
Agents > Edit Agent > Agent Settings > Email
OR
Agencies > Edit Agency > Agency Settings > Email
Developers > Edit Developer > Developer Settings > Email
How to Assign a Secondary Agent
You can assign more than one agent to a property.
This option is managed from the backend only. The admin can assign secondary agents from the Agent section in Property Details.
To select multiple agents, hold CTRL and select the agents.
To reset the selection, choose None and save the property again.
If more than one agent is selected, the email sent from the property contact form will go to all assigned agents.
On the property page, the main agent and the secondary agents can be shown.
Related help:
How to assign the user to the agent account
Show Secondary Agents in a Custom Property Template
If you use a Custom Property Template, make sure the Other Agents widget is added to that template.
Without this widget, secondary agents may be assigned in admin, but they will not appear on the front end.
Related help:
Create a custom property template with Elementor
How to Assign Agency and Developer to Properties from Admin
Agencies and Developers can also be assigned to properties from admin.
Edit the property and go to:
Properties > Edit Property > Property Details > Agent
Select the agency or developer profile that should be connected to the property.
Make sure the assigned agency or developer profile has a valid email address. This email is used for the contact form notifications.
Related help:
How to manage Users, Agents, Agencies, and Developers
What Happens When No Agent Is Assigned
If no profile is assigned to the property, the following sections will not show on the property page:
- Request Info section
- Call button
- WhatsApp button section
If you want the property page contact options to appear, make sure the property has a valid assigned agent, agency, or developer.
Duplicate Emails to a Secondary Email Address
From Theme Options, you can set a secondary email address to receive a copy of all messages sent through the agent, agency, and developer contact forms.
This is useful if you want the admin, broker, or office email to receive a copy of all inquiries sent through profile and property contact forms.
Contact Page and Footer Contact Form
You can set the email address that receives messages from the WPResidence Contact Page template and the Footer Contact Form from:
Theme Options > Social & Contact > Contact Page Details
The Contact Page form is used when you create a page with the Contact Page custom template.
Related help:
How to create and set up the Contact Page
The footer contact form is the form that opens when clicking the email icon next to the Go Up button.
Contact Forms and WPEstate CRM
Theme contact forms can also work with the WPEstate CRM plugin.
This allows contact messages to be tracked as leads inside the CRM workflow, in addition to the normal email sending behavior of the theme forms.
If you also use HubSpot integration, configure that separately for the WPResidence contact forms.
Contact Form Security
- All built-in theme contact forms use WordPress nonces for security.
- No extra CAPTCHA is required for the default form protection.
- The sender email address is set in Theme Options.
- Make sure the sender email is accepted by your hosting mail server configuration so emails can be delivered correctly.
If emails are not delivered, check the sender email address, hosting mail rules, SMTP setup, and spam folder.
Related WordPress documentation:
WordPress Nonces
Related Help Guides
- How to assign properties to users, agent, agency, or developer from admin
- How to assign the user to the agent account
- How to manage Users, Agents, Agencies, and Developers
- WPEstate CRM plugin
- HubSpot CRM Integration
- How to create and set up the Contact Page
- Create a custom property template with Elementor