Add a map to any post or page on your site with the Jetpack Map Block.
Special requirements to use the Map block
To use the map block, you need a Mapbox access token. Without this token, the block can’t display any maps.
Here’s how to get the access token:
- If you don’t already have a Mapbox account, go to https://www.mapbox.com/signup/ and create one —it’s free.
- Sign in to your Mapbox account.
- Go to the Account page and look for the Access Tokens section at the top menu.
- Copy the Default public token to your clipboard. You don’t need to create a new one.
- The first time adding a Map block on your site, you’ll see a prompt to enter your Mapbox access token.
- Paste the Default public token you copied to your clipboard earlier into the token field in the Map block.
- Click Set Token.
Add the Map Block
The Map Block is a part of the Jetpack Blocks suite and is activated by default. It does not require a paid upgrade to use. See our Jetpack Blocks article to learn about the available blocks and how to activate them.
Jetpack Blocks require the Block Editor (also referred to as the Gutenberg editor). If you’ve installed the Classic Editor plugin, you have a few options:
- Deactivate the Classic Editor: Go to Plugins → Installed Plugins in your WP Admin and deactivate the Classic Editor plugin.
- Enable both editors: If you prefer flexibility, navigate to Settings → Writing in your WP Admin (not the menu under Jetpack settings). Set Allow users to switch editors to Yes. You will only see these options if you have the Classic Editor plugin installed and active.
Some custom themes or plugins may prevent you from using the Block Editor. In that case, please contact the support team for the plugin or theme for further assistance.
For more details, see Using Blocks and the Classic Editor.
You can add the Map Block to any post or page by searching for Maps on the block picker. The Jetpack Map block has a green icon. See our Jetpack Blocks page for more information on adding Jetpack blocks. After you’ve added the Map block, follow these steps:
- The map will load with a text field where you can add a location marker, saying “Add a location”.
- Type the location you want to display on the map. This can be as general or specific as you wish, and the location will autocomplete as you type.
- Click the correct location to add it to your map.
- Click on the red marker symbol to edit the Marker Title and Marker Caption. Editing the address in the Marker Caption field will not change the marker’s position; it will only change the text displayed on your map when the marker is clicked.
- If an address is not correctly located on the map, you can contribute to improving the accuracy of the location marker. Mapbox allows you to improve its data by suggesting an edit through its map utility.
Add additional location markers
You can add more than one location marker to the same map. For example, if you have a chain of restaurants and you want to display all their locations on one map, you can add a marker for each.
To add additional location markers:
- Click Add a Marker in the same map block on your page/post.
- Enter the location details as per the instructions above.
- Repeat the action for each additional marker.
When you add multiple location markers, the map will zoom out to display all markers.
Map block settings
When you select the Map block in your WordPress editor, you can access the block settings from the right sidebar.
Map appearance
There are different options to customize the appearance of your map:
- Map themes.
- Options on whether to show street names or not.
- Location markers colors.
- Height, zoom level, and full-screen options.
Markers section
You can edit all your markers from the Markers section settings. Editing a marker from the block settings works exactly the same as clicking on the marker itself and editing the block; however, using these settings may be easier if you have a lot of markers to edit.
Mapbox access token
You can update or remove your Mapbox access token from this section.
If you have multiple maps on your site, removing an access token from one map will remove it from all of your maps, but your location markers will be saved, so they will still be there if you add a new access token.
Advanced Map block settings
In the Advanced settings, you can add a custom CSS class to your map so that you can do your own custom CSS styling if desired.
Still need help?
Please contact support. We’re happy to advise.
Privacy Information
The Map block is activated by default. It cannot be deactivated; the Map block is always available in the Block Selector.
The Map block uses Mapbox. Their privacy policy can be found here: https://www.mapbox.com/privacy/.
| Data Used | |
|---|---|
| Site Owners / Users
Mapbox API key. Search terms are sent to Mapbox when looking for locations. Map tiles are loaded from Mapbox. | Site Visitors
None. |
| Activity Tracked | |
| Site Owners / Users
We don’t track anything. Refer to the Mapbox privacy policy for details of any activity they track. | Site Visitors
We don’t track anything. Refer to the Mapbox privacy policy for details of any activity they track. |
| Data Synced (Read More) | |
| Site Owners / Users
Mapbox API key. Post contents. We also sync options that identify how the feature’s available settings are configured. | Site Visitors
None. |
Jetpack 