Menu

This is documentation for the next version of Grafana. For the latest stable release, go to the latest version.

Documentation Grafana documentation Breaking changes
Grafana Cloud Enterprise Open source

Breaking changes in Grafana

In some cases, major releases that introduce many new features also introduce breaking changes. These changes are described, along with information about what to do, in the breaking changes pages specific to each release.

For our purposes, a breaking change is any change that requires users or operators to do something. This includes:

  • Changes in one part of the system that could cause other components to fail
  • Deprecations or removal of a feature
  • Changes to an API that could break automation
  • Changes that affect some plugins or functions of Grafana
  • Migrations that can’t be rolled back

Note

To learn what’s available in a Grafana release, refer to the What’s new page for each version. For the steps we recommend when you upgrade, check out the Upgrade guide for each version.

Refer to any of the following breaking changes guides: