Documentation
US Map documentation
How to set up and use US Map: install, settings, shortcodes and fixes for common problems.
Overview
US Map is a clickable map of the United States. You choose the active states, color them by your own categories and link each one anywhere.
Where to find it: Settings → US Map.
What you need
- WordPress 5.8 or newer
- PHP 7.4 or newer
Install
- With The Vault (easiest): open The Vault in your WordPress menu, find US Map and click Install. It is installed and activated for you.
- By hand: download it free from the plugin page, then go to Plugins → Add New → Upload Plugin, choose the zip and activate it.
Updates arrive automatically from wpwizards.com, like plugins from WordPress.org.
Quick start
- Add categories. Under Settings → US Map, add the categories you need (for example In person, Telehealth, Coming soon) and give each its colors. Save so they appear in the states table.
- Set up the states. Pick a category for a state to make it active. Add a link to make it clickable and an optional tooltip note.
- Place the map. Add
[wpw_us_map]to a Divi Code or Text module, a Shortcode block or a widget.
Settings
1. Categories
| Label | Shown in the legend. |
|---|---|
| Fill and Label text | The state color and the color of its two-letter label. |
| Hover fill and Hover text | Colors when the pointer is over the state. |
| Inactive states | The color for states with no category. |
| Border color | The outline between states. |
2. States
| Category | Choosing one activates the state. “Not active” leaves it grey. |
|---|---|
| Link URL | Makes the state clickable. Links to other websites open in a new tab. |
| Tooltip note | Replaces the category name in the hover text. |
| Select all / Apply to selected | Change many states at once. Use the filter box to find a state. |
3. Display
| Footnote | Text under the map and legend. Links are allowed. |
|---|---|
| Legend | Shows the category key. |
| State list | A text list of linked states under the map. Good for SEO and screen readers. |
| Max width (px) | 0 uses the full width of the column. |
| Screen-reader label | How the map is announced to assistive technology. |
Export / import
| Export / import | Copy the settings text into another site’s US Map settings to reuse the setup. Links point to the original site, so update them after importing. |
|---|
Shortcodes
[wpw_us_map]
Shows the map.
| Attribute | Values | What it does |
|---|---|---|
legend |
0 or 1 | Hide or show the legend for this map. |
list |
0 or 1 | Hide or show the text list of states. |
footnote |
0 or 1 | Hide or show the footnote. |
width |
number | Maximum width in pixels, e.g. width="900". |
class |
text | An extra CSS class. |
Place a shortcode in a Divi Text or Code module, a Shortcode block, or a widget.
Troubleshooting and questions
Are Alaska, Hawaii and DC included?
Yes. Small Northeast states use outside labels with callout lines so they stay clickable.
A new category is missing from the states table.
Save the settings once after adding the category.
Can I have two different maps?
The map uses one set of settings per site. The shortcode attributes let each placement show or hide the legend, list and footnote.
Get help
Stuck on something this page does not cover? Contact us and tell us which plugin and version you are on. Need it to do something it does not do yet? We build custom plugins too.
