With the Single Map skin, you can display a simple and clean map featuring directory and listing markers on your website. This skin does not show a list of listings by default (only map markers). It’s ideal for showcasing all listings on one map.
The Single Map skin presents listings as markers on a full-page map. There is no built-in list of results visible (unless using an optional sidebar). Users can click markers to view listing details. This skin is useful for directories where the map itself is the primary focus.
The Single Map skin does not have multiple style variations to choose from. It uses a default map layout. All styling is focused on map controls and markers (configured in Map settings). There is no separate “Style” selection dropdown for this skin.
Map Provider: Select the map provider (e.g., Google Maps or Leaflet) for displaying the map. Defaults to Listdom’s global default provider. This setting determines which map service is used.
Map Style:(Google Maps only) If using Google Maps, choose a predefined map style or theme. You can select a custom map design to match your site’s look. Leave blank for the default style.
Map Height: Set the height of the map. Enter a value with units (for example, 500px or 100vh). If left blank, a default height (typically 500px) is used. Adjust this if you need a taller or shorter map on your page.
Limit: The maximum number of listings to display as markers on the map. Default is 300. To avoid performance issues, keep this number at or below 300. If you have more listings, use filters to narrow them down for this map.
Clustering: Enable or disable marker clustering. When enabled (default On), nearby listings will group into cluster “bubbles” on the map to keep it organized. Turning this Off will display every marker separately.
Bubbles:(Visible only if Clustering is On, Google Maps provider) Choose the style of cluster icons (“bubbles”) to use. Listdom provides several bubble icon sets (sizes and colors) to represent clusters. Pick one from the dropdown (default is the first set).
Marker/Shape On Click: Choose what happens when a user clicks a listing’s map marker or any drawn shape on the map. Options include Open Infowindow (default), Redirect to Single Listing Page, Open Single Listing in a Lightbox, or None.
Open Infowindow: Opens a small info popup on the map with brief listing details.
Redirect to Single Listing Page: Navigates directly to the listing’s own page.
Open Single Listing in a Lightbox: Displays the listing’s detail page in an overlay/lightbox on the current screen (no page reload).
None: No action; clicking the marker will do nothing.
This setting lets you control how users get more information from the map. For example, infowindows keep users on the map, whereas redirect will take them to the listing page.
These options control how listing marker clustering works on the map.
Enable Clustering: Toggle On (default) to group nearby markers into cluster icons when zoomed out. Toggle Off to show all markers individually, even if they overlap.
Bubbles: If clustering is enabled and using Google Maps, select the cluster icon style (bubble images). Different “bubble” styles vary in color and size to represent clusters of listings. Choose one that fits your site’s design.
(The clustering settings above are the same as those under Map Structure for convenience.)
Map Search: Toggle to enable an interactive map search. When Map Search is On (requires Pro), the listing results can update automatically based on the map’s current viewport. This allows users to filter listings by moving or zooming the map – for example, only showing listings within the area they’re looking at. If Map Search is enabled, you can also connect search forms (see below). By default, Map Search is disabled in Lite (and this toggle will be unavailable without Pro).
Connected Shortcodes:(Visible only if Map Search is On and you have Listdom Pro) Select up to 3 other Listdom shortcodes (listing skins that are “searchable” like List, Grid, Masonry, etc.) to synchronize with this map. Using the auto-suggest field, choose the shortcodes whose results should link with this map’s filtering. For example, you might connect a Half Map or List + Grid shortcode here. When Map Search is active, those connected listing views will update in tandem with this Single Map’s position and filters. This is an advanced feature to create combined map/list views across shortcodes.
Auto Location (GPS):Automatic geolocation controls. This feature allows adding a “Find my location” control on the map to zoom to the user’s location. It is a Pro feature included with Advanced Map. If the Advanced Map add-on is active, a GPS button can appear on the map allowing users to center the map on their current location.
Drawing Tools:Draw search shapes on the map. This is another advanced feature (available via Advanced Map) that lets users draw shapes (like polygons) on the map to filter listings within that area. The Single Map skin will support drawn shape filtering if the add-on is installed and activated.
(The Auto Location and drawing tools controls can be managed under the Map Controls sub-tab in the Map settings when the relevant add-on is installed.)
(Requires Advanced Map add-on) The Single Map skin can optionally include a sidebar that lists listings alongside the map:
Sidebar (Listings List): Enable this switch to display a listing list panel (sidebar) next to the map. By default, the sidebar is hidden (Off). This option appears only if the Advanced Map add-on is installed. When enabled, a scrollable sidebar on the side of the map will show the listings in list format in addition to the markers.
Default State: Choose the initial state of the sidebar when the page loads. Options:
Open (With Toggle): Sidebar starts open, and the user can hide/show it using a toggle button.
Open (No Toggle): Sidebar is always open and cannot be collapsed by the user.
Closed (With Toggle): Sidebar starts collapsed (hidden) but a toggle is available for the user to open it.
Default is Open (With Toggle).
Mobile & Tablet Limit: Set how many listing cards are shown in the sidebar on small screens (mobile/tablet) before a Load More is required. Default is 12. This controls the sidebar’s initial list length for better performance on smaller devices.
Include Sidebar Search: If the sidebar is enabled, this controls whether a search form is shown at the top of the sidebar. By default On, it places a small search bar within the sidebar so users can filter results without leaving the page.
The Single Map skin is a map-only view, so it does not have traditional layout settings like columns or list style. There is no “Listings Per Row” or grid layout to configure (since no grid/list is shown).
However, you can control how many listings load (via Limit in Map settings) and how single listing pages open when clicked (via Marker On Click setting under Map). There is no pagination or “Load More” for Single Map because all markers (up to the limit) are displayed on one map.
Listing Link: (Not applicable in the usual sense for Single Map) – Instead of a list item link, the marker click behavior (infowindow, redirect, etc.) is configured in Map settings as described above. The standard Listing Link setting found in other skins is not used here.
The Sort bar is typically not used with the Single Map skin. Since listings aren’t listed in a visible list format, there is no user-facing sort dropdown in this view. Markers on the map do not have an inherent order that a user would sort by.
Default Sort: You can still set a default sorting method for the query (e.g. by date or title) in case it matters which listings are included first if you have a limit. By default, the Single Map will use List Date (newest first) as the order of retrieving listings. This can be changed in the Sort tab if needed (though it won’t visually affect the map markers).
Sort Options: This setting is not applicable for Single Map in the front-end, because no sort dropdown is shown to users. You can ignore the Sort Options for this skin – they will not be displayed on the map page.
The Single Map skin allows you to attach a search form (built via a Listdom Search shortcode) to help users filter listings further:
Search Shortcode: Select a saved Listdom search form to display with this map. You can create advanced search forms (via Listdom Search post type) and choose one here. When selected, the search form will render on the page.
Search Position: Choose where to display the search form relative to the map. Options are Top (above the map) or Bottom (below the map). For example, selecting Top will show the search form above the map, allowing users to filter the listings shown on the map.
AJAX Search: If enabled (Yes), the search form will filter the map results without reloading the page. Users can enter search criteria and the map’s markers will update dynamically via AJAX. This provides a smoother experience. If disabled, the page will reload to apply the search filters. (Requires a compatible search form and is generally recommended for better user experience.)
Use Filter Options to pre-filter which listings appear on your Single Map. This is useful to limit the map to a specific subset of listings (for example, only a certain category or location).
You can set any of the following filters:
Categories: Choose one or more categories to include. Only listings in these categories will be displayed. If multiple categories are selected, listings in any of those categories will show. You may also specify categories to exclude (skip) if needed.
Locations: Select one or more locations (regions) to include. Only listings assigned to those locations will be shown. Likewise, you can exclude certain locations.
Features: Filter by listing features (amenities). Include or exclude specific features tags.
Labels: Filter by labels (such as “Featured” or custom labels). You can include/exclude listings with certain labels.
Tags: Provide listing tags to include or exclude. You can enter tag names or select tag IDs. For inclusion, if multiple tags are provided, listings having any of those tags will be included.
Custom Attributes: If you have custom attributes (extra fields defined in Listdom Attributes), you can set conditions for those. For each custom attribute, pick the value or values that listings must have. (E.g., show only listings where the “Color” attribute is “Blue”.) These attribute filters appear if applicable.
ACF Fields: If the ACF Add-on is active and you have Advanced Custom Fields for listings, you can filter by those ACF field values. For each ACF field, enter the value to match. Requires ACF Add-on.
Author (Owner): Include or exclude listings by specific authors (listing owners). You can select user accounts to show only their listings, or conversely exclude certain users’ listings.
Specific Listings: Use Include or Exclude by listing ID to explicitly show or hide particular listings. For example, you can enter a list of specific listing IDs to force only those listings to appear, regardless of other filters.
Radius Filtering:(Advanced) If using the Advanced Map Add-on or similar, you might have an option to set a radius filter (a center point and radius distance). This would restrict listings to those within a certain distance of a given location. This is not commonly set in the shortcode settings directly (it’s more often used in front-end search), but the framework allows it if needed.
By configuring filter options, you ensure the Single Map only shows relevant listings. For example, you might create a “Restaurants Map” page where the shortcode’s Filter Options include only the Restaurants category and a specific city in Locations.
City Offices Map: Use the Single Map skin to display all your company’s office locations on one interactive map. By setting a specific Label filter (e.g., “Headquarters” or “Branch”) and enabling Clustering, visitors can easily find the nearest office. The Marker On Click is set to Redirect, so clicking a marker takes the user to that office’s detail page for more info.
Vacation Rentals by Area: Create a page with the Single Map skin showing vacation rental listings filtered to a region (using Locations filter). Enable Map SearchPro so that as visitors pan or zoom the map, the rentals update to those visible in the area. This provides an intuitive way to find rentals geographically. Markers use Infowindow on click so users can preview details without leaving the map.
