How Theme Contact Forms Work in WpResidence
This help explains how the built-in WpResidence contact forms work, where each form sends emails, how recipients are selected, and how these forms can also connect to the WpEstate CRM plugin.
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
Property Page Contact Form
The property page contact form sends emails directly to the assigned agent, agency, or 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.
Profile Page Contact Forms
Profile page contact forms are used on:
- Agent pages
- Agency pages
- Developer pages
These forms send the email to the corresponding user type assigned to 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 recipient depends on who is assigned to the property.
If an agent, agency, or developer is assigned correctly, the form will send to that assigned profile.
If you use a different Main Agent and a different User for the same property:
- the Main Agent can be the one who receives contact notifications by email
- the User can be the one who manages the property details from the front-end dashboard
This setup is useful when one person manages communication and another manages the property listing itself.
How to Assign Users and Agents to Properties from Admin
The Agent, Agency, or Developer can be assigned to a property from the WordPress admin area.
The steps are:
- Create the agent first
If you want to create the agent manually from admin, go to Agents > Add New.
Then edit the property from admin and go to Edit Property > Agent tab, where you can select the Main Agent and or the User.
This assignment controls who appears on the property page and who can manage the property from the dashboard.
How to Assign a Secondary Agent
You can assign a property to more than one agent.
This feature is managed from the back end only. The admin can assign secondary agents from the Agent section in Property Details.
You can select multiple agents by using CTRL. 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 will all be shown.
If the agent must also manage the property from the front-end dashboard, then the Main Agent and User must be correctly linked and in sync.
If you want to assign a property manually to an agent and also allow front-end editing, make sure the agent is registered from the front end and linked to the correct user account.
Help article on 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 as well.
Without this widget, secondary agents may be assigned in admin, but they will not appear on the front end.
Help guide:
Create a custom property template with Elementor
How to Assign Agency and Developer to Properties from Admin
You can assign an Agency or Developer in the same way as an Agent.
If the agent, agency, or developer is registered from the front end and you want to assign a property manually from admin, make sure the related profile and user account are correctly linked and in sync.
This is important so the correct profile appears on the property page and the correct account receives messages or dashboard access.
What Happens on the Property Page When No Agent Is Assigned
When an agent is assigned to the property, the assigned profile details will show in the property page contact form area.
If no agent is selected for the property, the following sections will not show on the property page:
- Request Info section
- Call button
- WhatsApp button section
For this reason, 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 Secondary Email Address
This is useful if you want the admin 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 > Contact Page Details > Email
The Contact Page form is built in when you create a page using the Contact Page custom template.
Read this guide to learn how to create and configure the Contact Page:
How to create and set up the Contact Page
The footer contact form is the one that opens when clicking the email icon next to the Go Up button.
The email received by admin from the Contact Page form looks like this:
Contact Forms and WpEstate CRM
Theme contact forms can also be managed together 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, you can 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
Read more about WordPress nonces
Related Help Guides
How to assign properties to users, agent, agency, or developer from admin