Menu

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.

Enterprise Open source

Feature toggles

Grafana incorporates feature toggles which let you introduce new functionality safeguarded by control flags. This allows Grafana administrators the flexibility to determine the appropriate timing for enabling or disabling specific features. For detailed information about particular features and how they operate, refer to Configure Feature Toggles.

Manage feature toggles

In the Administration page, the Feature Management section enables authorized users to view and edit the various features that are active in their Grafana environment. Authorized users include administrators, and users with the fixed roles featuremgmt.read and featuremgmt.write.

There are different options for visibility and customization depending on the development stage of the feature.

StageVisibilityEditable
ExperimentalHiddenNo
Private previewHiddenNo
Public previewVisible*No
General availabilityVisible*Yes*
DeprecatedVisible*Yes*

Note

Options marked with an asterisk (*) are defaults for the corresponding feature stage. Each feature toggle owner can override its default behavior.

Edit feature toggles

You can only edit feature toggles if Grafana is configured with the proper feature management settings. For more information, refer to Configure feature management.

Altering the state of a toggle may require restarting your Grafana instance, which can take a few minutes.

To edit a feature toggle, follow these steps:

  1. Sign in to Grafana as a server administrator or authorized user.
  2. In the primary menu, go to Administration > General > Feature toggles.
  3. Navigate to the list of feature toggles and select your feature state overrides.
  4. Click Save changes and wait for your Grafana instance to restart with the updated feature toggles.

Note

Editing feature toggles with the feature toggle management page is available now in all tiers of Grafana Cloud.