web_map_feed Shortcode
The web_map_feed shortcode displays current Locations as readable image, title, address and description cards. Its keyboard-operable actions connect to a matching web_gmap or Gutenberg Map. It continues to render with the Legacy Page Builder editor disabled.
The attributes below match the current Page Builder controls and public output. Use raw syntax only for reviewed content that cannot be maintained through the visual controls.
Usage
[web_map_feed map_id="locations-map" action_label="Show location"]Attributes
| Attribute | Default | Accepted values | Purpose |
|---|---|---|---|
source |
current |
current, post |
Current post or another published accessible post. |
post_id |
0 |
Positive post ID | Required when source="post". Missing or unavailable sources render nothing. |
map_id |
Empty | Map HTML ID, without # |
Optional explicit destination; required if multiple maps share the locations. |
action_label |
Open infowindow and center | Plain text | Visible button label; the accessible name also identifies the location. |
device_visibility |
Empty | Space-separated web-hide-on-xs, web-hide-on-sm, web-hide-on-md, web-hide-on-lg |
Hides the feed in the selected device ranges. |
el_id |
— | Valid unique HTML ID | Enter section ID (Note: make sure it is unique and valid according to w3c specification). |
el_class |
— | String unless stated otherwise | If you wish to style particular content element differently, then use this field to add a class name and then refer to it in your css file. |
Source and map behavior
Populate the source post's Locations fields. All current rows are read, with publication, password and permission checks. The native Map Feed block has a separate 200-location limit. Library thumbnail IDs and recognized current-library URLs use live image metadata. No location data is copied into the shortcode.
Locations saved through earlier versions remain available without editing or resaving the source post. Once the current Locations field has been saved, its value takes precedence, including an intentionally empty list.
Use a Map Dynamic Route or web_gmap_dynamic_route containing the same source. Actions match location identity, not its title. An explicit missing map never falls back to a different map. Without a target, a location must belong to exactly one map. The map must be visible and ready before its buttons become available.
The feed itself has no additional CSS or JavaScript dependency. The Map owns the shared Google loader and runtime. Configure Google Maps under Settings → POM Theme → Integrations → Google Maps only when interactive maps are needed. Cards remain readable without a map or provider connection; unavailable actions are disabled. Ordinary WordPress Preview remains passive.
Verification
Test web_map_feed with populated, empty and long result sets, and verify the selected source belongs to the current site.
Check the target map, device visibility and keyboard activation. Changes to the source and library images appear on subsequent uncached renders. See the Map Feed guide for the equivalent block controls and troubleshooting.