How to put your journey map on a WordPress site

Simon · September 22, 2024

How to put your journey map on a WordPress site

If you write a travel blog on WordPress, you can put a live map of your journey on any post or page. It shows your route and your pebbls, and it keeps up as you travel, so a post you wrote before you left goes on showing where you've got to.

Our UK to Georgia map embedded in a blog post. Visitors can open any pebbl, or move along the chapters at the bottom

The plugin is called Pebbls Journey Map Embed. It's free on wordpress.org, and embedding a map is free on Pebbls too.

Setting it up

  1. In WordPress, go to Plugins, add a new plugin, search for "Pebbls Journey Map Embed" and install it. In the Pebbls app, JOURNEY › Edit Journey › WordPress Plugin takes you to the same plugin page.
  2. Add the Pebbls Embed Journey Map block to a post or page.
  3. In the block's sidebar, paste your journey's link, the one you'd send to friends (for example www.pebbls.com/adventure-map/you/coast-to-coast), and press Validate Journey. The map appears.

There's a quicker way too: paste the link on a line of its own in your post, and it turns into the map block by itself.

You don't need an API key or a Pebbls login on your website. A link to the journey's map, journal or flyby page will work.

Options in the block

The map and the line under it come in English, French, German, Spanish or Italian, following your site's language.

If you use the classic editor or a page builder, a shortcode does the same job:

[pebbls url="https://www.pebbls.com/adventure-map/username/journey"]

It takes the same options: height="500", stats="yes", click="yes", rounded="no" and border="yes". For your latest journey, use user="username" latest="yes" instead of the link.

Only public journeys can be embedded. Private and password-protected journeys can't.

Not on WordPress

Any website that lets you add your own code can show the map. In the Pebbls app, open the share sheet and tap Embed on Website. Choose a height, a corner radius and a map style, tap Copy Embed Code, and paste it into an "Embed" or "Custom HTML" block on your site. For now the code comes from the app; the Journey Dashboard on the website doesn't have it yet. The help page on embedding has more.

What visitors see

Your route, your pebbls (they can open them for the photos and notes) and a small Pebbls button that opens the full journey page. They don't need a Pebbls account.

Pebbls is a free app that records your route as you travel. You drop pebbls along the way, photos and notes pinned where they happened, and it all builds into a map and a journal of the journey. Most chapters get a flyby film as well. Get Pebbls free.