Documentation for automated readers
A curated documentation index is available at: https://grafana.com/llms.txt
A complete documentation index is available at: https://grafana.com/llms-full.txt
These indexes can help with page discovery before fetching individual documents.
This page is also available in Markdown, which may be easier for automated readers and AI tools to parse than HTML. The Markdown version is available at https://grafana.com/docs/grafana/v9.0/alerting/migrating-alerts/opt-out.md, or by sending Accept: text/markdown to https://grafana.com/docs/grafana/v9.0/alerting/migrating-alerts/opt-out/. For broader documentation discovery, the curated index is available at https://grafana.com/llms.txt and the complete index is available at https://grafana.com/llms-full.txt.
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.
Opt out of Grafana Alerting
You can opt out of Grafana Alerting at any time and switch to using legacy alerting. Alternatively, you can opt out of using alerting in its entirety.
Staying on legacy alerting
When upgrading to Grafana > 9.0, existing installations that use legacy alerting are automatically upgraded to Grafana Alerting unless you have opted-out of Grafana Alerting before migration takes place. During the upgrade, legacy alerts are migrated to the new alerts type and no alerts or alerting data are lost. To keep using legacy alerting and disable Grafana Alerting:
- Go to your custom configuration file ($WORKING_DIR/conf/custom.ini).
- Enter the following in your configuration:
[alerting]
enabled = true
[unified_alerting]
enabled = falseInstallations that have been migrated to Grafana Alerting can roll back to legacy alerting at any time.
Note: This topic is only relevant for OSS and Enterprise customers. Contact customer support to enable or disable Grafana Alerting for your Grafana Cloud stack.
The ngalert toggle previously used to enable or disable Grafana Alerting is no longer available.
Disable alerting
You can disable both Grafana Alerting and legacy alerting in Grafana.
- Go to your custom configuration file ($WORKING_DIR/conf/custom.ini).
- Enter the following in your configuration:
[alerting]
enabled = false
[unified_alerting]
enabled = false- Restart Grafana for the configuration changes to take effect.
If you want to turn alerting back on, you can remove both flags to enable Grafana Alerting.
Was this page helpful?
Related resources from Grafana Labs


