Embedded Charts

Parent: MongoDB Atlas Charts · Published reference · snapshot 2026-10-15

Depth-first rabbithole dossier for Embedded Charts; source-anchored research pack.

These notes link each claim to its source. Some citations identify archived research reports that are no longer hosted on this site. A published reference means the content is available; it does not certify independent review or accuracy.Read the editorial policy and follow the sources before relying on a claim.

Definitions

[low] MongoDB Charts is a built-in visualization tool for MongoDB Atlas that allows users to create dashboards directly from MongoDB data at no additional cost. Sources: https://www.knowi.com/blog/how-to-embed-mongodb-dashboards-in-your-app/ [source]

Structure and components

[low] The iframe embedding code contains the chart's base URL, chart ID, and any set options, which can be manually edited to adjust height, width, and border radius. Sources: https://www.mongodb.com/docs/charts/embedding-charts-iframe.md [source]

How it works

[low] When embedding a chart with Authenticated access, you can use the Injected function setting to inject a MongoDB filter document specific to each user via the Embedding Authentication Provider's token. Sources: https://www.mongodb.com/docs/charts/filter-embedded-charts.md [source]

Problems, failure modes and limitations

[medium] Embedded charts can be unauthenticated (viewable by anyone) or authenticated with a Verified Signature, though Verified Signature authentication is deprecated in favor of an embedding authentication provider. Sources: https://www.mongodb.com/docs/charts/embedding-charts-iframe.md, https://www.mongodb.com/docs/charts/embedded-chart-error-codes.md [source]
[low] If an embedded chart or dashboard fails to render, Charts displays an error code in place of the rendered content. Sources: https://www.mongodb.com/docs/charts/embedded-chart-error-codes.md [source]
[low] MongoDB Charts is exclusive to MongoDB Atlas and cannot connect to self-hosted MongoDB deployments, other databases, or REST APIs. Sources: https://www.knowi.com/blog/how-to-embed-mongodb-dashboards-in-your-app/ [source]
[medium] By default, no fields are allowed for filtering, meaning the chart cannot be pre-filtered or filtered until you explicitly allow at least one field. Sources: https://www.mongodb.com/docs/charts/embedding-charts-iframe.md, https://www.mongodb.com/docs/charts/filter-embedded-charts.md [source]
[low] The `autoRefresh` value must be an integer greater than 0. Sources: https://www.mongodb.com/docs/charts/embedded-chart-error-codes.md [source]
[low] JWT authentication errors can occur if the machine time issuing the token is more than 5 minutes ahead of actual time, and tokens cannot expire more than 24 hours from creation. Sources: https://www.mongodb.com/docs/charts/embedded-chart-error-codes.md [source]

Comparisons and alternatives

[low] Native tools like MongoDB Charts provide quick, zero-ETL schema exploration and real-time dashboarding directly within Atlas, though with limited customization compared to full BI platforms. Sources: https://hevodata.com/learn/mongodb-visualization/ [source]

Facts and statements

[low] MongoDB Charts does not offer reliable click-level events or data extraction for embedded analytics. Sources: https://www.knowi.com/blog/how-to-embed-mongodb-dashboards-in-your-app/ [source]
[low] MongoDB Charts only visualizes data from a single MongoDB collection per chart and does not support joins across collections or external sources. Sources: https://www.knowi.com/blog/how-to-embed-mongodb-dashboards-in-your-app/ [source]
[low] The on-prem version of MongoDB Charts was discontinued and became unsupported from September 2021, while the Atlas-supported version continues to receive updates. (verified as of 2026-10-15) Sources: https://www.mongodb.com/community/forums/t/is-mongodb-charts-discontinued/144944 [source]
[medium] You must be a dashboard Author to enable embedding for a chart. Sources: https://www.mongodb.com/docs/charts/admin-settings.md, https://www.mongodb.com/docs/charts/embedding-charts-iframe.md [source]
[low] If a chart is on a dashboard that has embedding enabled, the Embed Chart option is automatically enabled for that chart. Sources: https://www.mongodb.com/docs/charts/embedding-charts-iframe.md [source]
[low] You can embed a chart into a web application using an iframe, specifying settings such as height, width, refresh interval, and display theme. Sources: https://www.mongodb.com/docs/charts/embedding-charts-iframe.md [source]
[low] Adding only the `favorites` field to the allowed list does not grant viewers permission to filter upon any sub-fields of `favorites`. Sources: https://www.mongodb.com/docs/charts/filter-embedded-charts.md [source]
[low] Pre-filters run after chart views and before queries, using the same syntax as filters to reduce query running time by filtering data early. Sources: https://www.mongodb.com/docs/charts/filter-embedded-charts.md [source]
[low] You can specify an MQL document as the `preFilter` query parameter provided the fields used are in the list of allowed filterable fields. Sources: https://www.mongodb.com/docs/charts/filter-embedded-charts.md [source]
[low] The `filter` query parameter can be used on both Unauthenticated and Verified Signature charts, with filtering behavior differing based on the authentication setting. Sources: https://www.mongodb.com/docs/charts/filter-embedded-charts.md [source]
[low] For charts requiring a Verified Signature, all document fields can be filtered, but the filter must be generated in server-side code and included in the signed payload. Sources: https://www.mongodb.com/docs/charts/filter-embedded-charts.md [source]
[low] Filters must match the format of a `$match` query, and special characters in the filter parameter must be URL-encoded. Sources: https://www.mongodb.com/docs/charts/filter-embedded-charts.md [source]
[low] MongoDB Charts offers two embedding paths: iframe (quick but limited) and JavaScript SDK (more control with auth and filtering), though neither provides true multi-tenancy, row-level security, or full white-labeling. Sources: https://www.knowi.com/blog/how-to-embed-mongodb-dashboards-in-your-app/ [source]
[low] If a free user embeds a chart, a new four-hour option is selected by default as the auto-refresh interval. (verified as of 2026-10-15) Sources: https://www.mongodb.com/docs/charts/embedding-charts-iframe.md [source]
[low] The JavaScript SDK for embedding charts is installed via `npm install @mongodb-js/charts-embed-dom`. Sources: https://www.knowi.com/blog/how-to-embed-mongodb-dashboards-in-your-app/ [source]
[low] Filters in MongoDB Charts are client-side and modifiable, meaning they do not provide security or tenant-level enforcement. Sources: https://www.knowi.com/blog/how-to-embed-mongodb-dashboards-in-your-app/ [source]

Related concepts

Charts — is a part of Embedded Charts
Embedded — is a part of Embedded Charts

Children

No children recorded.

← the whole tree · 3D view· how to read this page