Plugins / Partner Map Locator / Documentation

Partner Map Locator

Applies to Free 1.4.12 and Pro 1.3.5. Updated Sep 14, 2026. 35 min read

This guide covers the free plugin from wordpress.org and the Pro add-on from desk9design.com: installing both, adding and importing locations, Google keys, the block and shortcode with every attribute, the designs and the guided entry, search and popups, markers and clustering, styling, the lead form and analytics, every setting of the six tabs, licensing, privacy, translations and troubleshooting. Pro-only parts are marked.

1. Overview

Partner Map Locator shows partners, dealers, stores or branches on a map with a searchable, filterable list. Locations are ordinary WordPress posts, so any editor can maintain them and they travel with your content. The map runs on OpenStreetMap without an account, on Google Maps with your own key, or not at all: a fresh install starts in “List only” mode and contacts no external service.

The free plugin from wordpress.org is complete on its own. Partner Map Locator Pro is an add-on: it needs the free plugin active, hooks into it and unlocks the extra designs, the guided entry, the popup overlays, marker clustering, the lead form, the analytics dashboard and updates from desk9design.com. Without a licence the add-on stays dormant. A licence that runs out stops the updates, never the features.

	Free	Pro
Locations post type, all fields, four taxonomies, opening hours, badges	yes	yes
Map providers: OpenStreetMap, Google Maps, list only	yes	yes
Block and shortcode with every attribute, several maps per page, grouped instances	yes	yes
Designs	Classic, Tab view, Mixed view, Stack view	plus Designs 1 to 7, Pocket, Table
Guided entry (Discover, Guide)	no	yes
Search, filters, radius, near me, standard pin popup	yes	yes
Map popup overlays (mini, normal, mini-on-pin)	no	yes
Markers, numbering, per-term colours, legend	yes	yes
Marker clustering	no	yes
CSV import and export, demo data, Places import, ratings sync, geocoder	yes	yes
Consent gate, Schema.org, WPML and Polylang, setup wizard	yes	yes
Styling: colours, fonts, radii, shadows, badges, visibility tables, action buttons	yes	yes
Lead form, analytics dashboard	no	yes
Updates and support	wordpress.org	desk9design.com licence, priority support

Pro-only chapters carry a badge in the navigation. Inside a chapter, Pro marks the parts and the settings that need the add-on.

2. Requirements

WordPress	6.2 or newer (tested up to 7.1), single site or multisite
PHP	7.4 or newer
Free plugin	required by the Pro add-on: Partner Map Locator 1.4.0 or newer; the block preview of Pro designs needs 1.4.11
Google account	not required. Only for the Google Maps provider, the Places import, the ratings sync and the geocoder
Theme	none in particular. Works with block and classic themes
HTTPS	needed for “Near me”: browsers only share the visitor’s position on secure pages

3. Install the free plugin

Everything below the “Working with visitors” group works without Pro. You can run the free plugin for as long as you like and add the add-on later; the settings and locations stay.

4. Install Pro from your account

Pro is a second plugin next to the free one. Keep the free plugin active; the add-on does nothing without it.

Note: the add-on needs free plugin 1.4.0 or newer. With an older core the Pro designs do not appear; update the free plugin first.

5. Activate your licence

Activation counts per site URL. A staging copy in a subfolder or on another domain uses a slot of its own; development domains do not count (section 27). Everything about renewals, slots and what happens when a subscription lapses is in section 26.

6. Quick start with the setup wizard

Locations > Setup walks through the three decisions a new site needs. Every one of them can be changed later under Settings.

Then open the page. With OpenStreetMap you see a map with one pin and the list under it. Pick a design under Locations > Settings > Designs (section 12) and adjust colours on the Style tab (section 17).

7. Adding locations

Every location is a post under Locations > All Locations. The title is the partner name, the editor text is the description, the featured image is the card and popup photo. The Location details box holds the rest:

Field	What it does
Address, postal code, city, region, country	shown in cards and popups; the address feeds the geocoder. Region and country also fill the Table design’s Region column
Latitude, longitude	the pin position. Type them, click Look up coordinates (needs the geocoder, section 10) or import them. Without coordinates the location is listed but has no pin
Phone, e-mail, website	contact rows with icons and action buttons. Phone and e-mail dial and mail on phones
Business hours	weekly opening hours with closed days. The page shows a live “Open / Closed / Opens Mon at 09:00” status in the site’s time zone
Logo image	a small square or round mark next to the title (shape on the Style tab)
Featured, Sticky	Featured shows the “Top partner” badge (text, icon, colours and position on the Style tab; list, popup or both on the Layout tab). Sticky keeps the location at the top of the list whatever the sort
Showroom	a yes/no flag with its own filter and badge
Marker override	a marker shape or an uploaded marker image for this location only
Google Business / Maps URL, rating, review count, place ID	filled by the Places import or the ratings sync; shown as a rating row with a link to the reviews
Custom button	a per-location link with its own label, for a booking page or a partner profile
Call-to-action button	which button is primary for this location; overrides the site-wide default from the Layout tab
Active	untick to hide a location without deleting it

The description is shown in full in the popup and shortened in the list. The length and the “Read more” toggle are on the Layout tab (“Description length”). The locations table in the admin has columns for city, coordinates and taxonomies, and quick edit for the flags.

Import a partner from Google

In the editor, paste a Maps or Business Profile share link (long, short or g.page links all work) into Import from Google Maps link, or search the business by name. Name, address, phone, website, opening hours, rating and review count fill themselves in. Needs a Google key with the Places API (New), section 10.

8. Categories, product types, partner levels, highlights

Four taxonomies organise the locations. Each is a filter dropdown, a badge in cards and popups, a column in the Table design and a possible source for marker colours and the legend. Their display names can be changed on the Layout tab, for example “Categories” to “Regions”; every filter, column and badge follows.

Taxonomy	Typical use
Categories	the main grouping: regions, business types, brands. A block or shortcode can be limited to one category
Product types	what a partner offers; the Table design labels the column “Services”
Partner levels	tiers such as Bronze, Silver, Gold. Usually one per location; Design 5 and the Table can sort by it
Highlights	free tags such as “Showroom” or “Training centre”; shown in the card header, as a row, or both

Manage terms under Locations > Categories and the three sibling screens. Each term can carry a colour and an SVG icon: the colour tints badges, chips, markers (when “Marker color source” points at that taxonomy) and the legend; the icon appears in the icon-based badge styles and in the quick-filter strips of Design 3 and Design 4. Terms without a colour are skipped by the legend.

9. Import, export, demo data

Locations > Tools collects the bulk jobs:

Tool	What it does
Export CSV	every location with all fields and taxonomies. The export is a valid import file, so bulk edits can round-trip through a spreadsheet
Import CSV	upload a file with the header row below. Taxonomy columns take pipe-separated term names and create missing terms. Locations are matched by title: existing ones are updated, new ones created
Demo locations	imports sample partners to try designs and settings; one click removes them again
Import from a previous installation	copies locations that still exist in the database from an older store-locator setup
Reset settings to defaults	keeps locations and terms, resets every option
Delete all locations permanently	does what it says. Export first

title,address,postal_code,city,region,country,latitude,longitude,phone,email,website,google_rating,google_review_count,google_reviews_url,categories,product_types,partner_levels,highlights,featured,featured_sticky,marker_style_override,active

Note: moving from another locator plugin: export its data as CSV, rename the columns to the header above (the Export gives you the template) and import. Coordinates in the file save you the geocoder calls.

10. Google data and API keys

Nothing here is required. With OpenStreetMap you can skip this section. If you want Google features, you need at most two keys from the Google Cloud Console in a project with billing enabled:

Key or feature	Where and what for
Google Maps API key	Settings > Map. Runs in the visitor’s browser. Enable Maps JavaScript API and, for the import in the editor, Places API (New). Restrict it by HTTP referrers: your domain plus .../wp-admin/* so the location editor can use it. This one key covers the map, the Maps-link import, the business search and autocomplete.
Google Places API key (optional)	Settings > Integration. Runs on your server. Only needed for the scheduled ratings sync, which sends no referrer. Restrict it by your server’s IP address, not by referrer. Leave empty to use the Maps key; the message “API key restricted to websites” then only concerns the scheduled sync.
Google Map ID (optional)	Settings > Integration. A Map ID from Map Management switches the map to Advanced Markers and applies the cloud-based style attached to it. Everything works without one.
Geocoder	Settings > General: “Geocoding (admin only)” enables Look up coordinates in the editor. Needs the Geocoding API on the key. Off by default, on request only.
Ratings sync	Settings > Integration: refreshes rating and review count of every location with a Business / Maps URL daily, weekly, monthly or quarterly; values also refresh when you save a location. The tab shows an estimate of today’s API calls.

Note: all Google features except the map itself run on your server with the place ID, search text or address you entered. No visitor data is sent. The visitor’s browser only contacts Google when the map type is Google Maps or “Web font loading” is set to Google.

Errors show in the browser console: RefererNotAllowedMapError means the referrer restriction does not match your domain, ApiNotActivatedMapError means the Maps JavaScript API is not enabled for the project, API_KEY_HTTP_REFERRER_BLOCKED on the server means the Places key is referrer-restricted and needs an IP restriction instead.

11. Block and shortcode

Add the Partner Map block (search “Partner Map” in the inserter) or the shortcode [partner_map_locator]. The block previews the real markup with your colours and design in the editor; the interactive map itself is a labelled placeholder until the page is published. Both offer the same options; every option you leave alone follows the global settings.

Attribute	Values	Effect
design	classic, tab_view, mixed_view, stack_view; with Pro also design1 to design6, focus, pocket, table	this design on this page only; its own layout comes with it
layout	split, split_left, tab, tab_left, mixed, mixed_left, stack, fullscreen, fullscreen_left	override the layout that comes with the design
category, product_type, partner_level, highlight	a term slug	pre-filter, invisible to the visitor: only locations with that term
height	pixels	map height for this instance
zoom, lat, lng	numbers	initial zoom and centre instead of fitting all pins
list	1 or 0	show or hide the list
limit	number	load only the first N locations
map	list	map="list" renders the list without a map while the site keeps its provider
mode	complete, search, filter, search_filter, map, list	which parts to render, for split displays across several blocks
group	text	instances with the same group share search, filters and results
viewport_sync	1	the list follows the map: only locations inside the visible area are listed
show_results_count, show_total_count	1 or 0	the “Showing X of Y” line and the total count for this instance
legend	1 or 0	the map legend for this instance

[partner_map_locator]
[partner_map_locator category="region-north"]
[partner_map_locator design="classic" map="list"]
[partner_map_locator design="table" height="500"]
[partner_map_locator design="focus" height="640"]
[partner_map_locator design="pocket" limit="3"]
[partner_map_locator mode="search_filter" group="finder"]
[partner_map_locator mode="list" group="finder"]

Split display modes

The block’s Display mode (shortcode mode) cuts the locator into parts you place anywhere on the page: the search in a hero section, the filters in a sidebar, the list further down. Parts with the same Group ID share one state, so a search in the hero filters the list below. The last two lines above are such a pair.

Several complete maps on one page are fine too. Each block or shortcode is its own instance with its own filters unless you give them a group.

12. Designs

A design ties together a layout, typography and look. Pick the site-wide design under Locations > Settings > Designs; override it per page with the design attribute or the block’s Design select. Selecting a card changes nothing else; Apply recommended settings on a card additionally sets its typography, visibility and card style. Colours and the marker palette always stay site-wide (section 17).

The four free designs

Design	Character
Classic	Split view: map and a list sidebar side by side. The default look.
Tab view	Search and filters above a full-width map. On phones a tab bar switches between map and list.
Mixed view	Search and filters above a split area with map and list side by side. Best on large screens.
Stack view	One column: search, full-width map, then the list. Works the same on every screen; good for landing pages. List-only mode uses this layout too.

Designs 1 to 7 Pro

Design	Character
Design 1	Edge-to-edge map with a floating list panel, compact text, filter chips and a floating card popup. Optional mini list: slim two-line rows with name and “level, rating, reviews”.
Design 2	Editorial split view with a chip-style quick-filter row over all four taxonomies, polished list cards with a rank badge and a small floating map-preview card instead of the native popup.
Design 3	Like Design 2 with an icon-based quick-filter strip, benefit grids and dual buttons on the cards.
Design 4	A unified pill-style search bar (place, radius, one taxonomy, search), an icon strip and a two-column photo grid in the list. Best with featured images; a gradient by partner level stands in without one.
Design 5	Speed finder: edge-to-edge map, a floating pill search bar, glass chip row, a hero card bottom-left, a narrow rail list on the right, numbered ring markers, an optional sort bar (distance, rating, one custom button).
Design 6	Editorial cream-paper look with serif headlines, connected search-strip fields, checkbox or compact-bar filters, serif rank numbers and square serif markers.
Design 7	One floating panel that switches between the result list and a single partner in full, with a back control: the maps-app pattern. On phones the panel becomes a draggable sheet, a panel below the map, or a full list.

Pocket and Table Pro

Design	Character
Pocket	A compact widget for a sidebar, a product page or a footer: a heading, a postcode field, a small map band, the nearest few partners and a link into the full locator. Everything that does not fit in 400 px is left out rather than shrunk.
Table	Compare, do not browse: a filter bar with in-field labels, a thin map band and a sortable table with the columns you choose. Click a column heading to sort; the marker numbers follow. Record cards on phones.

Layouts underneath the designs: split (list beside the map, left or right), tab (map and list as tabs on phones), mixed (search above, list beside), stack (one column) and fullscreen (the map fills the stage, the list floats over it). Each design’s own options are on the Designs tab under Layout options and change with the selected design; the full list is in section 22.

13. Guided entry

Under Settings > Designs > Guided entry you put a first step in front of whichever design you use. The visitor answers what they need and where they are and lands on the design with those answers applied as ordinary filters; Change answers brings the step back.

Finder	What the visitor sees
Discover	a search field with shortcut buttons for the taxonomies you pick, counts from the loaded locations, and an optional “no map has loaded yet” note. Used as a design of its own, no map tile loads until the visitor searches.
Guide	three questions, one tap each: what do you need (one taxonomy of your choice), where are you (city, postcode or “use my location”), how far will you travel (up to four distances). Progress bar, back button, optional “Skip and show all”. Stage and card colours are configurable.

Note: the design underneath, including its map, loads hidden behind the finder. Discover’s load-no-map-until-searched behaviour only applies when Discover runs as the design itself (design="discover").

14. Search, filters, radius, near me

The toolbar holds the free-text search (name, city, address, services), one dropdown per taxonomy, the radius select and the result limit. Which of them appear and in which order is the Toolbar table under Settings > Layout > List & map visibility. Dropdowns are single-choice with an “All” entry, or multi-select (Map tab). Designs with a chip row show quick-filter chips with counts and an overflow menu.

Radius	the circle is drawn around the map centre, or only after the visitor shares their position (“Radius circle anchor”). “Filter map by search radius” hides everything outside; off, all loaded locations stay visible, which suits dealers spread across a large area.
Near me	“Browser geolocation” on the Map tab shows the My location button, as a text pill or a floating cursor button in a corner. The browser asks the visitor for permission and needs HTTPS. Distances then appear on the cards (style on the Style tab) and the list can sort by distance.
Counts	the number of loaded locations, the live “Showing X of Y” line with a Reset link, and the counts on chips and dropdown entries are separate switches on the Layout tab.
Paging	“Locations per page” with Previous / Next, Load more or infinite scroll. Map markers always show every match.
Viewport sync	viewport_sync="1": the list shows only what is inside the visible map area.

15. Popups and overlays

Clicking a pin or a row opens the location’s detail. What opens, and from where, is on the Layout tab under “Applies to every design”.

Popup style	What the visitor sees
Standard popup on the pin	the classic popup attached to the marker, in every design. Its content blocks and their order come from the Visible elements table; width under Map defaults; separators, close button and description length are separate options.
Pro Mini overlay	a compact floating card on the map with name, address, rating and three tags.
Pro Normal overlay	the full popup content as a floating card in the corner opposite the list: photo, contact, hours, buttons.
Pro Mini on pin	the compact card attached to the marker instead of the corner.
Open on	Automatic (a design with a floating card opens it on hover, one with a pin popup on click), Hover, or Click. Touch screens always tap.

Design 7 has its own choice: a normal popup that honours the style above, or the details in the panel with a back control. Pocket can highlight the row only, because a popup would cover its small map.

Action buttons

Directions, website, phone, e-mail, the custom link and the enquiry button appear in cards and popups. Settings > Layout > Action buttons sets which ones show on which surface, their order and the primary one; each location can override the primary button. Buttons whose data is missing for a location hide themselves. Colours are on the Style tab.

16. Markers, clustering, legend

Marker style	Style tab: dot, drop pin, square, heart, star, or an uploaded PNG. The colour comes from the palette, or from a taxonomy (“Marker color source”): each pin takes the colour of the location’s first term.
Active pin	the selected location’s pin recolours and lifts above its neighbours (the “Marker color” setting for the active pin).
Numbered rows and markers	Layout tab: a circular number before each list row, and the same number on the pins, so a visitor matches row and pin at a glance. Design 5 and 6 draw the number into their own markers.
Pro Clustering	Map tab: nearby pins collapse into a counted circle until the visitor zooms in, on OpenStreetMap (bundled leaflet.markercluster) and on Google Maps (bundled grid clusterer). With per-term marker colours the cluster ring shows the term mix. Worth it from a few dozen locations on.
Legend	Style tab: a floating legend built from one taxonomy’s colours, in any corner, with an optional title. “Auto” follows the marker colour source. Clicking a swatch filters the map.
Map controls	Map tab: native zoom buttons, Google’s map type switcher and navigator, the geolocation button style, distance unit, default view (fit all pins or a fixed centre and zoom), colour schemes for both providers and custom styles.

17. Styling

The Style tab sets the look shared by every design. The Layout tab decides what a card contains; the Designs tab holds each design’s own options.

Group	Options
Colour palette	background, text, accent, marker and active-marker colours; legend background; primary and secondary button colours. Buttons and the legend keep their own surface, so a dark background never makes them illegible.
Typography	one global font, or separate fonts and weights for headings, body text and badges. System fonts and 9 Google fonts. Web font loading: self-hosted from the plugin (default, no request to Google), system fonts only, or from Google’s CDN.
Sizes and corners	heading, card and popup text sizes; one corner radius for cards, inputs and buttons; a separate radius for the map canvas.
List and popup cards	gap between list and map, outer safe-space margin, drop shadows on or off, logo shape, contact icons, distance display style, block separators and their spacing.
Badges	per taxonomy: text pill, pill with icon, or icon plus label. The featured badge: label, icon, icon-only, position (inline, after the title, floating corner), colours, radius. Numbered-badge colours.
Custom button	the per-location button follows the global button styles or gets its own colours.

The full list of every Style option is in section 23.

18. Lead form

The enquiry form lets a visitor write to a partner directly from the map. Under Settings > Integration > Enquiry form choose Built-in form: every popup and detail card gets a “Send enquiry” button that opens a modal with name, e-mail, phone, message and a required consent checkbox with your text.

Recipients	the location’s own e-mail address, plus the Admin recipient as Bcc. Empty means the site admin e-mail. The visitor is the Reply-To.
Texts	button label, modal title, e-mail subject (with {location}), consent text (a link to your privacy policy is allowed), success message.
Spam protection	always on: a honeypot field, a time trap, a per-IP rate limit and the consent requirement. When the Akismet plugin is active and keyed, every enquiry is checked there as well. There is no external CAPTCHA, so nothing loads from a third party in the visitor’s browser.
Embedded form	Embed a form plugin shows a Contact Form 7, WPForms or other shortcode in the modal instead; the partner’s name is passed to it.
Look	colour and opacity of the dimmed area behind the modal. The enquiry button joins the action buttons and can be the primary one.

Note: the settings for the form are part of the free plugin’s Integration tab, so you see them either way; the button and the form itself need the Pro add-on.

19. Analytics

Turn on Internal analytics under Settings > General > Advanced. Locations > Analytics then shows, for today, the last 7, 30 or 90 days or all time, with the previous period for comparison: map and list views per location, searches (top searches and zero-result searches), filter usage, list and popup interactions, clicks on directions, website, phone, e-mail and the custom button per partner, device classes, and the top locations by views and by clicks.

Setting	What it does
Daily analytics retention	how many days of daily rows to keep (0 to 3650, default 365). A daily job prunes older rows. Lifetime totals per location are never pruned.
Track search query text	store the typed search text for the top-searches panels, or count searches only and redact the text.
Respect “Do Not Track”	record nothing for browsers that send DNT: 1.

Events are counted on your own server per location and per day. No cookies, no visitor IDs, no IP addresses, no third-party script. Switching the option off stops recording; existing data stays until the retention period ends. The lifetime totals also appear in the CSV export.

20. Settings: General

Sections 20 to 25 list every setting under Locations > Settings, tab by tab, in the order of the screen: 235 settings, 62 of them Pro. Settings under “Layout options” appear only while their design is selected; a few Map-tab settings appear only for the matching provider. Each tab saves on its own.

How these settings apply

You choose one map type for the whole site (which scripts may load). Use global list-only or the shortcode/block list-only option when only one page should omit the map. The List & map visibility table has separate Description checkboxes for list vs popup. Under Features, the “Description length (max.

Advanced

Setting	What it does
Persist location query cache (no object cache)	WordPress already caches location queries in memory. Enable this to also store results in the database for five minutes when no external object cache (Redis/Memcached) is available, useful for busy REST or shared-hosting sites.
Pro Internal analytics	Count map/list views per location and clicks on route, website, phone, email and custom-button links. No third-party tracking, data stays in WordPress.
Pro Daily analytics retention	Number of days of daily analytics rows to keep in the database. Older rows are pruned by a daily cron. The lifetime totals on each location (used for the all-time numbers and CSV export) are NEVER pruned. Set to 0 to disable the cron entirely. Allowed range: 0-3650 days (default: 365).
Pro Track search query text	When enabled, the actual search text typed by visitors is stored (so the “Top searches” and “Zero-result searches” panels can show real queries). Turn off for stricter privacy: searches will still be counted, but the typed text is replaced with a redacted placeholder.
Pro Respect “Do Not Track”	When enabled, no events are recorded for visitors whose browser sends the “DNT: 1” header. This signal is not legally binding (most browsers no longer send it), but is considered a privacy best-practice, e.g. by France’s CNIL.
Pro IP addresses	Information only: the analytics never store IP addresses or visitor IDs.
Geocoding (admin only)	Allow administrators to fetch coordinates with Google Geocoding when editing a location. Requires a Google API key. Disabled by default.

21. Settings: Map

Map appearance

Choose the basemap color scheme. “Custom” lets you paste your own Google Maps style JSON.

Setting	What it does
Map color scheme	Map color scheme. OSM schemes “Light” and “Dark” use Carto tiles (free, attribution required); “Grey” desaturates your configured tile URL. Google schemes apply map style overrides. Choose Custom to define your own styling below. Options: Classic | More colors | Light | Grey | Dark | Custom
Custom OpenStreetMap style	CSS filter applied to the OpenStreetMap tile layer. Examples: grayscale(100%) brightness(0.95) / hue-rotate(90deg) saturate(0.6) / sepia(40%) contrast(1.1). Leave empty to keep raw tiles. Tile URL itself is set under Map > Map tiles.
Custom Google Maps style (JSON)	Paste a Google Maps style array (JSON). Generate one with snazzymaps.com or Google Map Style Wizard, then copy the JSON output here. Must be a JSON array of style objects.

Map provider

Pick how the map is loaded on the front end site-wide. List only is the default, so no external map service is contacted until you opt in by choosing a provider. Choose OpenStreetMap (bundled Leaflet map, no account needed) or Google Maps (enter your API key) to display a map, both load tiles from that third-party service for visitors.

Setting	What it does
Map type	List only is the default, so no map tiles are loaded until you choose a provider here. Choosing OpenStreetMap or Google Maps loads map tiles from that third-party service when a visitor opens a map page (this transmits the visitor IP to that service, see the readme “External services” section and co… Options: OpenStreetMap (Leaflet, bundled | Google Maps (requires Maps JavaScript API key) | List only (no map)
Google Maps API key	This key runs in the web browser (not on the server). Use a different key than the Places/server key, IP-only keys will not work. In Google Cloud: enable billing, enable “Maps JavaScript API”, restrict this key with “HTTP referrers” (e.g.

Map tiles

Only used with the OpenStreetMap provider. When you change the tile provider make sure to set the matching attribution. Some providers require an account or API key, never hard-code keys here; use a child theme or filter the URL via the pmloc_tile_url filter.

Setting	What it does
Tile URL template	Use a {s}/{z}/{x}/{y} compatible URL. Default uses OpenStreetMap.
Tile attribution	HTML attribution required by the tile provider. Basic HTML allowed.

Map defaults

Setting	What it does
Map height mode	Pixel height: fixed value (set below). 100%: stretches the map to the height of the surrounding block / theme container, with the pixel value below as the minimum fallback. Auto: the map is sized relative to the visitor’s viewport (85% of the screen height), the pixel value below is ignored. Options: Custom pixel height | 100% | Auto
Map height (pixels)	Used as the fixed map height in “Custom pixel height” mode. In “100%” mode this value is the minimum-height fallback. In “Auto” mode this value is ignored. Range: 300 to 1000
List height (side-by-side layouts)	Controls how tall the location list column is in Split, Mixed and Tab layouts on the desktop breakpoint. “100%” stretches the list to the height of the surrounding block / theme container, with the pixel value below as the minimum fallback. Options: Match map height | Custom height (pixels) | 100% | Auto
List height (custom pixels)	Used as the fixed list height in “Custom height” mode. In “100%” mode this value is the minimum-height fallback. In “Match map height” and “Auto” mode this value is ignored. Range: 200 to 2000
Map popup width (pixels)	Maximum width of the location detail card on the map. Applies to Google InfoWindows AND the floating detail card in the Fullscreen layouts (when “Map popup style” is set to “Card”). Long content scrolls inside the card. Range: 200 to 800
Default map view	Choose how the map frames itself on first load. “Automatic” zooms/pans so every partner pin is visible. “Manual” honours the Default zoom + Default map centre values below, useful when you always want the map to open on a specific city or region, even if there are no markers there yet. Options: Automatic | Manual
Default zoom	Zoom level (1 to 18) the map opens on in “Manual” view mode. Range: 1 to 18
Default map centre	Latitude and longitude the map opens on in “Manual” view mode.

Map behaviour

Setting	What it does
Browser geolocation	Show the “My location” button so visitors can centre the map on their position, see approximate distances, and use their position as the centre for the radius filter.
Geolocation button style	Choose where the visitor’s “find me” control sits. Pick a corner that doesn’t clash with the native Google zoom controls (bottom-right by default). Requires “Browser geolocation” (above) to be on. Options: “My location” button at the top of the map | Floating cursor button | Floating cursor button | Floating cursor button | Floating cursor button
Native zoom controls	Show the map provider’s built-in +/- zoom buttons (in Google Maps). In the Fullscreen layouts (Design 1, Design 5, Focus) they appear only while the overlay’s own +/- group is switched off, the same control never renders twice.
Google map type controls	Show Google Maps’ Map / Satellite / Terrain switcher. Only applies when the map provider is Google Maps and the layout is not Fullscreen (Fullscreen always hides them to keep the search overlay clean).
Google map navigator controls	Show Google Maps’ navigator / joystick (rotate + tilt) control in the bottom-right corner. Only renders on Google Maps when the current view supports tilt/rotate (45 deg satellite or vector maps). Off by default to keep the map chrome minimal.
Distance unit	Unit used for the radius filter labels and distances shown next to locations after “My location” is used. Options: Kilometres (km) | Miles (mi)
Search radius	Distance used for the radius circle and for filtering (if enabled below). Distances in the list after “My location” use this radius as a reference. Options: 50 km | 100 km | 150 km | 200 km
Filter map by search radius	When enabled, only locations inside the radius circle are shown on the map and in the list. When disabled, all loaded locations stay visible (recommended for dealers spread across a large area). Where the circle is anchored is controlled by “Radius circle anchor” below.
Radius circle anchor	Where the radius circle is anchored when “Filter map by search radius” is on. “Map centre” draws the circle right away around the current map centre. Options: Map centre | After location
Multi-select category filters	Let visitors pick several terms in each filter dropdown at once (e.g. two categories). A location matches if it carries ANY selected term within a facet, and must match across every facet that has a selection. When off, each filter accepts a single choice with an “All” reset entry.
Lazy-load locations (performance)	Fetch the location data over the REST API after the page loads instead of embedding it inline in the HTML. This makes the page smaller and more cacheable on sites with many locations; the map markers appear a moment later.
Slim marker payload (performance)	Keep the embedded location data small: markers and filters load instantly from a lightweight payload, while the heavy popup content (full description, opening hours, action buttons) is fetched in the background right after the map renders. Recommended for sites with many locations.
Maximum locations to load	How many locations to load for the map and list (sorted alphabetically by title). Shortcode: limit=”50″. Range: 1 to 500
Pro Cluster markers (OpenStreetMap)	Group nearby pins when using OpenStreetMap (Leaflet). Uses the bundled leaflet.markercluster library. Only applies when the map provider is OpenStreetMap.
Pro Cluster markers (Google Maps)	Group nearby pins when using Google Maps. Uses the bundled lightweight grid clusterer (no extra library). Only applies when the map provider is Google Maps.

22. Settings: Designs

The design picker, the guided entry and the per-design layout options. The table under “Layout options” is grouped by design; on the screen only the selected design’s group is shown.

Choose a design

A design is a curated visual preset that ties together layout, typography and look-and-feel. Selecting a design only changes which design is “active”, your other settings are untouched. Each design can additionally apply a recommended set of values (typography, visibility, card style) as a one-click action.

Setting	What it does
Active design	The design picker: one preview card per design, the four free ones first. Locked cards are Pro. Selecting a card only changes the active design; “Apply recommended settings” on a card also sets its typography, visibility and card style.

Guided entry

An optional first step before the design: let visitors answer what they need and where they are, then land them on the design above with those filters active. Discover and Guide used to be designs of their own; as an entry step they now work in front of any design.

Setting	What it does
Pro Start with a finder	Runs the chosen finder as a first step in front of the design selected above. When the visitor finishes (or skips), the design appears with their answers already applied as filters. The finder’s own options show under Layout options below while it is selected. Options: No | Discover | Guide

Layout options

Only what belongs to the design selected above, the list changes when you change the design, and each group is headed with the design it applies to. Options that apply whichever design you pick are on the Layout tab, under “Applies to every design”.

Design 1 and Design 5 (Fullscreen)

Setting	What it does
Pro List style	Choose the list panel layout for Design 1 and Design 5. “Mini list” replaces the rich list cards with a slim two-line row, partner name on top, a “Level / star rating / review count” line below. Other designs always use the normal list. Options: Normal list | Mini list
Pro Mini list, active row highlight	How the selected location is highlighted in the mini list. Only used when “List style” is set to “Mini list”. Options: A | B | C | D
Pro Mini list, highlight accent color	Color of the bar, name, card border or pin icon in the active mini-list row. While this is left at its default value the highlight automatically follows the marker color from the Style tab; pick any other color to override it.
Pro Mini list, highlight background	Background of the active mini-list row. While this is left at its default value an automatic light tint of the accent color is used; pick any other color to override it (choose a darker tone for dark color schemes).
Zoom buttons	Show a +/- zoom button group next to “Near me” in the search overlay. The map’s native zoom controls are always hidden in the Fullscreen layouts to avoid overlapping with the search and filter overlays.
My location button	Show the “Near me” control as a compact icon-only button (instead of the text pill) between the search field and the +/- zoom buttons. Same function, it centres the map on the visitor’s position. Requires “Browser geolocation” (Map tab) to be on; without it no locate control appears in either style.
List width (pixels)	Width of the floating list panel in the Fullscreen layouts (Design 1 and Design 5). Only applies when the active design uses a Fullscreen layout. Narrower values (240-280) feel like a maps3-style sidebar; wider values (360-480) give more room for list-card content. Range: 240 to 600
Pagination reveal	How the list pagination control behaves in Design 1’s floating list rail. “Reveal at the end” flows the Previous / Next bar (or Load more / infinite-scroll sentinel) inline at the bottom of the list content, so visitors only see it after scrolling through every row. Options: Reveal at the end of the list when scrolled | Always pinned to the bottom of the rail (sticky)
Filter chip strip, visible button cap	Maximum number of filter buttons to show inline in the Fullscreen chip strip (Design 1 / Design 5). When the strip contains more buttons than this cap, the extras collapse into a “+ N more” dropdown opened with a single click. Set to 0 to always show every button inline. Range: 0 to 40

Design 2, Design 3 and the split designs

Setting	What it does
Chip / icon group separator	Visually group the quick-filter buttons by taxonomy. Single control for all chip / icon strips: Design 2 chip strip, Design 3 icon strip and the Fullscreen chip filters used by Design 1 and Design 5. “No separator” keeps the row compact. Options: No separator | Vertical line | Extra spacing
Chip / icon strip scroll indicator	Controls how horizontal overflow is presented on the chip / icon strips when there are more buttons than fit in one row (Design 2 chip strip, Design 3 icon strip, Design 1 / 5 fullscreen chips). Options: Hidden scrollbar with edge fade | Optimized slim scrollbar
Toolbar max width	Cap the styled toolbar at a comfortable reading width and centre it. Useful when the map is rendered full-width, keeps the search row from stretching across the whole viewport. Applies to Design 2, Design 3 and Design 4. Options: Full width | 1340 px | Custom (pixels)
Toolbar max width, custom (px)	Custom max-width in pixels (between 600 and 2400). Only used when “Toolbar max width” above is set to “Custom”. Range: 600 to 2400
List column width	Sets the width of the list column on desktop for the split / mixed designs (Classic, Mixed view, Design 2 / 3 / 6). The map column takes the remaining space. Mobile is unaffected, the layout collapses to a single column on phones. Options: Normal | 30 % | 40 % | 50 %
List background	Background color shown behind the list cards in Design 2, Design 3 and Design 4 (the editorial / photo-grid split-view designs). Default is a soft cool grey (#f8fafc, slate-50) that visually separates the list rail from the cards.

Design 5 only

Setting	What it does
Pro Searchbar position	Where to anchor the pill-shaped searchbar in the Speed-Finder layout. “Available stage area” excludes the floating list rail, so the bar always stays clear of it. The filter chip strip follows the same anchor below the searchbar. Options: Centred above the map | Top-left of the available stage area | Top-right of the available stage area
Pro Chip strip cap	Cap the number of filter chips that render inline in the Speed-Finder pill bar. Extras collapse behind a “+” button next to the visible chips. “Show every button inline” disables the cap entirely. Counts every taxonomy chip (category, product type, partner level, highlight) together. Options: Show every filter button inline | 3 buttons inline, rest behind a “+” button | 4 buttons inline, rest behind a “+” button | 5 buttons inline, rest behind a “+” button
Pro “+” button behaviour	What the “+” button next to the chip strip does. “Dropdown” opens a floating panel that lists the hidden filters (single click on any entry applies it). “Reveal” expands the strip in place so all chips become visible (the “+” button then hides itself). Options: Open a dropdown with the extras | Reveal the extras inline next to the visible chips
Pro “+” button label	How the overflow trigger reads. “Editorial ellipsis” keeps the Speed-Finder pill bar clean with a single “…” glyph (the overflow count stays accessible via the button title / aria-label). “+ N” prints the number of hidden filters next to the plus sign. Options: Editorial ellipsis “…” | Explicit “+ N” with the overflow count
Pro List sort bar	Show a small sort toolbar at the top of the Design 5 list rail. Lets visitors re-order the visible partners without leaving the panel. Individual buttons (Distance / Rating / custom) are toggled separately below.
Pro Sort bar: show Distance button	Render the “Distance” button in the Design 5 sort bar. Clicking sorts visible partners ascending by distance from the current map centre (or the visitor’s “locate me” position once granted).
Pro Sort bar: show Rating button	Render the “Rating” button in the Design 5 sort bar. Clicking sorts visible partners descending by their Google rating (untreated rows drop to the bottom). Requires the Google Places ratings integration to be populated for the relevant locations.
Pro Sort bar custom button label	Visible label of the third sort button (e.g. “Prime zuerst”, “Showroom zuerst”). Leave empty to hide the third button, Distance + Rating stay regardless.
Pro Sort bar custom facet	Taxonomy that the third sort button keys off. Combined with the slug below, partners carrying that slug bubble to the top of the list, the rest follow in distance order. Options: Highlights | Partner levels | Categories | Product types
Pro Sort bar custom slug	Slug of the term (within the facet above) that pins partners to the top when the third sort button is active. Example: “prime-platin”, “showroom”, “premium”.
Pro Map marker style	Pick whether Design 5 uses its numbered ring marker on the map or the global marker style. When “Numbered map markers” is on and you pick Standard, the site marker shows the list row number inside a circular badge. Options: Design 5 numbered ring marker | Standard site marker (Style > Marker style)
Pro Marker background	Fill of the Design 5 numbered ring marker. Default: white #ffffff (matches Design 5 paper).
Pro Marker number color	Number color inside the Design 5 ring marker. Default: accent orange #dc6b1c (matches Design 5 accent).
Pro Marker border color	Ring outline and pin stem of the Design 5 marker. Default: accent orange #dc6b1c (matches Design 5 accent).
Pro Marker platin background	Ring and stem fill for Prime/Platin partners on the Design 5 marker. Default: ink #1d2327 (matches Design 5 dark ink).

Design 6

Setting	What it does
Pro Map marker style	Pick whether Design 6 uses its editorial square serif tile on the map or the global marker style. When “Numbered map markers” is on and you pick Standard, the site marker shows the list row number inside a circular badge. Options: Design 6 square numbered marker | Standard site marker (Style > Marker style)
Pro Marker background	Background of the Design 6 square map marker. Default: navy #2d3e5c (matches Design 6 accent).
Pro Marker number color	Number color inside the Design 6 square marker. Default: cream paper #faf8f4.
Pro Marker border color	Border around the Design 6 square marker. Default: cream paper #faf8f4.
Pro Marker platin background	Background for Prime/Platin partners on the Design 6 square marker. Default: near-black #1a1a1a (matches Design 6 ink).
Pro Filter style	Pick the filter UI under the search strip. “Toolbar” keeps the classic input + select dropdowns. “Checkboxes” replaces them with an editorial row for ONE taxonomy (set below). Options: Toolbar | Checkboxes | Compact bar
Pro Checkbox facet	Taxonomy that fills the checkbox row when “Checkboxes” filter style is on. Each existing term renders as one checkbox toggle; the underlying filter dropdown still wires up so the filter pipeline runs the same as it does with the toolbar. Options: Highlights | Partner levels | Categories | Product types
Pro Compact bar: taxonomy separator	In “Compact bar” mode every enabled taxonomy contributes its terms to a single inline chip row right of the search strip. This setting picks whether the taxonomy groups (Categories, Product types, Partner levels, Highlights) read as one continuous list or get visually separated by a thin vertical li… Options: No separator | Vertical line between taxonomy groups
Pro Filter background color	Background color of the Design 6 filter / search strip (the toolbar above the list and map). While this is left at its default value it keeps the design’s cream paper tone; pick any other color to override it.
Pro List background color	Background color of the Design 6 list view (the column of location cards). While this is left at its default value it keeps the design’s cream paper tone; pick any other color to override it.
Pro Hover / active color	Highlight tone used when hovering a list card, for the active (selected) list card, and as the background of the search / filter inputs while they are focused. While this is left at its default value it keeps the design’s soft cream-paper highlight; pick any other color to override it.

Design 4

Setting	What it does
Search bar taxonomy	Pick which taxonomy is exposed as the third segment of the pill-style search bar in Design 4. The remaining taxonomies stay in the icon-strip filter row below the search bar so visitors can quickly facet without opening the More-filters drawer. Options: None | Categories | Product types | Partner levels | Highlights
Show “More filters” button	Show a small “More filters” button next to the icon-strip filter bar that opens the full filter drawer (categories / product types / partner levels / highlights / radius). The badge on the button counts active facets.
Quick-toggle switch	Show an pill-style on/off toggle pill next to the icon-strip filter bar (e.g. “Showroom only”). Filters the result list to a single taxonomy term picked below.
Toggle label	Visible label for the toggle pill. Defaults to “Showroom only” when left empty.
Toggle filter term	Pick the taxonomy term the toggle filters by. The list groups terms by taxonomy (Categories / Product types / Partner levels / Highlights). When the toggle is on, only locations tagged with this term are shown.
Icon-strip alignment	Horizontal alignment of the icon-filter strip on desktop. Mobile keeps the horizontal-scroll behaviour from Design 3, the strip swipes through the full set of icons regardless of this setting. Options: Left | Centered | Right
Divider above icon strip	Controls the thin divider line that sits above the icon-filter strip in Design 4. The “Full width” variant breaks out of the toolbar max-width, useful when the map is rendered edge-to-edge but you still want a visual separator that spans the whole viewport between the search row and the filter icons… Options: Aligned with toolbar | Hidden | Full width
List column width	Sets the width of the list column on desktop. The map column takes the remaining space. Mobile is unaffected, Design 4 collapses to a single column with the floating Show-map / Show-list toggle on phones. Options: Normal | 30 % | 40 % | 50 %
Design 4 / 5, badge colors	Picks the color treatment for the chip row beneath each list card. Applies to Design 4 (card tags) and Design 5 (hero card + list row tags). Options: Colored | Single | Grey
City subtitle	Controls what is shown on the subtitle line under each Design 4 list-card title. Choose whether the partner level is appended after the city or hidden. Options: City / partner level | City only
List heading	Heading shown at the top of the Design 4 list (above the cards). Use %d where the partner count should appear, e.g. “%d partners” renders as “27 partners”. Leave empty to hide this heading entirely.
List sub-heading	Smaller sub-heading shown beneath the Design 4 list heading. Free text. Leave empty to hide it.

Stack view

Setting	What it does
Stack list layout	Only applies when the layout style is Stack (which list-only mode also uses since it has no map column). Options: Boxed | Masonry
Stack list, items per row	How many list cards sit side by side in the row below the map in the Stack layout. “Auto” keeps the responsive grid that fits as many cards as the width allows. A fixed count (1-5) sets the card width accordingly; on narrow screens the count automatically steps down so cards never get too cramped. Options: Auto | 1 per row | 2 per row | 3 per row | 4 per row | 5 per row

Discover (guided entry)

Setting	What it does
Pro Shortcut filters	Which taxonomies Discover shows as shortcut buttons under its search field, with counts from the loaded locations.
Pro No-map-yet note	Show a line stating that no map has been loaded yet
Pro Note text	Shown until the visitor searches, then it disappears. Leave empty for the default wording. Basic links and emphasis are allowed.

Design 7

Setting	What it does
Pro Filters under the search	Which filters Focus offers as chips under its search field. A taxonomy switched off site-wide under “List & map visibility” stays off here, this narrows that choice for Focus, it does not override it. Tick none for a search-only panel.
Pro “Near me” button	Show the “Near me” control beside the search field. Requires “Browser geolocation” (Map tab): without it the visitor has no position to search from, so the button is left out whatever this is set to.
Pro +/- beside the search	Show the +/- zoom group in the search row. While it is on, the map provider’s own zoom buttons stay hidden so the same control does not appear twice. Switch it off and “Native zoom controls” (Map tab) decides whether the provider’s buttons appear on the map instead.
Pro Selecting a partner	What a click on a row or a pin does. “Normal popup” behaves like the other designs and honours the Map popup style above, on the pin, normal overlay or mini overlay; the list stays and the selected row is marked. Options: Normal popup | Show the details in the panel
Pro Panel on phones	How Design 7 behaves on screens up to 782px. “Sheet” is the maps-app pattern from the design: the map takes roughly the height of the screen and the list rides over it as a sheet you drag between three heights (the detail state takes the full height). Options: Sheet over the map | Panel below the map | Full list below the map
Pro List height on phones	Percent of the screen height, 25-95: the panel’s maximum height before the list scrolls inside it. Only for “Panel below the map”, the sheet keeps its drawn stops (a taller sheet could only cover more map), and “Full list” never limits the list. Range: 25 to 95

Pocket

Setting	What it does
Pro Heading	The one question the widget answers. “Where to buy this” suits a product page; “Find a partner near you” suits a sidebar. Leave empty for the default.
Pro Pin click	What clicking a marker shows. “Highlight” marks the matching row and scrolls it into view, in a map band this small, a popup mostly covers the map. “Standard” opens whatever the Map popup style above is set to (with Pro that includes the mini overlay, which fits this format best). Options: Highlight the row only | Standard
Pro Results shown	How many partners the widget lists before the link into the full locator. Three fits a sidebar without scrolling; more turns the widget into a page of its own, which is what the link is for. Range: 1 to 6
Pro Map height	Height of the small map band in pixels. Use 0 to leave the map out entirely and show only the nearest partners. Anything above 0 is held to at least 120px, because below that Google’s logo and attribution no longer fit, and they may not be covered. Range: 0 to 400
Pro “all partners” link	Where the footer link sends visitors, your full locator page. Leave empty and the link is left out, which is the right choice when the widget is the only locator you have.

Table

Setting	What it does
Pro Filter bar	Which filters the Table design shows in its filter bar, with in-field labels.
Pro Map band height	Height of the map band above the table in pixels (desktop). The table does not follow the global “Map height” on the Map tab, a band above a table wants a value of its own. Held to at least 120px so Google’s logo and attribution still fit. Range: 120 to 800
Pro Map band height on phones	The same band on screens up to 782px wide, in pixels. Keep it well under the screen height so the first record cards stay in view. Range: 120 to 600
Pro Columns	Which columns the sortable table renders and in which order: name, city, region, services, level, rating, distance and the action buttons.

Guide (guided entry)

Setting	What it does
Pro First question	Which filter the first question asks about. Its terms become the answer cards, so pick the one a visitor can answer without knowing your catalogue, usually the service or product they need rather than an internal partner level. Options: Categories | Product types | Partner levels | Highlights
Pro Distance choices	Up to four distances in kilometres, comma separated, for the third question. They are sorted low to high automatically. Keep them apart, 10/25/50/100 gives a real choice, 10/15/20/25 does not.
Pro Skip link	Offer “Skip and show all” beside the progress bar. Leave this on: a visitor who already knows what they want must never be trapped in the sequence.
Pro Background color	The stage behind the questions. Leave empty for the shipped warm paper tone (#faf9f7).
Pro Answer card color	Background of the tappable answer cards on that stage. Leave empty for white.

Every design

Setting	What it does
Entries per page	How many entries the list shows before it pages. 0 turns pagination off and shows every match at once. This is the same setting as “Locations per page (list)” on the Layout tab, changing it in either place changes it everywhere. Range: 0 to 100

23. Settings: Style

Color palette

Site-wide palette used by every map instance. Background and text colors apply to popup and list cards; the accent color drives primary buttons and the focus ring; marker color controls pins and the radius overlay.

Setting	What it does
Background color	Background of the map locator block, applied to the wrap (the spacing around the map / list), the toolbar surface and the list pane.
Text color	Default text and icon tone inside the locator.
Accent color	Primary actions, links, and focus rings (e.g. directions button, active states).
Marker color	Map pin fill color and radius highlight (Google). Acts as the fallback when “Marker color source” is set to “From partner level” and a location has no partner-level color.
Marker color, active pin	Fill color of the pin belonging to the currently selected location, a click on a list row or on the pin itself recolors it and lifts it above its neighbours. Leave empty to keep the selected pin in its normal color. Custom marker images cannot be recolored; they are only lifted.
Legend background color	Background color of the floating map legend overlay. While this is left at its default value (white, #ffffff) the legend follows the global background color above; pick any other color to give it its own fixed surface.
Primary button, background color	Background color of every primary action button (e.g. “Get directions”). While this is left at its default value (#2563eb, blue-600) the buttons follow the live Accent color above.
Primary button, text color	Text color of primary action buttons. The default (white, #ffffff) contrasts cleanly with the primary background; pick any other color to override it.
Secondary button, background color	Background color of every secondary action button (e.g. “Website”, “Email”, “Call”). While this is left at its default value (soft slate-100, #f1f5f9) it follows a soft mix of the global background and text colors; pick any other color to give the buttons a fixed surface.
Secondary button, text color	Text color of secondary action buttons. While this is left at its default value (#0f172a, slate-900) it follows the live global Text color; pick any other color to override it.

Typography & corners

Font family for the plugin, heading and body sizes for the list preview and the detail popup, plus the global corner-radius used on buttons, badges and cards.

Setting	What it does
Font	Default uses your theme’s font. System options (Georgia, Verdana, Tahoma…) need no extra files. The Google-font options (Inter, Poppins, Playfair…) are loaded according to the “Web font loading” setting below. Options: Default (inherit from theme) | System UI | Georgia (serif) | Verdana (sans-serif) | Tahoma (sans-serif) | Plus Jakarta Sans (Google) | Inter (Google) | Poppins (Google) | Montserrat (Google) | Nunito (Google) | Raleway (Google) | Open Sans (Google) | Lato (Google) | Playfair Display (Google, serif)
Web font loading	Only applies when the Font above is one of the Google fonts. System-font and theme-default choices never load anything externally. Options: Self-host (recommended) | System fonts only | Load from Google (fonts.googleapis.com)
Font, titles / headings	Font for location titles and design headlines (e.g. Design 6’s serif titles, the “X locations / X partners” headings). “Same as global font” leaves each design’s own heading font in place. Options: Same as global font | System UI | Georgia (serif) | Verdana (sans-serif) | Tahoma (sans-serif) | Plus Jakarta Sans (Google) | Inter (Google) | Poppins (Google) | Montserrat (Google) | Nunito (Google) | Raleway (Google) | Open Sans (Google) | Lato (Google) | Playfair Display (Google, serif)
Title / heading weight	Optional fixed weight for titles / headings. “Default” keeps each element’s built-in weight. Options: Default (per element) | Light (300) | Regular (400) | Medium (500) | Semibold (600) | Bold (700) | Extrabold (800)
Font, body text	Font for normal running text, addresses, descriptions, meta lines, buttons. “Same as global font” uses the global Font selected above. Options: Same as global font | System UI | Georgia (serif) | Verdana (sans-serif) | Tahoma (sans-serif) | Plus Jakarta Sans (Google) | Inter (Google) | Poppins (Google) | Montserrat (Google) | Nunito (Google) | Raleway (Google) | Open Sans (Google) | Lato (Google) | Playfair Display (Google, serif)
Body text weight	Optional base weight for body text. “Default” keeps the inherited weight. Options: Default (per element) | Light (300) | Regular (400) | Medium (500) | Semibold (600) | Bold (700) | Extrabold (800)
Font, badges & accents	Font for badges, tag chips, numbered rank badges and the distance / count read-outs. “Same as global font” keeps each design’s own accent font (Design 4’s monospace, Design 6’s serif). Options: Same as global font | System UI | Georgia (serif) | Verdana (sans-serif) | Tahoma (sans-serif) | Plus Jakarta Sans (Google) | Inter (Google) | Poppins (Google) | Montserrat (Google) | Nunito (Google) | Raleway (Google) | Open Sans (Google) | Lato (Google) | Playfair Display (Google, serif)
Badge / accent weight	Optional fixed weight for badges & accent read-outs. “Default” keeps each element’s built-in weight. Options: Default (per element) | Light (300) | Regular (400) | Medium (500) | Semibold (600) | Bold (700) | Extrabold (800)
Heading size	Font size in pixels for the toolbar location count line. Range: 12 to 72
Preview card heading size	Font size in pixels for each location title in the list. Range: 10 to 36
Preview card text size	Font size in pixels for list card body text (address, content, contact). Range: 10 to 22
Detailed card heading size	Font size in pixels for the map popup title. Range: 12 to 48
Detailed card text size	Font size in pixels for map popup body text (address, meta, description). Range: 10 to 22
Elements corner radius	Border radius in pixels for cards, inputs, map frame, and buttons. Range: 0 to 32
Map corner radius	Dedicated border radius (px) for the map canvas. Set to 0 for square corners. The tile layer is automatically clipped to this radius so the rounding is visible, regardless of the “Elements corner radius” value above. Range: 0 to 48

Markers

Pin shape, coloring strategy and optional custom marker image. The marker color itself is set under “Color palette”.

Setting	What it does
Marker color source	When set to one of the taxonomy options, each pin uses the badge color of the location’s first matching term, and cluster bubbles get a mixed outline ring whose slices reflect the term mix of their bundled locations. Locations without a colored term fall back to the fixed marker color above. Options: Fixed color | From partner level (use term color) | From category (use term color) | From product type (use term color) | From highlight (use term color)
Marker style	Visual style of each map pin. Built-in shapes are tinted with the marker color (or the partner-level color, when that source is active). Cluster bubbles always keep the round badge style for readability. Options: Dot | Pin | Pin | Pin | Pin | Custom image (upload PNG)
Custom marker image	PNG (transparent background recommended). Used as the marker icon when “Marker style” is set to “Custom image”. The image is rendered at 32×32 pixels by default; upload at 2x (64×64) for Retina support.

List & popup cards

Visual rhythm of the list preview and the map popup: logo shape, contact-line icons, and dividers between content blocks.

Setting	What it does
Gap between list and map	Show a small horizontal gap between the list column and the map column. Off renders the two columns flush against each other for an editorial / continuous look.
Outer safe-space margin	Adds a 1.25 rem outer safe-space margin on every layout so the map never crashes into a full-bleed theme container, and toggles the 16 px breathing room between the Fullscreen list panel and the map edge.
Drop shadows	Draw the soft drop shadows under frames, list cards, floating cards, map popups, toolbars and map buttons, on every design. Off renders all of them flat, for themes with a flat look or a strong background of their own. Keyboard focus rings and the map pins keep their shadow either way.
List card logo shape	Shape of the partner logo shown next to the title in list cards. “Match Elements corner radius” makes the logo follow the same corner radius the rest of the plugin uses (e.g. 0 = perfectly square, 16 = strongly rounded). Options: Square (slightly rounded corners | Round (circle) | Match Elements corner radius (uses the global radius setting)
Contact row icons (list)	Show a small icon next to the address, phone, email, and website lines in location list cards.
Distance display	How the “X km away” / “X mi away” label is rendered on list cards after the visitor activates “My location” or the radius filter. The four “Floating” options place the chip as an absolutely-positioned corner stamp on the card, pick the opposite corner from the Featured badge to avoid overlap. Options: Classic | Meta line with navigation icon | Inline chip | Floating top-left corner | Floating top-right corner | Floating bottom-left corner | Floating bottom-right corner
Block separators (list cards)	Show thin horizontal separator lines between visible content blocks (rating, contact, meta, hours, description) in location list cards. Applies to every layout, including the Fullscreen list panel.
Block separators (map popup)	Show thin horizontal separator lines between content blocks inside the map popup / detail card.
Block separator spacing	Vertical spacing above and below each separator line. Applies to list cards and map popups equally. Only relevant when at least one separator option above is enabled. Options: Small | Medium | Large | Custom (pixels)
Block separator spacing (custom pixels)	Only applied when “Block separator spacing” is set to “Custom”. Range: 0 to 48

Taxonomy badge style

Switch each taxonomy between the classic text-only badge and an icon + label variant. The icon variant uses the per-term SVG icon you set on the term edit screen, terms without an icon stay text-only as a graceful fallback.

Setting	What it does
Categories	Badge style for category terms. The “Icon” option uses the SVG icon you set on each term (Locations > Categories > edit term). Options: Text only (classic pill) | Pill with inline icon (icon prefixes the label inside the pill) | Icon + label (separate icon chip, transparent badge)
Product types	Badge style for product-type terms. Options: Text only (classic pill) | Pill with inline icon (icon prefixes the label inside the pill) | Icon + label (separate icon chip, transparent badge)
Partner levels	Badge style for partner-level terms. Options: Text only (classic pill) | Pill with inline icon (icon prefixes the label inside the pill) | Icon + label (separate icon chip, transparent badge)
Highlights	Badge style for highlight terms. Leave on “Text only” to keep highlights compact next to the location name in the header. Options: Text only (classic pill) | Pill with inline icon (icon prefixes the label inside the pill) | Icon + label (separate icon chip, transparent badge)

Map legend

A floating legend overlay rendered on top of the map. Each entry is a color swatch + a term label, pulled from the chosen taxonomy. Only terms that have a color set on their term-edit screen show up, terms without a color are skipped automatically (they’d have nothing to legend).

Setting	What it does
Show map legend	Render a small floating legend overlay on the map (color swatches + term labels). Only terms that have a color set in their taxonomy edit screen are included; terms without a color are skipped automatically.
Legend source	Which taxonomy the legend swatches come from. “Auto” mirrors whatever you picked under Markers > Marker color source, so the legend always matches the colors actually rendered on the map. The other options let you legend a different taxonomy than the marker colors (rarely needed). Options: Auto | Partner levels | Categories | Product types | Highlights
Legend position	Where the legend overlay sits on top of the map. The two bottom positions are usually the safest; the top corners can collide with native map UI. Options: Bottom-left (default | Bottom-right (next to scale / attribution if shown) | Top-left (may overlap with the zoom controls) | Top-right (may overlap with the map-type / fullscreen controls)
Legend title (optional)	Optional caption shown above the legend items. Leave empty for a compact, caption-less legend.

Featured badge

The “Top partner” style badge that appears on featured locations in the list and on the map popup. Toggle it off to hide the badge globally.

Setting	What it does
Featured badge	Display a pill-shaped “Top partner” badge for locations marked as Featured in their editor. Where it shows, list cards, map popups or both, is the “Featured badge” row under Layout > List & map visibility.
Featured badge, label	Text shown inside the badge (e.g. “Top partner”, “Empfehlung”, “Premium”).
Featured badge, icon	Single character or unicode glyph shown before the label (e.g. star, heart, check, star). Leave empty to hide the icon.
Featured badge, position	Where the badge sits on the location card / map popup. “Inline chip” is a small fixed-size pill; “After title” is rendered inside the heading and scales with the title font-size (about 70%) so it visually balances regardless of layout. Options: Inline chip | After title | Floating top-left corner | Floating top-right corner
Featured badge, show icon only	Hide the label text and show only the icon glyph (e.g. star, check). The label is still announced to screen readers via aria-label, so accessibility is preserved. Useful for a clean, Instagram-style verified-checkmark look, particularly nice combined with the “After title” position.
Featured badge, background color	Background of the featured badge.
Featured badge, text color	Text colour of the featured badge.
Featured badge, corner radius	Corner radius (px) of the Featured badge, independent of the global “Elements corner radius”. The default 999 keeps the current full-pill shape; lower values give rounded-rectangle corners (e.g. 6), and 0 makes square corners. Range: 0 to 999

Numbered badge (Fullscreen layout)

Colors for the numbered badges shown alongside each location in the Fullscreen layout. The “active” color highlights the currently selected entry.

Setting	What it does
Numbered badge, background color	Background color of the round 1/2/3 badge in the fullscreen list. Default is the dark ink tone (#1a1f24).
Numbered badge, text color	Color of the digit inside the badge. Default is white (#ffffff).
Numbered badge, active background color	Background color of the badge on the currently highlighted row (when its marker is selected on the map). Default is the accent blue (#2271b1).

Custom action button

Per-location custom action button (label + URL entered on each location). “Use global styles” makes it inherit the standard primary / ghost button look; “Use custom colors” gives it its own palette.

Setting	What it does
Custom button, style	Pick “global” to make custom buttons match the standard primary/ghost styles. Pick “custom” to give them their own background and text color. Options: Use global button styles (green/primary, grey/secondary) | Use custom colors (set below)
Custom button, background	Background color for the per-location custom button. Only applied when “Custom colors” is selected above.
Custom button, text	Text color for the per-location custom button. Only applied when “Custom colors” is selected above.

24. Settings: Layout

Applies to every design

These four apply whichever design is active. Everything that belongs to one design only lives on the Designs tab, under the design you selected.

Setting	What it does
Numbered list rows	Show a circular number badge (1, 2, 3 …) before each row in the list, and number the rows of the Table and Pocket designs to match.
Numbered map markers	Show the list’s row numbers (1, 2, 3 …) on the map markers, so a visitor can match a row to its pin at a glance. Works with every design and both map providers; the numbers follow the list order after sorting and filtering. Colors come from the numbered-badge settings on the Style tab.
Pro Map popup style	What opens when a marker is selected. “On pin”, the classic popup attached to the marker. “Normal overlay”, the full popup as a floating card in the corner opposite the list. “Mini overlay”, a compact preview card (name, address, rating, tags). Options: Mini overlay | Normal overlay | Mini popup on pin | On-pin popup
Map popup, open on	How the map popup opens from the list, whichever design is active. “Automatic” keeps each design’s natural behaviour: a design that shows a floating preview card opens it on hover, a design with a popup on the marker opens it on click. “Hover” and “Click” set one rule for all designs. Options: Automatic | Hover | Click

List features

Setting	What it does
Show list under the map	Render an accessible list of locations alongside the map.
Show location description (editor)	Output the main editor text for each location in the frontend list and map popups (same formatting as posts: paragraphs, links, etc.). Visibility of that block is controlled separately under List & map visibility.
Show number of locations	Show how many locations are loaded in this map (toolbar).
Show filter results summary	Show a live “Showing X of Y locations” line under the toolbar that updates as the user searches or filters.
Show counts on filter chips / icons	Show the number of matching locations next to each Category, Product type, Partner level and Highlight button in the quick-filter chip / icon strips (Design 2 chips, Design 3 icons, Design 4 icon strip). Uncheck to hide every count badge so each button shows only its label.
Show counts on filter dropdowns	Show the number of matching locations next to each entry inside the Category, Product type, Partner level and Highlight filter dropdowns (Classic, Tab and Mixed view toolbars). Uncheck to render each entry as its plain label.
Locations per page (list)	Paginate the location list: number of cards per page (e.g. 10). Use 0 for no pagination, the “Show” dropdown then limits how many matching results appear on the map and in the list. Range: 0 to 100
List paging style	How visitors step through the list when “Locations per page” is greater than zero. Map markers always show all matching locations. Options: Previous / Next (pages) | Load more (append batches) | Infinite scroll (append on scroll)
Preview card style (list)	How each location is displayed in the sidebar/stack list. Recommended featured-image upload size: at least 1200 x 800 px (3:2 ratio), large enough to stay sharp on Retina / 2x phone screens. The plugin auto-emits a srcset so the browser picks the right resolution per device. Options: Image on top | No image
Map popup close button	Global setting. Show the “x” close button on the floating map popup (the Mini / Normal overlay cards used by Design 1-6 and the basic layouts).
Description length (max. characters)	Applies to BOTH the location list cards and the map popup. Plain text length after removing HTML; 0 = full text (no limit). Longer text is shortened to an excerpt with a “Read more” toggle in both places. Range: 0 to 10000

List & map visibility

Choose what appears in the list preview cards and in the map detail popup independently. The description row controls visibility in each place separately. The excerpt length is set under Features (“Description length (max. characters)”) and applies to both the list cards and the map popup, longer text gets a “Read more” toggle.

Setting	What it does
Categories, row label	Replaces the default “Categories” label before category tags in list cards and map popups. Leave empty to keep the built-in translated default. Install WPML (or Polylang) to translate this label per language; the field value will be auto-registered with WPML String Translation when available.
Product types, row label	Replaces the default “Products” label before product-type tags. Leave empty to keep the built-in translated default. Install WPML (or Polylang) to translate this label per language; the field value will be auto-registered with WPML String Translation when available.
Partner levels, row label	Replaces the default “Level” label before partner-level tags. Leave empty to keep the built-in translated default. Install WPML (or Polylang) to translate this label per language; the field value will be auto-registered with WPML String Translation when available.
Highlights, row label	Replaces the default “Highlights” label. Only used when the Highlights placement is set to “Separate row” or “Both”, header-only mode shows the badges without a row label. Install WPML (or Polylang) to translate this label per language;
Visible elements	Three tables. “Visible elements”: drag the rows into the order the list cards and the map popups use, and tick per element whether it appears in the list preview, in the map popup, or both. “Toolbar”: order and visibility of the search field and the filter dropdowns.
Categories label	Show the “Categories” label before the category tags in the list and map popup. Turn off to render only the tags.
Product types label	Show the “Products” label before the product-type tags in the list and map popup.
Partner level label	Show the “Level” label before the partner-level tags in the list and map popup.
Highlights label	Show the “Highlights” label before the highlight tags in the list and map popup. Only applied when placement is “As separate row” or “Both”.
Highlights placement	Where highlight badges (e.g. Showroom, Premium, Workshop) appear in list cards and map popups. “In header” mirrors the legacy Showroom-badge layout. Options: In header (beside logo + location name) | As separate row (like Categories) | Both

Action buttons

Configure the call-to-action buttons that appear in the map popup and in the list preview cards. The primary button uses the accent style; the remaining (visible) buttons render alongside it as secondary ghost buttons. Buttons whose data is missing for a given location (e.g. no email address) are hidden automatically.

Setting	What it does
Default primary button	Site-wide default. When the chosen button has no data for a given location (e.g. the selected location has no website), the next available button from the visibility list below is used instead. Each location can override this in its “Call-to-action button” panel. Options: Directions | Website | Call | Email | Custom button (per location) | Enquiry / contact button
Visible buttons & order	Which action buttons (directions, website, phone, e-mail, custom link, enquiry) show in list cards and in map popups, which one is the primary button, and their order.

25. Settings: Integration

Google Places (ratings sync)

Setting	What it does
Sync Google ratings from Business / Maps URL	When enabled, the plugin fetches the star rating and review count from Google using the “Google Business / Maps URL” on each location via the Places API. Values refresh when you save a location and on the schedule below for all locations.
Google rating sync interval	How often to refresh ratings for every location that has a Business / Maps URL. Daily uses more API quota. Options: Daily | Weekly | Monthly | Once a quarter
Google Places API key (optional)	Leave empty to use the Google Maps JavaScript API key above (not recommended for Places search: that key is often restricted by HTTP referrers).
Google Map ID (optional)	Optional. Paste a Map ID created in the Google Cloud Console (Google Maps Platform > Map Management). When set, the map uses modern Advanced Markers (the legacy marker API is deprecated) and any cloud-based map style attached to that Map ID.

Enquiry form (popup)

Add a “Send enquiry” button to each location popup. The built-in form e-mails the enquiry to the location’s address and the admin (with the visitor as Reply-To); or embed a Contact Form 7 / WPForms shortcode instead. The built-in form is protected by a nonce, a honeypot, a required consent checkbox and a per-visitor rate limit.

Setting	What it does
Enquiry form	Adds a “Send enquiry” button to each location popup / detail card that opens a form in a modal. Options: Off | Built-in form | Embed a form plugin
Button label	Text on the button inside the popup.
Modal title	Heading shown at the top of the enquiry modal.
Form shortcode (embed mode)	Only used in “Embed a form plugin” mode. Paste a Contact Form 7, WPForms or other form shortcode; it renders inside the modal.
Admin recipient (built-in form)	Enquiries go to the location’s own e-mail address AND this admin address (admin as Bcc). Leave empty to use the site admin e-mail.
E-mail subject (built-in form)	Use {location} for the location name.
Consent checkbox text (built-in form)	Shown next to the required consent checkbox. A link is allowed, e.g. to your privacy policy.
Success message (built-in form)	Shown after a successful submission.
Enquiry overlay color	Background color of the dimmed area behind the enquiry pop-up.
Enquiry overlay opacity (%)	How much the page behind the enquiry pop-up is dimmed (0 = transparent, 100 = solid). Range: 0 to 100

Cookie consent for the map

GDPR / data-protection helper: blocks the map (and the Google Maps script when applicable) until the visitor consents. Either show your own overlay with custom wording and styling, or let Borlabs Cookie handle it. Leave the consent mode on “Off” if you already handle consent through a different mechanism.

Setting	What it does
Consent mode	Blocks the map (and the Google Maps script when applicable) until visitor consent is given. “Off” preserves the previous behaviour, recommended only when you handle consent through another mechanism or your privacy policy explicitly covers the maps service. Options: Off | Built-in overlay | Borlabs Cookie
Apply to providers	Limit the consent gate. Google Maps sets tracking cookies, so most data protection authorities recommend a consent gate before the map loads. Options: All map services | Google Maps only | OpenStreetMap only
Banner title	Title shown above the body text in the built-in overlay.
Banner body text	Explanation text shown in the overlay. Plain text only, no HTML.
Accept button text	Label of the consent button.
Privacy policy URL (optional)	When set, a “Privacy policy” link is rendered next to the accept button.
Backdrop opacity (%)	How much the underlying map area is dimmed (0 = transparent, 100 = solid). Range: 0 to 100
Banner background color	Background of the built-in consent overlay.
Banner text color	Text colour of the consent overlay.
Banner border color	Border colour of the consent overlay.
Border width (px)	Border width of the consent overlay in pixels. Range: 0 to 8
Border radius (px)	Corner radius of the consent overlay in pixels. Range: 0 to 32
Button background color	Background of the accept button.
Button text color	Text colour of the accept button.
Borlabs content blocker ID, Google Maps	Content-blocker ID configured in Borlabs Cookie for Google Maps (default: googlemaps).
Borlabs content blocker ID, OpenStreetMap	Content-blocker ID for OpenStreetMap (default: openstreetmap). Configure a matching service in Borlabs.

26. Licence and updates

The add-on is sold and updated from desk9design.com. With an active licence, updates appear under Dashboard > Updates like any other plugin, with the same one-click update. The plugin re-checks the licence at most once a day; a just-published release can take up to a day to appear, and Check again on the Updates screen forces it.

Per-site activation	each activation counts one site URL against your plan’s site limit. Locations > Pro Licence shows “x of y activated”; Deactivate licence on this site frees the slot. You can also free a slot from your account; the daily re-check notices it.
Renewal	the subscription renews yearly. The Pro Licence page shows Updates until; a reminder e-mail arrives before the date.
When a subscription lapses	every feature keeps working on every activated site. Only updates stop until you renew; then click Activate licence once more to receive them again.
Support	Pro customers open a ticket at desk9design.com/support and get an answer within one working day.

Note: activation, deactivation, the daily re-check and WordPress’ update checks send the licence key and your site URL to desk9design.com. No visitor data is transmitted, and nothing is sent while no key is stored.

27. Staging and moving sites

Development environments never count against your site limit. Anything on localhost, a .test, .local or .dev domain, or a subdomain starting with staging. or dev. activates as a free slot: same key, full functionality.

Licences are not locked to a domain forever. Click Deactivate licence on this site on the old site, or free the slot in your account, then activate the key on the new site. Site swaps do not change your renewal date.

Locations, terms, settings and analytics live in the database and move with a normal site migration. To copy only the locations, use the CSV export and import. After a move to a new server, add the new IP address to the Places key restriction and the new domain to the Maps key referrers.

28. Privacy and external services

A fresh install contacts no external service: the map type starts as “List only”. Every service below is optional and off until you turn it on. The plugin bundles no statistics or marketing scripts, sets no cookies of its own, and Pro’s analytics stay on your server without IP addresses.

Service	When	What is sent
OpenStreetMap tiles	Map type OpenStreetMap	the visitor’s browser requests tile images from tile.openstreetmap.org: IP address and map area
CARTO basemaps	the Light, Dark or More colors scheme with OpenStreetMap	the browser loads the tiles from CARTO instead
Google Maps JavaScript API	Map type Google Maps	the browser loads the map script and tiles with your key: IP address
Google Places, Geocoding	import, ratings sync, coordinate lookup	from your server: the place ID, search text or address you entered. No visitor data
Google Fonts	only “Load from Google” under Style; fonts are self-hosted by default	the browser loads the font: IP address
Pro Akismet	lead form, only if the Akismet plugin is active	from your server: the form fields, the visitor’s IP and user agent
Pro desk9design.com	licence activation, deactivation, the daily re-check, update checks	licence key and site URL

The consent gate

Settings > Integration > Cookie consent for the map: Built-in overlay shows a placeholder with your title, text, button and privacy link instead of the map until the visitor accepts; it can apply to all providers or to Google Maps only. Borlabs Cookie hands the blocking to that plugin’s content blocker with the IDs you enter. A suggested privacy-policy text is provided under Settings > Privacy in WordPress. Discover can show a “no map has loaded yet” line as long as it is true.

Schema.org: every location page carries LocalBusiness markup (name, address, geo, phone, opening hours) as JSON-LD; the map page lists them.

29. Translations and multilingual sites

Both plugins are translation-ready and ship with German. The free plugin receives language packs from translate.wordpress.org; text domain partner-map-locator. The add-on’s strings use partner-map-locator-pro with the templates in its languages/ folder; a file under wp-content/languages/plugins/ wins over the bundled one and survives updates. Loco Translate and Poedit both work.

On multilingual sites the taxonomy names, the row labels, the featured-badge text, the lead-form texts and the consent texts are registered with WPML and Polylang string translation (a wpml-config.xml is included), so each language shows its own labels. Locations themselves are posts and are translated like any post.

30. Troubleshooting and FAQ

31. Uninstall

Before uninstalling Pro, click Deactivate licence on this site under Locations > Pro Licence so the site slot frees up. Deleting the add-on removes its own options; locations and the free plugin’s settings stay.

Deleting the free plugin removes its settings, transients, the analytics table and scheduled jobs. Locations are posts and stay unless you delete them: use Delete all locations permanently under Locations > Tools first if you want a clean database, and export a CSV before you do.

Recent changes

Version	Change
Free 1.4.12	Settings text fix for the Google map-type switcher.
Free 1.4.11	The block editor’s live preview loads the plugin’s stylesheets and the self-hosted web font, so it looks like the published page; add-ons can join in.
Free 1.4.9	Layout tab: “Badges and fixed elements” table with per-surface switches for the featured badge.
Free 1.4.0	Pocket, Table and the guided entry moved to the Pro add-on; the free plugin keeps the four built-in designs.
Pro 1.3.5	Internal: a build constant for alternative distribution channels. No change for this edition; licence page, licence check and update feed work as in 1.3.4.
Pro 1.3.4	Pro designs preview in their real look in the block editor (needs free core 1.4.11).
Pro 1.3.3	External CAPTCHA option removed; honeypot, time trap, consent, rate limit and Akismet remain.
Pro 1.3.0	Pocket, Table and the guided entry ship with the add-on (requires free core 1.4.0).
Pro 1.1.8	Licensing and updates run against desk9design.com; activation counts per site URL; a lapsed subscription only stops updates.