Configure the Map System First

Before setting the property location on the map, make sure your map system is configured correctly in Theme Options > Map > Map Settings. WPResidence lets you use either Google Maps or OpenStreetMap as the map provider. If you use Google Maps, you must add a valid Google API key.

Ways to Place the Property Pin

A property pin can be placed on the map in several ways, depending on how the property is added and how the submission form is configured.

The property pin can be placed in 4 ways:

1. Automatic Pin Placement with Autocomplete

Step 1. Enable Autocomplete in Front End Submission Form from Theme Options > Submission & Membership > Property Submission Page

Step 2. For the pin to be placed automatically when the property is submitted, all address-related fields must be selected in the submission form.

This option applies to the property address and city fields in the submission form.

• If the geolocation system is set to Google Places, typing the address in the front-end submission form will show Google autocomplete suggestions, as in the screenshot below.

• If the geolocation system is set to OpenStreetMap, typing the address in the front-end submission form will show OpenStreetMap suggestions, as in the screenshot below.

2. Place Pin with Property Address Button

If autocomplete is disabled, the submission form will show dropdowns for city, area, state, and similar location fields.

When autocomplete is off, these values must already exist in the admin under property taxonomies so they can be selected in the submission form.

In this setup, the property pin must be placed manually by using the button:

Place Pin with Property Address

This option tells the theme to read the entered address and try to place the pin on the map based on that information.

If you use this setup, make sure the needed cities, areas, and states already exist in the site admin so they can be selected in the form.

Help article for how to manage property categories

Property location must be triggered manually by using the Place Pin with Property Address button, by selecting the pin location manually on the map, or by copying latitude and longitude values.

3. Place Pin Manually on the Map

You can also place the pin manually by clicking directly on the map.

4. Copy Latitude and Longitude

You can also place the pin by manually entering the Latitude and Longitude fields.

Optional: Hide the Map Marker

You can hide the single property map marker location for all properties or only for specific properties.

On the front end, the location looks like this:

You can manage this setting per property:

Or you can hide the location for all properties from theme options: