# Embedded Charts > Depth-first rabbithole dossier for Embedded Charts; source-anchored research pack. Parent: [MongoDB Atlas Charts](https://llms-explorer.com/tree/mongodb-atlas-charts/) · 6 facets · 26 facts · page: https://llms-explorer.com/tree/embedded-charts/ ## 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: `~/.global-ai-hub/research/.pipeline/mongodb-2026-10-14/frb/embedded-charts-d508609d91/rabbithole-synthesis.md#core` ## 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: `~/.global-ai-hub/research/.pipeline/mongodb-2026-10-14/frb/embedded-charts-d508609d91/rabbithole-synthesis.md#core` ## 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: `~/.global-ai-hub/research/.pipeline/mongodb-2026-10-14/frb/embedded-charts-d508609d91/rabbithole-synthesis.md#core` ## 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: `~/.global-ai-hub/research/.pipeline/mongodb-2026-10-14/frb/embedded-charts-d508609d91/rabbithole-synthesis.md#core` - [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: `~/.global-ai-hub/research/.pipeline/mongodb-2026-10-14/frb/embedded-charts-d508609d91/rabbithole-synthesis.md#troubleshooting` - [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: `~/.global-ai-hub/research/.pipeline/mongodb-2026-10-14/frb/embedded-charts-d508609d91/rabbithole-synthesis.md#core` - [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: `~/.global-ai-hub/research/.pipeline/mongodb-2026-10-14/frb/embedded-charts-d508609d91/rabbithole-synthesis.md#core` - [low] The `autoRefresh` value must be an integer greater than 0. Sources: https://www.mongodb.com/docs/charts/embedded-chart-error-codes.md — source: `~/.global-ai-hub/research/.pipeline/mongodb-2026-10-14/frb/embedded-charts-d508609d91/rabbithole-synthesis.md#troubleshooting` - [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: `~/.global-ai-hub/research/.pipeline/mongodb-2026-10-14/frb/embedded-charts-d508609d91/rabbithole-synthesis.md#troubleshooting` ## 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: `~/.global-ai-hub/research/.pipeline/mongodb-2026-10-14/frb/embedded-charts-d508609d91/rabbithole-synthesis.md#core` ## 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: `~/.global-ai-hub/research/.pipeline/mongodb-2026-10-14/frb/embedded-charts-d508609d91/rabbithole-synthesis.md#antipatterns` - [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: `~/.global-ai-hub/research/.pipeline/mongodb-2026-10-14/frb/embedded-charts-d508609d91/rabbithole-synthesis.md#core` - [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: `~/.global-ai-hub/research/.pipeline/mongodb-2026-10-14/frb/embedded-charts-d508609d91/rabbithole-synthesis.md#core` - [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: `~/.global-ai-hub/research/.pipeline/mongodb-2026-10-14/frb/embedded-charts-d508609d91/rabbithole-synthesis.md#core` - [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: `~/.global-ai-hub/research/.pipeline/mongodb-2026-10-14/frb/embedded-charts-d508609d91/rabbithole-synthesis.md#core` - [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: `~/.global-ai-hub/research/.pipeline/mongodb-2026-10-14/frb/embedded-charts-d508609d91/rabbithole-synthesis.md#core` - [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: `~/.global-ai-hub/research/.pipeline/mongodb-2026-10-14/frb/embedded-charts-d508609d91/rabbithole-synthesis.md#core` - [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: `~/.global-ai-hub/research/.pipeline/mongodb-2026-10-14/frb/embedded-charts-d508609d91/rabbithole-synthesis.md#core` - [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: `~/.global-ai-hub/research/.pipeline/mongodb-2026-10-14/frb/embedded-charts-d508609d91/rabbithole-synthesis.md#core` - [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: `~/.global-ai-hub/research/.pipeline/mongodb-2026-10-14/frb/embedded-charts-d508609d91/rabbithole-synthesis.md#core` - [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: `~/.global-ai-hub/research/.pipeline/mongodb-2026-10-14/frb/embedded-charts-d508609d91/rabbithole-synthesis.md#core` - [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: `~/.global-ai-hub/research/.pipeline/mongodb-2026-10-14/frb/embedded-charts-d508609d91/rabbithole-synthesis.md#core` - [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: `~/.global-ai-hub/research/.pipeline/mongodb-2026-10-14/frb/embedded-charts-d508609d91/rabbithole-synthesis.md#core` - [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: `~/.global-ai-hub/research/.pipeline/mongodb-2026-10-14/frb/embedded-charts-d508609d91/rabbithole-synthesis.md#core` - [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: `~/.global-ai-hub/research/.pipeline/mongodb-2026-10-14/frb/embedded-charts-d508609d91/rabbithole-synthesis.md#tools` - [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: `~/.global-ai-hub/research/.pipeline/mongodb-2026-10-14/frb/embedded-charts-d508609d91/rabbithole-synthesis.md#antipatterns` ## Related concepts - Charts — is a part of Embedded Charts - Embedded — is a part of Embedded Charts