Skip to content
Knowledge Base

How to embed a simple Google map in WordPress

For a simple location map, use Google Maps’ Embed a map sharing option and place the copied HTML in a supported HTML element. This is different from configuring a theme’s API-based map module.

If you only want to show one business location, a standard embed can be sufficient. A theme module with multiple locations or custom map behavior may require its own API setup and documentation.

Check which WordPress account will insert the embed. Custom HTML content can be filtered according to permissions; an account without the required unfiltered_html capability may have iframe markup removed. Do not change security permissions casually to bypass that restriction.

  1. On desktop, open the intended location in Google Maps and verify its address.
  2. Choose the sharing option and open Embed a map.
  3. Copy the HTML provided by Google Maps.
  4. In WordPress, add a Custom HTML block, or the documented HTML element in your page builder. Paste the copied code and save the page.

Google’s standard sharing flow is not the same as the Maps Embed API or JavaScript API documentation. It also does not fix an API-key error inside a different theme map element.

Open the published contact page and confirm the pin refers to the correct place. Check the map width on a phone and whether it displays under the site’s existing privacy/consent settings.

If the iframe disappears after saving, ask the site’s administrator to review the editor permissions and permitted embed method. If a placeholder appears, inspect the existing consent or embed plugin’s configuration rather than assuming Google Maps itself is broken.

Include readable address text and clickable contact details alongside the map so visitors can still find the information.