Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Grafana Cloud Enterprise Open source RSS

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


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: