This documentation refers to the on-premises edition of MongoDB Charts. Read the Atlas service documentation to learn how to use MongoDB Charts with your Atlas project.

Release Notes

MongoDB Charts 19.12.2

Released July 29, 2020

  • Updates base Docker OS image to address identified vulnerabilities.

MongoDB Charts 19.12.1

Released December 16, 2019

Bug Fixes

MongoDB Charts 19.12

Released December 10, 2019

New Features

Bug Fixes

  • 100% stacked charts now show a percentage scale on the axis.
  • Prevents multiple data source samples from running at once when quickly switching data source in the Chart Builder.
  • Tables with a large number of dynamic columns now return an error instead of hanging the browser.
  • Dashboards can now be scrolled using devices that support touch-screen feature.
  • The existence of value and count of occurences array reductions now succeed even if some documents have null or missing values.
  • Legends on donut charts should no longer overlap with the donut.
  • Long category names are now truncated, maximizing space for the chart.
  • Improved error handling for queries with mismatched brackets.
  • Embedded charts no longer go blank while refreshing.
  • Performing a new operation in the Chart Builder now cancels previous operations, preventing the chance of multiple responses coming back in an unexpected order.
  • Table row totals correctly display at the far right of the table at all times.
  • Encoding cards can now be more reliably swapped across chart channels.
  • Singapore is now shown on Choropleth maps using the Countries and Regions scheme.
  • Choropleth tooltips are now shown on the largest land mass of a region.
  • String Filter card now correctly shows sample values from arrays of documents.
  • Null values in chart categories now show as null, not 0.
  • Improves rendering of dates on continuous chart axes.
  • Ellipsis menu is now accessible for data sources at the bottom of the grid.
  • Miscellaneous performance, reliability and security improvements.

MongoDB Charts 19.09

Released September 2, 2019

New Features

  • New option to specify an autorefresh interval for embedded charts.
  • New option to specify a custom filter for embedded charts using Verified Signature authentication.
  • New option to enable or disable thousands separators in numbers on charts.
  • Ability to enable and disable chart filters.
  • Ability to set preferred time zone when using an absolute date filter.
  • Visual refresh of the Chart Builder.
  • New design for Data Sources page.
  • New Data Source Name attribute replaces the Alias attribute.
  • Data Source owners can now add, edit, or remove an Aggregation Pipeline on a data source, including the ability to join multiple collections using $lookup.
  • Version detection to detect unsupported MongoDB versions or disable unsupported chart features.

Bug Fixes

  • Addressed various issues when building and rendering geospatial charts.
  • Fixed an issue that could cause charts to appear blank when refreshing large dashboards.
  • String Filter card shows a more complete set of sample values for large, indexed collections.
  • Support for .pem certificate files with private key appearing after the certificate.
  • Time zone conversions are now correct in Table chart types.
  • Support for queries using { $not: { $regex: } } structure.
  • Miscellaneous performance, reliability and security improvements.
  • Security and reliability improvements.

MongoDB Charts 19.06.1

Released July 5, 2019

  • Security and reliability improvements.

MongoDB Charts 19.06

Released June 12, 2019

General Availability Release

New Features

Bug Fixes

  • Fixed bad rendering in some stacked area charts.
  • Fixed some cases where binned data could appear in the wrong order.
  • Automatic dashboard refresh should work more reliably after resuming from sleep.
  • Tooltips on area charts now show on hover over any part of the area, not just the data points.
  • Charts can now be configured to use metadata clusters with SSL client certificates.
  • Miscellaneous performance, reliability and security improvements.

MongoDB Charts v0.12.0

Released February 7, 2019

New Features

  • New default sort behavior in charts. By default, charts now sort by aggregated value, instead of by category name.
  • New filter bar in the chart builder, with increased performance and usability.

Bug Fixes

  • Filter parsing now better aligns with MongoDB Shell syntax, specifically with respect to dates.

    • The Date() function now correctly returns the date as a string representation. As a result, the following usages of Date in filters are no longer valid in the query bar:


      Instead, you must either use new when using Date:

      // return the current date
      new Date()
      // return a specific date
      new Date("2019-01-01")

      Or use ISODate():

      // return the current date
      // return a specific date
  • You can now successfully access MongoDB Charts when it is running on non-standard ports or with an SSL termination appliance in front of it. This was possible in the v0.10.0 release, but failed in the v0.11.0 release.

  • Fixed rendering issues in certain browser versions relating to the continuous color picker in the Chart Customization options.

  • Miscellaneous performance, reliability, and security improvements.

MongoDB Charts v0.11.0

Released January 15, 2019

New Features

  • Chart Customization
    • Change axis labels
    • Change number formats
    • Change data formats
    • Convert time zones
    • Change color palettes
    • Show/hide data labels
    • Show/hide data points
    • Change axis range
    • Set logarithmic scale on axes
  • New Chart Types
    • Data Table
    • 100% Stacked Bar
    • 100% Stacked Column
    • 100% Stacked Area
  • New Dashboard Features
    • Zoom into charts
    • Rich tooltips on charts
    • Move charts between dashboards

Bug Fixes

  • Charts now render correctly when the same field is mapped to multiple encoding channels.
  • Sessions automatically refresh in Microsoft Edge.
  • Prevent dashboard layout corruption when the dashboard is open in multiple browsers.
  • $count aggregations no longer count documents where the field does not exist.
  • Improved performance when loading dashboards.
  • Dates now render correctly on Scatter charts.
  • Properly parse URIs in Docker Secrets created by Windows Command Prompt.

MongoDB Charts v0.10.0

Released August 20, 2018

New Features

Bug Fixes

  • Ability to add Data Sources from databases with names containing special characters.
  • Prevent crash when entering a filter prior to choosing a Data Source in the Chart Builder.
  • Ability to use the multiple fields from an embedded array in the same chart.
  • Strip out extra quotes in MongoDB URI added by Windows echo command during install procedure.
  • Miscellaneous styling and usability improvements.

MongoDB Charts v0.9.0

Released June 27, 2018

Initial public beta release of MongoDB Charts.