Menu

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

Enterprise Open source

Configure feature toggles

You use feature toggles, also known as feature flags, to enable or disable features in Grafana. You can turn on feature toggles to try out new functionality in development or test environments.

This page contains a list of available feature toggles. To learn how to turn on feature toggles, refer to our Configure Grafana documentation. Feature toggles are also available to Grafana Cloud Advanced customers. If you use Grafana Cloud Advanced, you can open a support ticket and specify the feature toggles and stack for which you want them enabled.

For more information about feature release stages, refer to Release life cycle for Grafana Labs and Manage feature toggles.

General availability feature toggles

Most generally available features are enabled by default. You can disable these feature by setting the feature flag to “false” in the configuration.

Feature toggle nameDescriptionEnabled by default
disableEnvelopeEncryptionDisable envelope encryption (emergency only)
publicDashboards[Deprecated] Public dashboards are now enabled by default; to disable them, use the configuration setting. This feature toggle will be removed in the next major version.Yes
publicDashboardsSceneEnables public dashboard rendering using scenesYes
featureHighlightsHighlight Grafana Enterprise features
correlationsCorrelations pageYes
autoMigrateXYChartPanelMigrate old XYChart panel to new XYChart2 modelYes
cloudWatchCrossAccountQueryingEnables cross-account querying in CloudWatch datasourcesYes
accessControlOnCallAccess control primitives for OnCallYes
nestedFoldersEnable folder nestingYes
logsContextDatasourceUiAllow datasource to provide custom UI for context viewYes
lokiQuerySplittingSplit large interval queries into subqueries with smaller time intervalsYes
prometheusMetricEncyclopediaAdds the metrics explorer component to the Prometheus query builder as an option in metric selectYes
influxdbBackendMigrationQuery InfluxDB InfluxQL without the proxyYes
lokiMetricDataplaneChanges metric responses from Loki to be compliant with the dataplane specification.Yes
dataplaneFrontendFallbackSupport dataplane contract field name change for transformations and field name matchers where the name is differentYes
recordedQueriesMultiEnables writing multiple items from a single query within Recorded QueriesYes
logsExploreTableVisualisationA table visualisation for logs in ExploreYes
transformationsRedesignEnables the transformations redesignYes
traceQLStreamingEnables response streaming of TraceQL queries of the Tempo data source
awsAsyncQueryCachingEnable caching for async queries for Redshift and Athena. Requires that the datasource has caching and async query support enabledYes
prometheusConfigOverhaulAuthUpdate the Prometheus configuration page with the new auth componentYes
alertingNoDataErrorExecutionChanges how Alerting state manager handles execution of NoData/ErrorYes
angularDeprecationUIDisplay Angular warnings in dashboards and panelsYes
dashgptEnable AI powered features in dashboardsYes
alertingInsightsShow the new alerting insights landing pageYes
panelMonitoringEnables panel monitoring through logs and measurementsYes
formatStringEnable format string transformerYes
transformationsVariableSupportAllows using variables in transformationsYes
kubernetesPlaylistsUse the kubernetes API in the frontend for playlists, and route /api/playlist requests to k8sYes
recoveryThresholdEnables feature recovery threshold (aka hysteresis) for threshold server-side expressionYes
lokiStructuredMetadataEnables the loki data source to request structured metadata from the Loki serverYes
managedPluginsInstallInstall managed plugins directly from plugins catalogYes
addFieldFromCalculationStatFunctionsAdd cumulative and window functions to the add field from calculation transformationYes
annotationPermissionUpdateChange the way annotation permissions work by scoping them to folders and dashboards.Yes
dashboardSceneForViewersEnables dashboard rendering using Scenes for viewer rolesYes
dashboardSceneSoloEnables rendering dashboards using scenes for solo panelsYes
dashboardSceneEnables dashboard rendering using scenes for all rolesYes
ssoSettingsApiEnables the SSO settings API and the OAuth configuration UIs in GrafanaYes
logsInfiniteScrollingEnables infinite scrolling for the Logs panel in Explore and DashboardsYes
exploreMetricsEnables the new Explore Metrics core appYes
alertingSimplifiedRoutingEnables users to easily configure alert notifications by specifying a contact point directly when editing or creating an alert ruleYes
logRowsPopoverMenuEnable filtering menu displayed when text of a log line is selectedYes
lokiQueryHintsEnables query hints for LokiYes
alertingQueryOptimizationOptimizes eligible queries in order to reduce load on datasources
promQLScopeIn-development feature that will allow injection of labels into prometheus queries.Yes
groupToNestedTableTransformationEnables the group to nested table transformationYes
tlsMemcachedUse TLS-enabled memcached in the enterprise caching featureYes
cloudWatchNewLabelParsingUpdates CloudWatch label parsing to be more accurateYes
newDashboardSharingComponentEnables the new sharing drawer design
notificationBannerEnables the notification banner UI and APIYes
pluginProxyPreserveTrailingSlashPreserve plugin proxy trailing slash.
pinNavItemsEnables pinning of nav itemsYes
openSearchBackendFlowEnabledEnables the backend query flow for Open Search datasource pluginYes
cloudWatchRoundUpEndTimeRound up end time for metric queries to the next minute to avoid missing dataYes
cloudwatchMetricInsightsCrossAccountEnables cross account observability for Cloudwatch Metric Insights query builderYes
azureMonitorDisableLogLimitDisables the log limit restriction for Azure Monitor when true. The limit is enabled by default.

Public preview feature toggles

Public preview features are supported by our Support teams, but might be limited to enablement, configuration, and some troubleshooting.

Feature toggle nameDescription
panelTitleSearchSearch for dashboards using panel title
autoMigrateOldPanelsMigrate old angular panels to supported versions (graph, table-old, worldmap, etc)
autoMigrateGraphPanelMigrate old graph panel to supported time series panel - broken out from autoMigrateOldPanels to enable granular tracking
autoMigrateTablePanelMigrate old table panel to supported table panel - broken out from autoMigrateOldPanels to enable granular tracking
autoMigratePiechartPanelMigrate old piechart panel to supported piechart panel - broken out from autoMigrateOldPanels to enable granular tracking
autoMigrateWorldmapPanelMigrate old worldmap panel to supported geomap panel - broken out from autoMigrateOldPanels to enable granular tracking
autoMigrateStatPanelMigrate old stat panel to supported stat panel - broken out from autoMigrateOldPanels to enable granular tracking
disableAngularDynamic flag to disable angular at runtime. The preferred method is to set angular_support_enabled to false in the [security] settings, which allows you to change the state at runtime.
grpcServerRun the GRPC server
alertingNoNormalStateStop maintaining state of alerts that are not firing
renderAuthJWTUses JWT-based auth for rendering instead of relying on remote cache
refactorVariablesTimeRangeRefactor time range variables flow to reduce number of API calls made when query variables are chained
faroDatasourceSelectorEnable the data source selector within the Frontend Apps section of the Frontend Observability
enableDatagridEditingEnables the edit functionality in the datagrid panel
sqlDatasourceDatabaseSelectionEnables previous SQL data source dataset dropdown behavior
reportingRetriesEnables rendering retries for the reporting feature
externalServiceAccountsAutomatic service account and token setup for plugins
cloudWatchBatchQueriesRuns CloudWatch metrics queries as separate batches
teamHttpHeadersEnables LBAC for datasources to apply LogQL filtering of logs to the client requests for users in teams
pdfTablesEnables generating table data as PDF in reporting
canvasPanelPanZoomAllow pan and zoom in canvas panel
regressionTransformationEnables regression analysis transformation
onPremToCloudMigrationsEnable the Grafana Migration Assistant, which helps you easily migrate on-prem dashboards, folders, and data source configurations to your Grafana Cloud stack.
newPDFRenderingNew implementation for the dashboard-to-PDF rendering
ssoSettingsSAMLUse the new SSO Settings API to configure the SAML connector
accessActionSetsIntroduces action sets for resource permissions. Also ensures that all folder editors and admins can create subfolders without needing any additional permissions.
azureMonitorPrometheusExemplarsAllows configuration of Azure Monitor as a data source that can provide Prometheus exemplars
ssoSettingsLDAPUse the new SSO Settings API to configure LDAP
useSessionStorageForRedirectionUse session storage for handling the redirection after login

Experimental feature toggles

Experimental features are early in their development lifecycle and so are not yet supported in Grafana Cloud. Experimental features might be changed or removed without prior notice.

Feature toggle nameDescription
live-service-web-workerThis will use a webworker thread to processes events rather than the main thread
queryOverLiveUse Grafana Live WebSocket to execute backend queries
lokiExperimentalStreamingSupport new streaming approach for loki (prototype, needs special loki build)
storageConfigurable storage for dashboards, datasources, and resources
canvasPanelNestingAllow elements nesting
vizActionsAllow actions in visualizations
disableSecretsCompatibilityDisable duplicated secret storage in legacy tables
logRequestsInstrumentedAsUnknownLogs the path for requests that are instrumented as unknown
showDashboardValidationWarningsShow warnings when dashboards do not validate against the schema
mysqlAnsiQuotesUse double quotes to escape keyword in a MySQL query
mysqlParseTimeEnsure the parseTime flag is set for MySQL driver
alertingBacktestingRule backtesting API for alerting
editPanelCSVDragAndDropEnables drag and drop for CSV and Excel files
lokiShardSplittingUse stream shards to split queries into smaller subqueries
lokiQuerySplittingConfigGive users the option to configure split durations for Loki queries
individualCookiePreferencesSupport overriding cookie preferences per user
influxqlStreamingParserEnable streaming JSON parser for InfluxDB datasource InfluxQL query language
lokiLogsDataplaneChanges logs responses from Loki to be compliant with the dataplane specification.
disableSSEDataplaneDisables dataplane specific processing in server side expressions.
alertStateHistoryLokiSecondaryEnable Grafana to write alert state history to an external Loki instance in addition to Grafana annotations.
alertStateHistoryLokiPrimaryEnable a remote Loki instance as the primary source for state history reads.
alertStateHistoryLokiOnlyDisable Grafana alerts from emitting annotations when a remote Loki instance is available.
unifiedRequestLogWrites error logs to the request logger
extraThemesEnables extra themes
lokiPredefinedOperationsAdds predefined query operations to Loki query editor
pluginsFrontendSandboxEnables the plugins frontend sandbox
frontendSandboxMonitorOnlyEnables monitor only in the plugin frontend sandbox (if enabled)
pluginsDetailsRightPanelEnables right panel for the plugins details page
awsDatasourcesTempCredentialsSupport temporary security credentials in AWS plugins for Grafana Cloud customers
mlExpressionsEnable support for Machine Learning in server-side expressions
metricsSummaryEnables metrics summary queries in the Tempo data source
datasourceAPIServersExpose some datasources as apiservers.
permissionsFilterRemoveSubqueryAlternative permission filter implementation that does not use subqueries for fetching the dashboard folder
aiGeneratedDashboardChangesEnable AI powered features for dashboards to auto-summary changes when saving
sseGroupByDatasourceSend query to the same datasource in a single request when using server side expressions. The cloudWatchBatchQueries feature toggle should be enabled if this used with CloudWatch.
libraryPanelRBACEnables RBAC support for library panels
wargamesTestingPlaceholder feature flag for internal testing
externalCorePluginsAllow core plugins to be loaded as external
pluginsAPIMetricsSends metrics of public grafana packages usage by plugins
enableNativeHTTPHistogramEnables native HTTP Histograms
disableClassicHTTPHistogramDisables classic HTTP Histogram (use with enableNativeHTTPHistogram)
kubernetesSnapshotsRoutes snapshot requests from /api to the /apis endpoint
kubernetesDashboardsUse the kubernetes API in the frontend for dashboards
kubernetesDashboardsAPIUse the kubernetes API in the backend for dashboards
kubernetesFoldersUse the kubernetes API in the frontend for folders, and route /api/folders requests to k8s
grafanaAPIServerTestingWithExperimentalAPIsFacilitate integration testing of experimental APIs
datasourceQueryTypesShow query type endpoints in datasource API servers (currently hardcoded for testdata, expressions, and prometheus)
queryServiceRegister /apis/query.grafana.app/ – will eventually replace /api/ds/query
queryServiceRewriteRewrite requests targeting /ds/query to the query service
queryServiceFromUIRoutes requests to the new query service
cachingOptimizeSerializationMemoryUsageIf enabled, the caching backend gradually serializes query responses for the cache, comparing against the configured [caching]max_value_mb value as it goes. This can can help prevent Grafana from running out of memory while attempting to cache very large query responses.
prometheusPromQAILPrometheus and AI/ML to assist users in creating a query
prometheusCodeModeMetricNamesSearchEnables search for metric names in Code Mode, to improve performance when working with an enormous number of metric names
alertmanagerRemoteSecondaryEnable Grafana to sync configuration and state with a remote Alertmanager.
alertmanagerRemotePrimaryEnable Grafana to have a remote Alertmanager instance as the primary Alertmanager.
alertmanagerRemoteOnlyDisable the internal Alertmanager and only use the external one defined.
extractFieldsNameDeduplicationMake sure extracted field names are unique in the dataframe
dashboardNewLayoutsEnables experimental new dashboard layouts
pluginsSkipHostEnvVarsDisables passing host environment variable to plugin processes
tableSharedCrosshairEnables shared crosshair in table panel
kubernetesFeatureTogglesUse the kubernetes API for feature toggle management in the frontend
newFolderPickerEnables the nested folder picker without having nested folders enabled
onPremToCloudMigrationsAlertsEnables the migration of alerts and its child resources to your Grafana Cloud stack. Requires onPremToCloudMigrations to be enabled in conjunction.
sqlExpressionsEnables using SQL and DuckDB functions as Expressions.
nodeGraphDotLayoutChanged the layout algorithm for the node graph
kubernetesAggregatorEnable grafana’s embedded kube-aggregator
expressionParserEnable new expression parser
disableNumericMetricsSortingInExpressionsIn server-side expressions, disable the sorting of numeric-kind metrics by their metric name or labels.
queryLibraryEnables Query Library feature in Explore
logsExploreTableDefaultVisualizationSets the logs table as default visualisation in logs explore
alertingListViewV2Enables the new alert list view design
dashboardRestoreEnables deleted dashboard restore feature
alertingCentralAlertHistoryEnables the new central alert history.
sqlQuerybuilderFunctionParametersEnables SQL query builder function parameters
failWrongDSUIDThrows an error if a datasource has an invalid UIDs
alertingApiServerRegister Alerting APIs with the K8s API server
dataplaneAggregatorEnable grafana dataplane aggregator
newFiltersUIEnables new combobox style UI for the Ad hoc filters variable in scenes architecture
lokiSendDashboardPanelNamesSend dashboard and panel names to Loki when querying
alertingPrometheusRulesPrimaryUses Prometheus rules as the primary source of truth for ruler-enabled data sources
singleTopNavUnifies the top search bar and breadcrumb bar into one
exploreLogsShardSplittingUsed in Explore Logs to split queries into multiple queries based on the number of shards
exploreLogsAggregatedMetricsUsed in Explore Logs to query by aggregated metrics
exploreLogsLimitedTimeRangeUsed in Explore Logs to limit the time range
homeSetupGuideUsed in Home for users who want to return to the onboarding flow or quickly find popular config pages
appSidecarEnable the app sidecar feature that allows rendering 2 apps at the same time
alertingQueryAndExpressionsStepModeEnables step mode for alerting queries and expressions
rolePickerDrawerEnables the new role picker drawer design
pluginsSriChecksEnables SRI checks for plugin assets
unifiedStorageBigObjectsSupportEnables to save big objects in blob storage
timeRangeProviderEnables time pickers sync
prometheusUsesComboboxUse new combobox component for Prometheus query editor
dashboardSchemaV2Enables the new dashboard schema version 2, implementing changes necessary for dynamic dashboards and dashboards as code.
playlistsWatcherEnables experimental watcher for playlists
enableExtensionsAdminPageEnables the extension admin page regardless of development mode

Development feature toggles

The following toggles require explicitly setting Grafana’s app mode to ‘development’ before you can enable this feature toggle. These features tend to be experimental.

Feature toggle nameDescription
grafanaAPIServerWithExperimentalAPIsRegister experimental APIs with the k8s API server, including all datasources
grafanaAPIServerEnsureKubectlAccessStart an additional https handler and write kubectl options
panelTitleSearchInV1Enable searching for dashboards using panel title in search v1