Map Settings

Houzez allows you to choose which mapping system you want to use throughout your website. You can switch between different map providers depending on your needs and budget.

Available Map Systems

• Google Maps – Paid service, requires API key and billing account
• OpenStreetMap – Free and open-source
• Mapbox – Free up to a certain usage limit, requires API key

This flexibility helps you optimize your site's performance while keeping control over your budget.

Map Selection Mode

From your WordPress dashboard, go to: Theme Options → Map Settings

The first setting you'll see is the Map Selection Mode, which determines how maps are applied across your site:

• Global – Use the same map provider across all areas of your website.
• Specific Areas – Use different map providers for specific sections like listing pages, property detail pages, submission forms, etc.

Global Mode

When Global is selected, you can choose one map system that will be used site-wide.

You'll see this option:

• Global Map System choose between:
  • OpenStreetMap
  • Mapbox
  • Google Maps

The selected system will be applied universally except for the admin panel.

Note: The "Submit Property Form – WP Admin" section can be configured independently.

Specific Areas Mode

If you need more control, choose Specific Areas to assign different map providers to different sections of your website:

• Header Map – Used in property pages with map headers.
• Listing Taxonomy Maps – Used in category/tag archive pages with maps.
• Half Map Template – Used in search result pages with half map layout.
• Property Detail Page – Displayed on single property pages.
• Submit Property Form – Used in front-end property submission.
• Agent/Agency Detail Page – Map shown in agent/agency profile pages.
• Submit Property Form – WP Admin – Used in the WordPress admin when adding/editing a property.

For each section, you can independently choose:

• OpenStreetMap
• Mapbox
• Google Maps

This setup is ideal for optimizing performance, user experience, and map service costs.

API Keys & Common Settings

From your WordPress dashboard, go to: Theme Options → Map Settings

After selecting your preferred map system (globally or per specific area), you may need to configure the additional settings listed below. These settings apply differently depending on which system (Google Maps or Mapbox) you've selected.

Google Maps API Key

Enter your Google Maps API key if you plan to use Google Maps globally or in any specific area.

Check → How to setup Google Maps API

Mapbox API Key

Required only if you choose to use Mapbox.
Check → How to setup Mapbox API

Google Map Type

Choose the visual style of your Google Maps:

• Road Map (default)
• Satellite
• Hybrid
• Terrain

This setting only affects Google Maps.

Marker Type

Choose how property locations appear on the map (Google Maps and Mapbox only):

• Marker Icon (custom pin icon)
• Price Pins (displays property price inside a label)

For full setup instructions and customization options, check the documentation here:
Google Maps Markers – How to set them up →

Zoom Settings

• Default Zoom – Controls the initial zoom level on map load (e.g. 12)
• Maximum Zoom Level – Maximum level users can zoom into the map

Fallback Coordinates

These values are used when a property or agent doesn't have a defined location:

• Default Fallback Latitude – e.g. 25.686540
• Default Fallback Longitude – e.g. -80.431345

Limit Geocoding/Autocomplete to Country

This setting restricts map suggestions to a specific country when searching addresses. This is useful to improve speed and relevance of autocomplete results.

• Enable or disable the restriction
• Select the target country from the dropdown (e.g., United States)