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.

Stage Visibility Editable

Experimental

Hidden

No

Private preview

Hidden

No

Public preview

Visible*

No

General availability

Visible*

Yes*

Deprecated

Visible*

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.