Skip to main content

Grid URL Parameters

The /embed/grid endpoint renders an EventsGrid component that displays places or events in a filterable grid layout.

Base URL​

/embed/grid?slug=<boundary-slug>

Required Parameters​

ParameterTypeDescription
slug OR boundarystringLocation boundary slug (e.g., "austin", "sf", "denver")
liststringAlternative: List slug that provides configuration from Lists API

Note: Either slug/boundary OR list must be provided. When using list, if the list has an associated organization, that organization's boundary will be used automatically.


Content & Data Parameters​

ParameterTypeDefaultDescription
typestring"places"Content type: "places" or "events"
vibesstring-Comma-separated vibe filters (e.g., "chill,artsy")
categoriesstring-Comma-separated category filters
tagsstring-Comma-separated tag filters
categoriesMatch / vibesMatch / tagsMatchstringanyall shows only items that have every category, vibe or tag passed in that group; any shows items with at least one.
editorial_categories or editorial_category or editorialCategorystring-Editorial category filters (always applied server-side).
featuredbooleanfalseWhen true, only show featured places/events
dist / radiusnumber-Radius in meters for proximity (geo-distance) search. Requires latitude + longitude to take effect.
latitude / latnumber-Center latitude for proximity search. Only used when longitude and dist/radius are also set.
longitude / lngnumber-Center longitude for proximity search. Only used when latitude and dist/radius are also set.
search / searchTermstring-Initial search term
hideNoImageItemsbooleanfalseHide items without images
hideWithImageItemsbooleanfalseThe inverse: show only items without an image. hideNoImageItems wins when both are on.
tiersstring-Filter by membership tier slugs. Comma-separated (e.g., "basic,premium"). Use "non-member" for items with no tier.
ordering / sortstring"-score_combined"Sort order for results (see below)

Sort Order (ordering / sort)​

Controls how places are sorted in the grid.

ValueDescription
nameAlphabetical by place name (A-Z)
-score_combinedDefault. By relevance/popularity score (highest first)
-vibe_countBy number of vibes (most vibes first)

View Parameters​

The grid embed renders the shared Combo controller (ADR-0004). Calendar joins Grid as a peer View; the Map View is disabled on this endpoint. The View toggle auto-hides when only one view is available (so Places, which is grid-only, never shows a toggle).

ParameterTypeDefaultDescription
viewsstring (CSV, ordered)grid,calendar (events) / grid (places)Ordered list of Available views. Order = toggle order; presence = enabled. Tokens: grid, calendar, map. map is ignored on the grid endpoint and calendar is always stripped for Places (Events-only). Duplicates are de-duped; an empty/all-stripped result falls back to grid. Legacy list token is accepted and mapped to grid. Example: views=calendar,grid.
defaultViewstringfirst entry of viewsStarting view. Must be one of the (guarded) Available views, else falls back to the first entry. Values: grid, calendar (map n/a here).
initialViewstring—Deprecated alias for defaultView; honoured only when defaultView is absent. Now also accepts calendar. Legacy list → grid.
calendarMonthsnumber (1–12)theme calendar.monthsToShow → 1Number of months the Calendar View renders at once.
calendarCardStylestringtheme calendar.cardStyle → compactCalendar event card style: compact (default — small thumbnail + accent time + one-line title, no date badge) or card (full ui-components Card).
calendarMaxPerDaynumbertheme calendar.maxEventsPerDay → 4Max events shown per day cell before a "+N more" link. When omitted, resolves from the active theme's calendar.maxEventsPerDay.

Calendar View behaviour (ADR-0005): In Calendar View the global date filter is bypassed and its date-range chip is hidden — the calendar's own month navigation is the date control. Taxonomy / vibe / category / search filters still apply. The date-filter value is preserved and re-applies when switching back to Grid.

Examples:

# Events grid that opens on the calendar, showing two months
/embed/grid?slug=austin&type=events&defaultView=calendar&calendarMonths=2

# Grid-only events (no calendar toggle)
/embed/grid?slug=austin&type=events&views=grid

# Calendar-first with full-size cards
/embed/grid?slug=austin&type=events&views=calendar,grid&calendarCardStyle=card

Filter Behavior Parameters​

ParameterTypeDefaultDescription
strictFilterbooleanfalseWhen true, taxonomy filters are applied server-side (AND logic); unless filterBehavior=open or a param names several terms, they also stay preselected chips. When false, filters are client-side (OR logic) chips. The page's server-rendered cards and structured data hold only the items the chips keep, and none for a tags chip, which depends on a tag list only the browser loads.
onlyShowPassedTaxonomiesbooleanfalseWhen true, each filter row shows only the values passed via URL (plus subcategories for hierarchical taxonomies); a row with none passed keeps all its chips.
searchModestring"hybrid"hybrid adds a server-side fuzzy search over the same items to the in-browser match; client matches the loaded items only. Falls back to theme.filters.searchMode.
filterBehaviorstring"trapped"Only applies when strictFilter=true. Controls how users can navigate taxonomy filters:

Filter Behavior Options:

  • "trapped" - User is locked within the passed taxonomy values and their children
  • "selected" - Passed filter values are pre-selected, but user can deselect and explore other options
  • "open" - All taxonomies shown, passed values are not pre-selected

Grid Display Parameters​

ParameterTypeDefaultDescription
gridColumnsnumber3Number of columns in the grid
shownAtStartnumber99Number of items shown initially (before "Load More")
showTitlebooleanfalseShow the list's name (a boundary grid's boundary name, a location grid's area) as the embed's <h1> above it. Off, the heading is still in the page for screen readers and crawlers, just not shown.
layoutModestringdefaultsidebar-left / sidebar-right put a sidebar column beside the grid cards. Pair with showTopLevelFilters=false to move the filters into it.
showMiniCalendarbooleanfalseEvents only, sidebar layouts only. A month calendar at the bottom of the sidebar; click a day to filter to it, then a second day to extend to a range.
showContentModeTogglebooleantrue (events) / false (places)Show Events/Venues toggle. Users can switch between viewing events and venues with event counts. Defaults to true when type=events.

Filter UI Parameters​

ParameterTypeDefaultDescription
showFiltersbooleantrueShow the filter bar. false hides it.
showSearchFilterbooleantrueShow the search input
showVibeFilterbooleantrueShow the vibes filter
showCategoryFilterbooleanautoShow the category filter (auto-enabled for places)
showTagFilterbooleantrueShow the tags filter
showAllTagsbooleanfalseWhen true, force the tag filter row on and bypass any tagsToInclude/tagsToExclude restrictions (from both URL and theme), showing every tag. Theme equivalent: theme.filters.showAllTags.
hideAllCategoriesPillbooleanfalseWhen true, remove the "All Categories" pill from the category row.
hideAllTagsPillbooleanfalseWhen true, remove the "All Tags" pill from the tag row.
tagsToIncludestringthemeComma-separated allowlist of tag slugs/names — only these tags appear in the tag filter. Falls back to theme.filters.tagsToInclude. Ignored when showAllTags=true.
tagsToExcludestringthemeComma-separated blocklist of tag slugs/names to hide from the tag filter. Falls back to theme.filters.tagsToExclude. Ignored when showAllTags=true.
categoriesToIncludestringthemeComma-separated allowlist of category names, slugs or slug_unique values. Only these, with their subcategories, appear in the category filter; an included subcategory keeps its parent as the way in. Falls back to theme.filters.categoriesToInclude.
categoriesToExcludestringthemeComma-separated blocklist of categories to hide from the category filter, subcategories included. Falls back to theme.filters.categoriesToExclude. Beats categoriesToInclude.
vibesToIncludestringthemeComma-separated allowlist of vibe names/slugs — only these appear in the vibe filter. Falls back to theme.filters.vibesToInclude.
vibesToExcludestringthemeComma-separated blocklist of vibe names/slugs to hide from the vibe filter. Falls back to theme.filters.vibesToExclude.
showTierFilterbooleanfalseShow membership-tier filter chips (filter items by membership tier).
showItemCountOnFiltersbooleantrueShow item counts on filter chips
visibleCatsnumber5Max categories to show before "Show More" pill (default: 5, 0 = show all)
visibleVibesnumber-Max vibes to show before "Show More" pill (undefined = show all)
visibleTagsnumber5Max tags to show before "Show More" pill (default: 5, 0 = show all)
filterViewModestring"horizontal"Filter layout: "horizontal" or "tabbed"
filterSelectionModestring"auto"Selection mode: "single", "multiple", or "auto"
multiSelectTaxonomiesarray[]Taxonomy slugs that allow multi-select (e.g., ["vibes","tags"])
taxonomySortOrderstring"count"Sort order for taxonomy chips (see below)
categoryOrderlistthemeComma-separated category slugs (slug_unique) to show first in the category filter, in this order. The rest keep the taxonomySortOrder sort. Overrides theme.filters.categoryOrder.
vibeOrderlistthemeComma-separated vibe slugs to show first in the vibe filter, in this order. Overrides theme.filters.vibeOrder.
tagOrderlistthemeComma-separated tag slugs to show first in the tag filter, in this order. Overrides theme.filters.tagOrder.
loginButtonSizenumber32Avatar size (px) of the login/account button shown in the filters bar.

Taxonomy Sort Order (taxonomySortOrder)​

Controls how filter chips are sorted. Default is count (most items first).

Format: "taxonomy:order,taxonomy:order"

Values:

ValueDescription
countDefault. Sort by item count (most items first), then alphabetically
alphaAlphabetical sorting (theme order → color → A-Z)

Example: taxonomySortOrder=vibes:alpha,categories:alpha,tags:alpha for all alphabetical.

Geography Filter (showGeoFilter)​

A Region filter that narrows the cards to a city, county, neighborhood, area or address.

ParameterTypeDefaultDescription
showGeoFilterbooleantheme / falseShow the Region filter. Falls back to theme.filters.showGeoFilter.
geoFilterLabelstring"Region"Heading of the Region filter.
geoFilterTypeslistallComma-separated tabs to offer: cities, counties, neighborhoods, boundaries (shown as "Area"), addresses. A tab with no options is hidden.
geoFilterDefaultTypestring-Tab open on load, from the geoFilterTypes values. Without it, City opens when it has options, else the first tab that does.
geoFilterAllowUserTypeSwitchbooleantrueShow the tabs so visitors can switch type. false locks the filter to the default tab.
geoFilterAddressSearchEnabledbooleantrueOn the Address tab, offer an address search with a distance picker (1, 5, 10 or 25 mi).
geoFilterOptionsToIncludelist-Comma-separated option names or slugs. Only these appear.
geoFilterOptionsToExcludelist-Comma-separated option names or slugs to hide.

Date Filter Parameters (Events Only)​

ParameterTypeDefaultDescription
showDateRangeSelectorbooleantrueShow date range selector (only for type=events)
initialDateFilterstring"" (no limit)Pre-selects the date picker on load with a rolling/preset window the visitor can still widen or change. One of: today, weekend, next_7_days (rolling: today → today+6), next_week (calendar Mon–Sun), month, quarter, half_year, year. Empty = show all. Unlike dateBoundaryStart/End, this is a default selection, not a hard limit.
dateFilterOptionsarray["upcoming","today","weekend","next_week","month"]Available date filter options
groupRecurringEventsbooleanfalseGroup recurring events to show only next occurrence
collapseConsecutiveRunsbooleantrueShow an event that runs on back-to-back days (e.g. a Wed–Sun exhibit) as one card. false shows a card per day. An event's own collapse setting wins. Weekly series follow groupRecurringEvents.
showRecurrenceBadgebooleanfalseShow the recurrence label pill (e.g. "Weekly Wed - Sun") on event cards
hideRangedEventsbooleanfalseHide "ranged" events — those with a duration longer than 24 hours (e.g. multi-day festivals, ongoing exhibits).
recurringBadgeLinkTostring"grid-filter"Where recurring badge click navigates: "grid-filter" (filter in place) or "event-series-page" (navigate to series page)

Date Boundary​

Hard date limits that exclude events outside the range, regardless of user filter selections.

ParameterTypeDefaultDescription
dateBoundaryStartstring-Events before this date are excluded. Accepts yyyy-MM-dd or relative offset.
dateBoundaryEndstring-Events after this date are excluded. Accepts yyyy-MM-dd or relative offset.

Relative offset format: +Nd (days), +Nm (months), +Ny (years). Negative values work too (-7d = 7 days ago). The offset is computed fresh on each page load relative to the current date.

Examples:

# Only show events in the next 14 days
/embed/grid?slug=austin&type=events&dateBoundaryEnd=%2B14d

# Next 3 months of events
/embed/grid?slug=austin&type=events&dateBoundaryEnd=%2B3m

# Events between specific dates
/embed/grid?slug=austin&type=events&dateBoundaryStart=2026-06-01&dateBoundaryEnd=2026-09-01

Note: The + character must be URL-encoded as %2B in query strings.

Past Event Window​

Controls how long after an event's end time it remains visible in the grid. Default behavior keeps every event visible for 90 minutes after it ends, so events with identical start/end times don't disappear the instant they begin.

ParameterTypeDefaultDescription
pastWindowinteger (minutes)90Minutes after end_date that an event remains eligible. 0 cuts at end. 1440 shows for 1 day. 10080 shows for a week. Overridden by pastCutoff if both are set. Applies to the Grid, List and Map views, as in the Carousel; the Calendar shows whole days.
pastCutoffISO 8601 datetime–Absolute floor — only events with end_date >= pastCutoff are shown, e.g. 2026-06-01T00:00:00. Site-local time. Overrides pastWindow when set.

Examples:

# Show events for 6 hours after they end
/embed/grid?slug=austin&type=events&pastWindow=360

# Show all events from the past week onward
/embed/grid?slug=austin&type=events&pastWindow=10080

# Show every event ending on/after June 1, 2026
/embed/grid?slug=austin&type=events&pastCutoff=2026-06-01T00:00:00

Admin Display Settings (logged-in users only)​

The Advanced panel exposed in the Filters bar to logged-in users surfaces display toggles that change what appears in the embed:

  • Show unapproved — drops is_approved=true from API queries
  • Show closed places — drops is_closed=false (places only)
  • Hide items without images
  • Min completeness score

These are admin-only and intentionally have no URL surface. The toggles exist solely in the Advanced panel for logged-in users. User overrides are persisted per-embed-instance in localStorage. Cascade for resolution: user override (panel) > theme default > code default.

The persistence scope is keyed by a hash of themeName + type + listId + cityId + boundary + embedInstance. Two identically-configured iframes on the same host page share state by design; pass embedInstance=foo (URL param) to force separation.

ParameterTypeDefaultDescription
embedInstancestring-Optional opaque suffix used to give two otherwise-identical embeds independent admin-override scopes.
hideNoImageItemsbooleanfalsePre-existing public param. Hide items that don't have images. Logged-in users can also override via the panel.

Developer guide for adding a new admin display toggle: web/src/hooks/useAdvancedDisplaySettings.ts.


Card Display Parameters​

ParameterTypeDefaultDescription
showVibesOnCardsbooleantrueShow vibes on cards
showTagsOnCardsbooleanfalseShow tags on cards
showAddressOnCardsbooleantrueShow address on cards. Deprecated: use subtitle2Source=address&subtitle2Position=below-title instead.
subtitleSourcestring"none"Source for card subtitle: "none", "category", "address", etc.
subtitleSourcesstring-Comma-separated list of sources to combine for the first subtitle when subtitleSource=custom. First-subtitle analog of subtitle2Sources — same token vocabulary, joined with •.
subtitlePositionstring"above-title"Subtitle position: "above-title" or "below-title"
subtitle2Sourcestringcontent-type defaultData source for the second subtitle. Default: places="address", events="none". Options: "none", "category", "tag", "vibe", "address", "venue", "date" (date only, e.g. "Jun 15th"), "weekday_date" (weekday and date, e.g. "Mon Nov 16"), "start_date_time" (date + time, e.g. "Jun 15th • 7:00 PM"), "price", "custom" (combine multiple — see subtitle2Sources)
subtitle2Sourcesstring-Comma-separated list of sources to combine when subtitle2Source=custom. Each token uses the same vocabulary as subtitle2Source (e.g. category, venue, start_date_time). Empty values are skipped; the rest are joined with •. Example: subtitle2Source=custom&subtitle2Sources=venue,start_date_time → "Great Hall • Jun 15th • 7:00 PM"
subtitle2Positionstring"below-title"Position of the second subtitle: "above-title" or "below-title"
showRatingbooleanfalseShow ratings on cards
showBookmarkbooleanfalseShow bookmark button on cards
smartCropbooleantrueImageKit AI smart crop (fo-auto). Set false for deterministic center crop
linkToExternalUrlbooleanfalseOpen each card's source URL (event source, place website) in a new tab instead of the internal single-post page. Falls back to the internal permalink when no source URL is set.
showTierBadgebooleanfalseShow the membership-tier badge on cards (e.g. "Premium").
showFeaturedBadgebooleantrueShow the "Featured" badge on featured cards. false hides it; featured items still sort first.
usePillLayoutbooleantrueFor multi-day events, render the date badge as a horizontal pill (date range). Set false for the stacked calendar-style badge.
pillSingleDaybooleanfalseRender single-day event date badges as the horizontal pill too (Oct 8). Combine with usePillLayout=true for pills on every event.
pillShowTimebooleanfalseAppend the start time to single-day pills (Oct 8 · 7PM). Needs pillSingleDay=true. Never shown on multi-day pills, all-day events, or ongoing events.
showDayOfWeekbooleanfalseName the weekday on single-day date badges (Fri Nov 13). Multi-day ranges are unchanged. A list's events.showDayOfWeek theme override sets the default.
ongoingEventShowNowbooleanfalseFor ongoing events (started in the past, still running), show the start as "Now" instead of today's date.
timeBadgesstring- (off)Comma-separated list of time-relative event badges to enable on cards (e.g. today,tonight,weekend). Off by default. Only the single highest-precedence matching badge renders per card. Falls back to theme.cards.timeBadges. See values below.
disclaimerstringthemeEvents only. Text of the notice on the Vibemap event page a card opens, replacing the partner's disclaimer set in the Hub. An empty value (disclaimer=) hides the notice. An event page on your own site shows the notice its own snippet sets.

Time Badges (timeBadges)​

Opt-in, time-relative badges for event cards, computed from each event's start (and optional end) relative to "now". Pass a comma-separated list of types; unknown values are ignored. Only the single highest-precedence match renders per card.

ValueBadge labelMatches when…
ongoing"Ongoing"A multi-day event (≥ 24h span) is currently running
happening-now"Happening Now"The event is currently live (start ≤ now ≤ end; requires an end date)
tonight"Tonight"Starts today, at or after 5pm
today"Today"Starts today
tomorrow"Tomorrow"Starts tomorrow
weekend"This Weekend"Starts during the upcoming Sat–Sun window
this-week"This Week"Starts within today → next 7 days

Precedence is highest-first in the order above — e.g. a 7pm event tonight shows "Tonight" rather than "Today" when both are enabled. Labels can be overridden per theme via theme.cards.timeBadges.

Example: timeBadges=happening-now,today,tonight,weekend

Updates Display​

ParameterTypeDefaultDescription
showUpdatesbooleanfalseEnable updates display on cards
updatesDisplayModestring"badge"Display mode: "badge" or "text"
updatesFilterTypesstring-Comma-separated types: update,offer,clue,sponsor,special

Theme Parameter​

ParameterTypeDefaultDescription
theme / themeNamestringthe list's theme, else "default"Theme slug for styling. Omit it with list= to use the list's own theme.

Category Names (categoryLabels)​

Renames single categories (and tags, vibes) on this grid only, wherever the theme's category names show. The Map and Calendar builders write all three; Hub auto embeds write categoryLabels from the names picked in Manage auto embeds.

ParameterTypeDefaultDescription
categoryLabelsJSONnoneURL-encoded {"<slug_unique>": "<name>"}. Beats the list's theme_overrides and the theme's Taxonomies names. Blank or non-string names are skipped.
tagLabelsJSONnoneURL-encoded {"<tag slug>": "<name>"}. Same layering as categoryLabels, for tags.
vibeLabelsJSONnoneURL-encoded {"<vibe name>": "<name>"}. Same layering as categoryLabels, for vibes.

Not map-grid's categoriesLabel, which renames the Categories filter heading. A theme's legacy filters.category_names still wins in the filter row.

# Show "food" as "Eats" and "entertainment_music" as "Live sets"
/embed/grid?slug=austin&categoryLabels=%7B%22food%22%3A%22Eats%22%2C%22entertainment_music%22%3A%22Live%20sets%22%7D

Vibe and Tag Names (vibeLabels, tagLabels)​

Rename single vibes and tags on this grid only, as categoryLabels does for categories. Hub auto embeds set them from Manage auto embeds (VA#6771); Vibemap writes tag slugs, since a tag's slug can't be worked out from its name. Blank or non-string names are skipped.

ParameterTypeDefaultDescription
vibeLabelsJSONnoneURL-encoded {"<vibe name>": "<name>"}. Beats the list's theme_overrides and the theme's Taxonomies names.
tagLabelsJSONnoneURL-encoded {"<tag slug>": "<name>"}, keyed by slug, not name. Beats the list's theme_overrides and the theme's Taxonomies names.

Not map-grid's vibesLabel / tagsLabel, which rename the filter headings. A theme's legacy filters.tag_names still wins in the filter row's tag chips. A tag that reaches the embed as a bare string, with no slug, keeps its own name.

# Show the vibe "cozy" as "Snug" and the tag "Arts & Culture" (slug arts-and-culture) as "Culture"
/embed/grid?slug=austin&vibeLabels=%7B%22cozy%22%3A%22Snug%22%7D&tagLabels=%7B%22arts-and-culture%22%3A%22Culture%22%7D

Sticky-Header Offset (scrollToTopOffset)​

Applies to data-resize="true" embeds. When a visitor scrolls down the grid and clicks a card, the single place/event opens in place and load.js scrolls the host page back up so the item's title/hero is in view. If your host page has a sticky or fixed header, the embed's top edge lands underneath it and the title stays covered. Set scrollToTopOffset to your header's height (px) to leave that much gap above the embed after the scroll, so the title clears the header.

ParameterTypeDefaultDescription
scrollToTopOffsetnumber0Extra pixels of gap left above the embed when it scrolls to the top after opening a single item. Set to your sticky header's height. Non-negative integers only; 0 rests the embed flush against the viewport top (the original behavior).

Where it's read: Put scrollToTopOffset in the embed's URL params, alongside the others — it works on a proxied api.vibemap.com/list/<slug> short link too, because the embed reads it inside the iframe and forwards it to the loader over postMessage. The value is retained across the in-embed grid→single navigation, so you set it once on the grid embed and it also applies to the single/similar-item views opened from it. (For host-side configuration load.js also honors it on the <script>'s data-url query or a data-scroll-to-top-offset="100" attribute.)

/embed/grid?slug=austin&scrollToTopOffset=96

Example URLs​

Basic Places Grid​

/embed/grid?slug=austin&type=places

Events with Date Filters​

/embed/grid?slug=dc&type=events&showDateRangeSelector=true

Grid with Custom Columns​

/embed/grid?slug=la&gridColumns=4&shownAtStart=20

List-Based Grid​

/embed/grid?list=my-curated-list&gridColumns=3

Filtered by Vibes (Client-Side)​

/embed/grid?slug=sf&vibes=chill,artsy&showVibeFilter=true

Strict Filtering (Server-Side)​

/embed/grid?slug=sf&strictFilter=true&categories=food&vibes=chill

Trapped Filter Behavior​

/embed/grid?slug=austin&strictFilter=true&filterBehavior=trapped&categories=food

Custom Theme and Display Options​

/embed/grid?slug=denver&theme=dark&showVibesOnCards=true&showAddressOnCards=true
/embed/grid?slug=nyc&type=events&gridColumns=3&shownAtStart=50&showVibesOnCards=true&showDateRangeSelector=true&filterViewMode=horizontal&theme=default

PostMessage Events​

The embed communicates with the parent window via postMessage:

Event TypeDescriptionData
"view-changed"User switched View via the toggle{ embedId: "grid", view: "grid" | "calendar" }
"filters-changed"User changed a taxonomy/search filter{ embedId: "grid", data: <updates> }

Note: Since converging onto the shared Combo controller, cards navigate via their permalink (a normal link) rather than emitting a card-clicked postMessage. Use a standard link/navigation handler in the parent if you need to intercept clicks.

Example Parent Window Handler​

window.addEventListener("message", (event) => {
if (event.data.embedId === "grid") {
switch (event.data.type) {
case "view-changed":
console.log("View switched to:", event.data.view);
break;
case "filters-changed":
console.log("Filters changed:", event.data.data);
break;
}
}
});

Message Origin​

Embed messages may arrive from either of these origins:

  • https://web.vibemap.com — when the embed is loaded directly
  • https://api.vibemap.com — when the embed is loaded via a Vibemap list link (/list/<slug>) or short link (/s/<slug>), which reverse-proxies the embed page through the API host

Parent-window listeners should filter by payload (event.data.embedId and event.data.type) rather than event.origin. The example handler above already follows this pattern.

If you must check event.origin, accept BOTH https://web.vibemap.com AND https://api.vibemap.com.


Embedding​

Basic iframe Embed​

<iframe
src="https://vibemap.com/embed/grid?slug=austin&type=places"
width="100%"
height="600"
frameborder="0"
style="border: none;"
></iframe>

Responsive Embed​

<div style="position: relative; width: 100%; padding-bottom: 75%;">
<iframe
src="https://vibemap.com/embed/grid?slug=austin"
style="position: absolute; top: 0; left: 0; width: 100%; height: 100%; border: none;"
></iframe>
</div>

Analytics Opt-Out (analytics)​

ParameterTypeDefaultDescription
analyticsstringonSet to off (also false, 0, no) to stop the embed loading analytics for that page load

Vibemap embeds load a Google Tag Manager container to measure how visitors use maps, cards and filters. analytics=off prevents it entirely — the container is never added to the page and no events are sent. The embed itself is unaffected.

/embed/grid?list=downtown-erie&type=events&analytics=off

Where it's read: either the embed URL or the upstream URL behind a proxied short link. A customer embed usually loads through api.vibemap.com/list/<slug>, which fetches the real embed URL server-side while the browser keeps the clean short link — so analytics=off works whether you add it to the short link or bake it into the list's embed configuration.

This is independent of any analytics your own site loads, and independent of the WordPress plugin's Vibemap Settings → Features → Enable Analytics toggle, which governs Vibemap blocks rendered directly into a WordPress page.