Together, infoboxes and the carousel turn a map of pins into a browsable listing: click a marker to learn more, scroll the carousel to move the map, and keep content in sync.
Configure under Infobox settings, Carousel settings, Carousel style, Carousel items, and Layout settings.
Layout first
Layout settings choose how map and carousel (or list, if List & Filter replaces the carousel) are arranged — map above/below, side-by-side, heights, etc.
Pick a layout that matches your theme width. On mobile, Ultimate’s responsive behaviour stacks elements; test real devices early.
Infoboxes
An infobox is the richer card attached to a marker (image, title, text, link).
Type & size
Choose the infobox type/style your map should use, then adjust width/height so featured images and excerpts fit without clipping.
When it opens
| Behaviour | Typical use |
|---|---|
| On marker click | Default directory UX |
| On hover | Desktop-only exploratory maps (avoid as sole option on touch devices) |
| At a given zoom level | Show details only when zoomed in |
| Close button / close on mouse leave | Reduce sticky overlays |
Content
By default:
- Title ← post title
- Text ← excerpt (or trimmed content)
- Image ← featured image
- Link ← single post URL (or custom field URL if configured)
You can:
- Limit description length and add ellipses
- Build a custom title from custom fields
- Build custom content from fields and/or categories
- Choose how links open (same tab, new tab, modal — depending on options / tutorials)
- Disable infoboxes entirely if you only want carousel or List & Filter
Carousel
The carousel lists locations as horizontal (or mode-dependent) items synchronized with the map.
Show / hide & connection
- Show or hide the carousel
- Synchronize carousel items with the visible map viewport
- Connect or detach carousel and map interactions
- Optional hash navigation for deep links to items
Interaction
- Change map zoom when an item is clicked
- Scroll by mouse wheel or touch swipe
- Auto-scroll mode with easing / speed
- Number of items to scroll per step
- LTR / RTL mode for language direction
Carousel item content
Mirror infobox flexibility:
- List vs other item views
- Show/hide images and sizes
- Show/hide “read more” style links and link text
- Custom titles / content from fields
- Ellipses on long text
- Open links in the target you choose
Carousel style
Customize arrow buttons, container background, and item backgrounds so the carousel matches your brand (also see Customize for global colors).
Working with List & Filter
When the List & Filter module is enabled and activated on a map, it can replace the carousel with a richer list/grid + filters. Infoboxes and markers still apply; the carousel settings become less relevant for that map.
See List & Filter.
Content quality tips
- Write real excerpts — don’t rely on HTML-heavy post content.
- Use consistent featured image aspect ratios.
- Keep custom field templates short for mobile.
- If shortcodes appear as raw text inside infoboxes, see Troubleshooting (content filters).
