Recommended method: register from the front end
If you want an agent, agency, or developer to manage their own properties from the front-end dashboard, the best option is to let them register from the front-end registration form.
In the registration form, the user can select the correct account type:
- Agent
- Agency
- Developer
- User
When the registration is done from the front end, WPResidence automatically creates the WordPress user account, creates the matching Agent / Agency / Developer profile, and links them together.
Manual sync between user and Agent / Agency / Developer profile
If you create the user and profile manually from admin, you must link both records manually.
There are two IDs involved:
- User ID – the WordPress user ID.
- Agent / Agency / Developer ID – the ID of the Agent, Agency, or Developer profile post.
Step 1: Create the WordPress user account
Go to:
WP Admin > Users > Add User
Create the user account and select the correct role.
Depending on your setup, the role can be:
- WpResidence Agent
- WpResidence Agency
- WpResidence Developer
- Subscriber, for standard users without Agent / Agency / Developer role access
Step 2: Create the Agent, Agency, or Developer profile
Create the matching profile from:
- Properties, Agents & More > Agents > Add New
- Properties, Agents & More > Agencies > Add New
- Properties, Agents & More > Developers > Add New
Use the same email address as the WordPress user account.
Step 3: Add the User ID in the profile
First, find the WordPress user ID.
Go to:
WP Admin > Users > All Users
Open or hover the user account and identify the user ID.
Then edit the Agent, Agency, or Developer profile and add this user ID in:
Agent Settings > Agent Details > The user id for this profile
Step 4: Add the Agent / Agency / Developer ID in the user account
Next, find the ID of the Agent, Agency, or Developer profile.
Go to the Agent, Agency, or Developer list and check the ID column.
Then edit the WordPress user account from:
WP Admin > Users > All Users > Edit User
Add the Agent, Agency, or Developer profile ID in:
User Agent / Agency / Developer ID
Step 5: Check the email address
The user account and the Agent / Agency / Developer profile should use the same email address.
For the Agent profile, check the email from:
Agent Settings > Agent Contact > Email
For the WordPress user account, check the email from:
WP Admin > Users > Edit User > Contact Info > Email
Important notes
- This linking is done automatically when users register from the WPResidence front-end register modal.
- Manual syncing is needed only when the user account and the Agent / Agency / Developer profile are created separately from admin.
- The User ID must be added in the Agent / Agency / Developer profile.
- The Agent / Agency / Developer ID must be added in the WordPress user account.
- The user and profile should use the same email address.
- If the profile is not linked correctly, the user may not be able to manage the correct properties from the front-end dashboard.
This happens automatically when users register themselves using the WPResidence Register Modal form.