Nick Dysle
06/22/2026, 5:21 PMmaxZoom set, they just use viewport: { area: "auto" } or continent_na. The issue is especially noticeable when the map is inside a dashboard switcher (smaller container).
We see the SDK changelog mentions: "Respect null value in max zoom level for geo charts, null means unrestricted zoom level" which implies maxZoom: null would fix it. But we're not sure:
1. What is the default`maxZoom`in the new MapLibre engine when not explicitly set?
2. Can we set`maxZoom`from the Analytical Designer UI, or only via SDK/YAML?
3. Is there a known behavior change with zoom limits when pushpin charts are embedded inside switchers?kapa.ai
06/22/2026, 5:21 PMmaxZoomLevel is in the MapLibre-based engine when the property is left undefined. What they do clarify is the semantics:
• undefined (i.e., not set) → keeps the default max zoom level (whatever MapLibre applies internally)
• null → removes the limit entirely (unrestricted zoom)
• A specific number → caps zoom at that value [Geo Pushpin Chart config] [API docs]
So if your charts previously had unrestricted zoom and now feel more restricted, setting maxZoomLevel: null explicitly is the correct fix based on the changelog behavior you referenced.
For GoodData.CN (self-hosted), there is also a platform-level setting that defaults to unlimited but can be capped:
platform_limits:
max_zoom_level: 12
[Geo Chart Configuration]
2. Setting maxZoomLevel via Analytical Designer UI vs. SDK/YAML The knowledge sources do not mention any Analytical Designer UI option for configuring maxZoomLevel. Based on the available documentation, this property is only configurable via:
• The SDK config prop (IGeoChartConfig / IGeoPushpinChartConfig) [API docs]
• The platform-level YAML setting (GoodData.CN only) [Geo Chart Configuration]
I'm sorry, but there's no information in the knowledge sources confirming that maxZoomLevel can be set from the Analytical Designer UI.
3. Zoom behavior inside dashboard switchers (smaller containers) The knowledge sources do not contain specific information about zoom limit behavior changes when pushpin charts are embedded inside switchers or smaller containers. However, there is a related option that may help in constrained containers:
• cooperativeGestures: true — requires Ctrl/Cmd + scroll to zoom, which is useful inside scroll containers and prevents accidental zoom interference [Geo Pushpin Chart config]
• viewport.frozen: true — locks pan and zoom entirely if needed [Geo Pushpin Chart config]
Recommended Fix To restore unrestricted zoom on your pushpin charts, explicitly set maxZoomLevel: null in your chart config:
config={{
maxZoomLevel: null,
viewport: { area: "continent_na" },
}}
This should override whatever default the MapLibre engine applies and restore unrestricted zoom behavior. [API docs] 👍 0 button 👎 0 button ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups.
👀 Our Support team monitors all messages and will jump in if needed.Nick Dysle
06/22/2026, 6:38 PMmaxZoomLevel: null to our pushpin insights and confirmed via API that the value is stored correctly. However, zoom is still capped at what appears to be level ~14 (metro area level — can see individual cities but not street-level).
A few questions:
1. Is there a platform_limits.max_zoom_level set on our Cloud instance (golmn / analytics.golmn.com) that would override the per-insight maxZoomLevel: null setting? The GoodData.CN docs reference this server-side cap.
2. Does the zoom behavior differ when an insight is embedded in a dashboard (or inside a dashboard switcher/tab) versus viewed standalone? Our maps are inside insight switchers on dashboards.
3. Did the default platform zoom limit change as part of the Mapbox → MapLibre migration? Previously our users could zoom to street level.kapa.ai
06/22/2026, 6:38 PMplatform_limits.max_zoom_level YAML setting is documented only for GoodData.CN (self-hosted deployments). [Geo Chart Configuration]
The knowledge sources contain no information about whether this platform-level cap exists or is configurable on GoodData Cloud (SaaS) instances like analytics.golmn.com, nor whether a server-side limit would take precedence over a per-insight maxZoomLevel: null. I cannot confirm or deny that a platform cap is overriding your setting — you would need to contact GoodData Support directly to check the platform configuration for your organization.
2. Zoom behavior: dashboard/switcher vs. standalone The knowledge sources do not document any difference in zoom behavior between an insight viewed standalone versus embedded in a dashboard or inside a switcher/tab. There is no information confirming that the dashboard container context affects the effective maxZoomLevel.
3. Default zoom limit change with Mapbox → MapLibre migration The knowledge sources do not document any specific change to the default platform zoom limit as part of the Mapbox → MapLibre migration, nor do they confirm that the default cap changed between engines.
What the knowledge sources do confirm [Geo Pushpin Chart config] [Geo Chart Configuration]
Recommendation Given that maxZoomLevel: null is confirmed stored correctly but zoom is still capped, and given the questions involve your specific Cloud instance configuration, I'd strongly recommend:
1. Opening a support ticket with GoodData to check if an organization-level zoom cap is set on your instance.
2. Asking specifically whether the Mapbox → MapLibre migration introduced a new default zoom ceiling on Cloud-hosted instances.
The knowledge sources available to me don't contain enough detail to diagnose this further. 👍 0 button 👎 0 button ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups.
👀 Our Support team monitors all messages and will jump in if needed., with interactive elementsNick Dysle
06/22/2026, 6:46 PMmaxZoomLevel: null per-insight and confirmed via API it's stored correctly but zoom is still restricted. Previously users could zoom in further than they can now.
Is this caused by: (a) a platform-level zoom cap on our org, or (b) a tile provider limitation after switching from Mapbox? Either way, what's needed to restore the previous zoom depth?Mauricio Cabezas
06/22/2026, 7:03 PMNick Dysle
06/22/2026, 7:14 PMMauricio Cabezas
06/22/2026, 7:30 PMNick Dysle
06/22/2026, 9:06 PMWe were able to zoom down to the Street Level overhead. We used to be able to see all the individual houses on the block.Nick Dysle
06/23/2026, 7:08 PMMichael Ullock
06/23/2026, 7:43 PMNick Dysle
06/23/2026, 7:50 PMMauricio Cabezas
06/24/2026, 1:29 PMNick Dysle
06/24/2026, 1:40 PMNick Dysle
06/24/2026, 1:47 PMMauricio Cabezas
06/24/2026, 2:46 PMNick Dysle
06/24/2026, 2:50 PM