How to Add a Clickable World Map to WordPress

Published on:

If your organization works in more than one country, sooner or later someone asks for “a world map where people can click their country.” It might lead to a local office, a distributor, a shipping page, or a country guide.

This guide is for the person who has to build that map on a WordPress site. You do not need to write code. By the end you will know whether you need a map of countries or of continents, and you will have installed a WordPress world map plugin, colored and linked the areas that matter, added short tooltips, placed the map with a block, an Elementor widget, or a shortcode, and checked how it behaves on a phone.

The steps use the free world maps from WP Map Plugins, the tools I know best. The planning advice works with any clickable world map.

On this page

  1. Countries or continents? Choose the map that matches the job
  2. What you can do with a clickable world map
  3. Install the plugin and place the map
  4. Color the countries and group related areas
  5. Add links, tooltips, and, if needed, a legend
  6. Keep the map readable on a phone
  7. Worked example: a distributor map for 12 countries
  8. When a single-continent or country map is a better fit
  9. Common mistakes
  10. FAQ

Countries or continents? Choose the map that matches the job

Before you install anything, decide what a visitor should be able to click. Getting this wrong is the most common reason a world map gets rebuilt.

There are two kinds of clickable world map:

  • A world map by countries. Every country is its own clickable area. In the WP Map Plugins version, that is 204 countries, each with its own color, link, and tooltip.
  • A world map by continents. The world is divided into six large areas: Africa, Asia, Europe, North America, Oceania, and South America. A visitor can click a continent, not a country inside it.
Two live demos side by side: on the left, the world map by countries with Brazil highlighted and a tooltip; on the right, the world map by continents with Africa highlighted and a tooltip.
Left: the world map by countries, where Brazil is one of 204 clickable areas. Right: the world map by continents, where all of Africa is one area. Both are live demos on wpmapplugins.com with premium features (zoom and a legend) switched on.

A continents map is quicker to set up, with only six areas to edit. A countries map takes longer, but it is the right choice if you have pages for individual countries.

Flowchart: what should a visitor click on? A continent only leads to the world map by continents; any country anywhere leads to the world map by countries; countries in one or a few continents leads to one continent map per continent; regions inside one country leads to that country's own map.
A simple way to pick the right map before you start.

One more check: if visitors need street addresses, directions, or a postcode search, a street map such as Google Maps or OpenStreetMap is the better tool. A clickable world map answers “which country?”


What you can do with a clickable world map

Most world maps on WordPress sites do one of these jobs:

  • Offices and local sites. Each country with an office or local-language site links to it.
  • Distributors and partners. Colors show who covers each country; a click opens their contact page.
  • Shipping and availability. Colors show where you ship and where you do not deliver yet.
  • Projects. NGOs and agencies show where they have worked, one page per country.
  • Teaching. Geography and history sites use the map as a menu into country or continent lessons. The post on using interactive world maps for educational sites covers that use in depth.

Install the plugin and place the map

The world map by countries and the world map by continents are separate plugins, so install the one you chose in the first section. They work the same way.

Step 1: Download and install

  1. Open the product page for your map: the interactive world map by countries plugin or the world map by continents plugin. Choose Download the free version to get the zip file.
  2. In WordPress, go to Plugins → Add New Plugin → Upload Plugin.
  3. Choose the zip file, click Install Now, then Activate.

A new item appears in the WordPress admin menu, such as World Map by Countries. Version 3.1.4 needs WordPress 6.3 or later and PHP 7.4 or later. The documentation covers the same steps in more detail.

Step 2: Open the editor

Click the map's name in the admin menu. You will see a live preview, which behaves like the published map, and a side panel with a searchable list of areas. With 204 countries, type a few letters (“Ger,” “Jap”) to find one. You can also select several countries and change them together.

Step 3: Place the map on a page

When the map is ready (we publish it later in this guide), place it with whichever method fits your site:

  • Gutenberg block. In the block editor, add a block and search for the map's name.
  • Elementor widget. Drag the map widget into a section or column.
  • Shortcode. Paste [wpmp-world-countries-map] for the countries map or [wpmp-world-continents-map] for the continents map. It works in the classic editor, widget areas, and most page builders. If shortcodes are new to you, the beginner's guide to shortcodes explains them.

All three show the same map, and published changes appear everywhere it is placed.


Pick a small number of color groups

Two or three groups are usually enough: for example “has an office,” “served by partners,” and “everything else.” Each extra color is one more thing to decode.

For each group, write down one fill color as a hex code (such as #227A7C) and a slightly darker or lighter hover color. Keep enough contrast between the country color and its label so the two-letter labels stay readable.

Set the colors in the editor

  1. Search for the first country in the list and select it.
  2. Set its Color, Hover color, Label color, and Label hover color.
  3. Repeat for the other countries in the group, or select them all at once and set the colors together.
The world map by countries editor panel: the Countries tab with a searchable country list, and below it the color, hover color, label color, and label hover color fields for Kazakhstan.
The per-country settings in the editor. This screenshot is from the premium edition, which adds the formatting toolbar for tooltips and the Zoom, Pins, Legend, and Regions tabs. In the free version the tooltip is one line of plain text; the color fields work the same way.

Countries you do not set keep the map-wide Inactive color from Map settings. A neutral inactive color keeps the countries you cover in focus.

Grouping countries (premium)

Premium adds Regions, which group countries so they highlight together and share one color, tooltip, and click action. That suits a “Nordic countries” page that covers several countries at once.


Links

Under When clicked, choose Open a link and paste the page address, or Nothing for countries that only show a tooltip. For pages on your own site, opening in the same tab is usually best.

Only link a country to a page that exists and is genuinely about that country. If you have nothing to say about it yet, leave it unlinked.

Tooltips

A tooltip is the small label that appears on hover. Keep it short: the country name and a few words, such as “Germany · local distributor.” In the free version a tooltip is one line of plain text. Premium adds formatted tooltips with bold text, colors, lists, and a small image.

One limit: a tooltip cannot contain a clickable link, because it closes when the pointer leaves or the country is clicked. Link the country itself, or use a premium popup for text, images, links, and video.

Legend (premium, optional)

If your colors mean something, say what. Premium has an optional legend under the map. Without it, add one sentence under the map, such as “Teal: local distributor. Blue: export team.”


Keep the map readable on a phone

On a phone, the whole planet shrinks to the width of the screen. Large countries stay easy to tap; small ones, such as Luxembourg or Singapore, become tiny targets.

  • Check the tap behavior. Phones have no hover. In Map settings, the On phones and tablets option lets you choose between “First tap shows the tooltip, second tap opens” and “One tap opens the link or popup.” Countries without a tooltip always open on the first tap.
  • Put a text list under the map. For small countries and screen-reader users, a short list of the same links is the most reliable fallback. The post on creating an accessible web map explains why.
  • Consider zoom. Premium adds optional zoom and pan controls, which make small countries easier to reach.
  • Test on a real phone. Tap three or four countries and check each one does what you expect.
A world map on a narrow phone-width screen with a premium formatted tooltip showing a photo placeholder, a name, a role, and a phone number.
Premium: a formatted tooltip on a phone-width screen, from a test install. The contact details are example data.

Because the map is inline SVG on your own page, it scales cleanly to any width without blurring. If you want the background on why that matters, see vector (SVG) vs raster (PNG) maps.


Worked example: a distributor map for 12 countries

Here is a plan you can copy (example data, not a real company). A manufacturer has local distributors in six countries (Germany, France, Japan, Brazil, South Africa, and Australia) and an export team that serves six more (Canada, Mexico, India, the United Arab Emirates, Kenya, and Chile). Everywhere else, buyers use a general contact form.

Example link plan table with three groups: local distributor countries in dark teal linking to their distributor page, export-team countries in light blue linking to the export contact page, and all other countries grey with no link.
Plan the groups, colors, tooltips, and destinations before you open the editor. Example data.

Build it in five steps

  1. Pick the map. Visitors choose a country, and the countries are spread over six continents, so this is a job for the world map by countries.
  2. Fill in a spreadsheet first. In the editor, open Import / Export and click Export CSV. You get one row per country, identified by its two-letter code (DE, FR, JP, and so on). For the 12 countries, fill in the fill, hover, tooltip, action (use link), and url columns, and leave the other rows alone.
  3. Import it. Click Import CSV and choose your file. Empty cells keep their current values, so the other 192 countries are untouched. The import is saved as a draft until you publish.
  4. Check in the preview. Hover over each colored country. Make sure the tooltip reads well and the link goes to the right page.
  5. Publish and place. Click Publish, then add the block or the [wpmp-world-countries-map] shortcode to your distributors page, with a sentence under the map that explains the two colors.
The Import / Export tab: JSON export and import of all settings, and CSV export and import of countries, with the list of CSV columns.
The Import / Export tab. JSON copies the whole map (handy for backups or moving to another site); CSV is a spreadsheet of countries. Shown in premium, which adds a few extra columns; CSV and JSON import and export are also in the free version.

The next time a distributor changes, you edit one row.


When a single-continent or country map is a better fit

  • All your countries are in one continent. If you only work in Europe, a Europe map shows the same countries much larger and easier to click.
  • You work in several continents, but by region. Some sites have a page per continent and want country-level detail on each. The 6 continent maps package is six separate plugins (Africa, Asia, Europe, North America, Oceania, and South America), each edited and placed on its own. It is different from the world map by continents, which is a single map with six areas.
  • Everything is inside one country. Use that country's map, such as the US map with its 50 states plus DC. The earlier guide on adding a clickable US map to WordPress walks through that case.
Live demo of the Europe map with France highlighted in orange and a tooltip reading France, EU shipping, click to explore.
The live demo of the Europe map, with countries colored by shipping status. On a single-continent map, small countries such as Luxembourg and Slovenia get far more room than on a world map. (This demo has premium features switched on.)

Common mistakes

  • Buying the continents map when you need countries. The world map by continents has six clickable areas. If your pages are per country, you need the world map by countries. Check this first.
  • Linking countries to pages that do not exist yet. Link what is ready; leave the rest neutral.
  • Putting links in tooltips. Tooltips close on click, so links inside them cannot be used. Link the country, or use a premium popup.
  • No text around the map. A heading and a sentence about what the map shows help search engines and screen-reader users.

FAQ

What is the difference between the world map by countries and the world map by continents?

They are two separate plugins. The world map by countries has 204 clickable countries, each with its own color, link, and tooltip. The world map by continents has six clickable areas, one per continent, and visitors cannot select individual countries on it. Choose by what a visitor needs to click.

Is the free world map a trial?

No. The free version is a complete map with the visual editor, colors and links for every area, one-line tooltips, the block, the Elementor widget, the shortcode, and JSON and CSV import and export. It shows a small credit link under the map.

Can a tooltip contain a link?

No. A tooltip closes when the pointer leaves the area or when the area is clicked, so nothing inside it can be clicked. Link the country itself, or use a premium popup window, which can hold text, images, links, and video.

Can I show more than one world map on my site?

Yes, in premium. Extra maps use their own shortcodes, such as [wpmp-world-countries-map-2], and each one has its own settings. The free version has one map.

How much does the premium version cost?

As of 20 November 2026, the premium world map by countries is a one-time payment of $29.95 and the premium world map by continents is $9.95. The package of six separate continent maps is $49.95. There is no subscription and no license key. Check the product page for the current price.

What happens to my map if I upgrade from free to premium?

You install and activate the premium plugin. It replaces the free copy and keeps your map settings, so you do not have to redo your colors, links, or tooltips.


Try it on your own site

If you have pages for individual countries, start with the free version of the World Map by Countries and build the map from a spreadsheet as in the example above. If your content is organized by continent, the free World Map by Continents is the quicker route. Each product page has the free download, a live demo, and a free-vs-premium comparison.

WP Map Plugins is our product.


Botrous Kerolos

About the Author

Botrous Kerolos has been designing and building interactive maps for the web since 2009 — from early Flash/SWF maps to modern SVG — and leads development at WP Map Plugins, helping WordPress sites turn static content into fast, accessible, interactive experiences.