Folders

Folders are great way to group your Dashboards and a requirement to for AlertRuleGroups.

Resources like GrafanaDashboards and GrafanaAlertRuleGroups can reference folders using .spec.folderUID. Which is useful when folders are managed through other means than the operator.

But creating a GrafanaFolder allows other CRs to use .spec.folderRef which enables named references.

To view all configuration options for Folders, look at our API documentation .

apiVersion: grafana.integreatly.org/v1beta1
kind: GrafanaFolder
metadata:
  name: test-folder
spec:
  instanceSelector:
    matchLabels:
      dashboards: "grafana"
  # If title is not defined, the value will be taken from metadata.name
  title: custom title
Last modified October 20, 2026: chore(go): bump to 1.27.3 (#3017) (8227aa9)