Embed Configuration
Configure security, appearance, and behavior of your embedded maps.
Embed Configuration
Mapsemble provides a wide range of configuration options to control the security, appearance, and behavior of your embedded maps. These settings are managed in your map's settings panel.
Domain whitelist
Restrict which websites can embed your map:
- In your map settings, add allowed domains to the domains list (e.g.,
example.com,www.mysite.org) - The server enforces this via
Content-Security-Policy: frame-ancestorsheaders - If no domains are configured, the map can be embedded on any site
- When domains are configured, only those domains (and the Mapsemble app itself) can load the embed
Enhanced security
Enable enhancedSecurity to require authentication even for embedded maps. When active, only authenticated users who have been granted access can view the embed. This is useful for internal tools or private datasets.
URL state sharing
Enable shareStateInUrl to encode the current filter state, zoom level, and map extent in the URL. When enabled:
- Users can copy the URL and share it with others
- The recipient will see the exact same view (filters, zoom, position)
- Useful for collaboration and support scenarios
Display configuration
Control how your map presents data:
| Option | Description | Values |
|---|---|---|
displayType |
Default view mode | cards (map + list), map (map only), table (tabular view) |
paginationEnabled |
Enable pagination in list view | true / false |
itemsPerPage |
Number of items per page | Default: 24 |
labelSingular |
Custom label for items | e.g., "property", "restaurant", "location" |
Theming
Customize colors and spacing to match your brand:
| Option | Description | Default |
|---|---|---|
buttonColor |
Primary color for buttons and interactive elements | — |
buttonColorHover |
Hover state color for buttons | — |
backgroundColor |
Background color (light mode) | — |
backgroundColorDark |
Background color (dark mode) | — |
mapGap |
Gap between the map and card list | 1.25rem |
mapRadius |
Border radius for UI components | 0.75rem |
darkModeEnabled |
Respect the user's system dark mode preference | true |
Colors accept any valid CSS color value (hex, rgb, hsl).
Map controls
Fine-tune map interaction:
| Option | Description | Default |
|---|---|---|
maxZoom |
Maximum zoom level (1–20) | 10 |
zoomControlsEnabled |
Show zoom +/- buttons on the map | true |
constraintExtent |
Lock the map view to the bounding box of your data | false |
showRemainingMarkers |
Show a count badge on clustered markers | false |
Filter behavior
| Option | Description |
|---|---|
autoSubmitFiltersEnabled |
Apply filters immediately when a user changes a value, without requiring a submit button |
resetFiltersEnabled |
Show a "Reset filters" button to clear all active filters at once |
Badge options
The Mapsemble badge varies by plan:
| Plan | Badge behavior |
|---|---|
| Free | Standard Mapsemble badge is displayed |
| Pro | smallBadge — A smaller, less prominent badge |
| Enterprise | hideBadge — No badge displayed at all |
Language
Pass ?language=xx in the embed URL to set the interface language:
https://app.mapsemble.com/embed/YOUR_MAP_ID?language=es
This requires translations to be configured in your map settings. Language support is available on Pro and Enterprise plans.
Scroll behavior
Enable scrollCardsOnHover to automatically scroll the corresponding card into view in the list when a user hovers over a marker on the map. This creates a visual link between the map markers and the list items, making it easier for users to find details about a specific location.