Plugins 〉Business Variable


Developer

Volkov Labs

Sign up to receive occasional product news and updates:


Grafana Cloud
Grafana Cloud
  • Grafana, of course
  • 10k series Prometheus metrics
  • 50 GB logs
  • 50 GB traces
  • 2,232 app o11y host hours
  • ...and more
Create free account

No credit card needed, ever.


Panel
community

Business Variable

  • Overview
  • Installation
  • Change log
  • Related content

Business Variable for Grafana

Dashboard

Grafana CI E2E Codecov CodeQL

Overview

The Business Variable panel transforms how you interact with Grafana dashboard variables. Place it anywhere on your dashboard and choose from multiple layouts, including an advanced TreeView option, to simplify filtering and boost usability.

Watch: Business Variable Panel for Grafana - New Features in 3.0.0

Compatibility

  • Version 4.x: Grafana 11 or Grafana 12
  • Version 3.x: Grafana 10.3 or Grafana 11
  • Versions 1.x, 2.x: Grafana 9.2 or Grafana 10

Installation

Install the Business Variable panel easily through the Grafana Plugins Catalog or via the Grafana CLI:

grafana cli plugins install volkovlabs-variable-panel

For a step-by-step visual guide, check out our installation tutorial:
Watch: Install Business Suite Plugins in Cloud, OSS, and Enterprise

Key Features

  • Display Modes: Choose from Table, Minimize, Button, or Slider layouts.
  • TreeView: Hierarchical data visualization within Table mode.
  • Thresholds: Highlight statuses using data source thresholds.
  • Variable Support: Handle single or multi-value variables with an "All" option.
  • Filtering: Apply pattern-based or favorite-based value filtering.
  • Sticky Positioning: Panel follows scrolling for easy access.
  • Tabbed TreeViews: Organize multiple TreeViews into groups or tabs.
  • Input Box: Support for text input variables.

Documentation

Explore detailed guides and resources for the Business Variable panel:

SectionDescription
Data FlowUnderstand the panel’s data flow
Display ModesExplore layout customization options
FeaturesLearn about key capabilities
TutorialsFollow step-by-step guides
Release NotesStay updated with recent changes

Business Suite for Grafana

The Business Variable panel is a component of the Business Suite, a set of open-source plugins by Volkov Labs. These plugins address common business needs with user-friendly interfaces, backed by extensive documentation, examples, and video tutorials.

Explore the Business Suite

Enterprise Support

Opt for Business Suite Enterprise to access premium support:

  • Dedicated support via Zendesk
  • Priority handling for feature requests and bug fixes
  • In-person consultations
  • Access to a Business Intelligence platform

Community & Feedback

We value your input! Connect with us and share your thoughts:

License

This project is licensed under the Apache License 2.0. See the LICENSE file for details.

Installing Business Variable on Grafana Cloud:

For more information, visit the docs on plugin installation.

Installing on a local Grafana:

For local instances, plugins are installed and updated via a simple CLI command. Plugins are not updated automatically, however you will be notified when updates are available right within your Grafana.

1. Install the Panel

Use the grafana-cli tool to install Business Variable from the commandline:

grafana-cli plugins install 

The plugin will be installed into your grafana plugins directory; the default is /var/lib/grafana/plugins. More information on the cli tool.

2. Add the Panel to a Dashboard

Installed panels are available immediately in the Dashboards section in your Grafana main menu, and can be added like any other core panel in Grafana.

To see a list of installed panels, click the Plugins item in the main menu. Both core panels and installed panels will appear.

Change Log

All notable changes to the Business Variable Panel for Grafana are documented in this file. This panel provides advanced variable management and visualization capabilities for Grafana dashboards.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[4.0.0] - 2025-06-03

Summary: Major update with Grafana 12 compatibility and new filtering features.

Breaking Changes

  • Requires Grafana 11 or Grafana 12.

Added

  • Show selected values filter and selected range (#269).

Changed

  • Upgraded to Grafana 12.0.1 with updated dependencies (#271).

[3.9.0] - 2025-04-08

Summary: Enhanced user experience with custom messages and minimized views.

Added

  • Custom message for 'no data' and 'variable not selected' cases (#262).
  • Minimized view for Tree View layout (#263).

Changed

  • Upgraded to Grafana 11.6.0 with updated dependencies (#265).

[3.8.0] - 2025-03-26

Summary: Workflow improvements and dependency cleanup.

Added

  • Attestation to release workflow (#246).
  • Resize behavior for panels with sticky headers (#253).

Removed

  • Dependency on @volkovlabs/grafana-utils (#247).

[3.7.0] - 2025-02-13

Added

  • Date Picker component (#237)
  • Advanced option to modify browser tab title (#243)

Changed

  • Updated to use datasource ID instead of name, with variable support (#229)
  • Enhanced sticky header for Scenes dashboards (#230)
  • Improved favorites icon visibility (#234)
  • Upgraded to Grafana 11.4.0 with updated dependencies (#241)

Removed

  • Alert Message variable type from support (#235)

[3.6.0] - 2024-10-24

Added

  • Date Time Selector (#209)
  • "All" option in Scenes dashboards (#213)

Changed

  • Refined Textbox variable behavior in Table view (#211)
  • Updated E2E tests (#216)
  • Improved sticky positioning in Scenes dashboards (#221)
  • Upgraded to Grafana 11.3.0 with dependency updates (#222)

Fixed

  • Display errors in Slider view (#220)

[3.5.0] - 2024-10-02

Changed

  • Improved variable selection in Minimize view (#197)
  • Updated @tanstack/virtual to the latest version (#207)
  • Upgraded to Grafana 11.2.2 with dependency updates (#207)

[3.4.0] - 2024-08-23

Added

  • Option to reorder tabs in panel settings (#193)

Changed

  • Updated local storage key for favorites (#194)
  • Upgraded to Grafana 11.1.4 (#195)

[3.3.0] - 2024-08-14

Added

  • Scrollbar to Button view (#187)

Changed

  • Integrated datasource-driven favorites (#184)
  • Enhanced documentation (#185)

[3.2.0] - 2024-07-09

Added

  • Image threshold styling for status in Table view (#170)

Changed

  • Updated video tutorial (#166)
  • Improved E2E workflow with Docker (#173)

[3.1.0] - 2024-06-06

Added

  • Option to collapse/expand rows on load (#159)
  • Reset button to Button view (#162)

Changed

  • Updated selection behavior with Ctrl key (#160)
  • Upgraded to Grafana 11.0.0 with dependency updates (#161)
  • Enhanced key/value pair selection for variables (#165)

[3.0.0] - 2024-05-09

Breaking Changes

  • Requires Grafana 10 or Grafana 11

Added

  • Option to show/hide Minimize label (#144)
  • Maximum visible values in Minimize view (#147)
  • Plugin E2E tests, removed Cypress (#149)
  • Row count in Table view (#148)
  • Slider view (#154)

Changed

  • Improved multi-level selection/deselection (#139)
  • Updated Minimize label width to Auto/Static (#144)
  • Enhanced autoscroll behavior (#152)
  • Prepared for Grafana 11 compatibility (#155)
  • Upgraded to Grafana 10.4.2 with dependency updates (#158)

[2.5.0] - 2024-04-01

Added

  • Indeterminate checkbox state (#127)
  • Responsive tabs (#130)

Changed

  • Improved Tree View scrolling (#128)
  • Supported new items in Minimize mode (#134)
  • Preserved group selection across dashboards (#135)
  • Enhanced Tree View display and scrolling (#136)
  • Added reset for dependent variables on value selection (#138)

[2.4.0] - 2024-03-17

Breaking Changes

  • Requires Grafana 9.2 or Grafana 10

Added

  • Preserve selected group option (#124)
  • Label support in Button view (#125)

Changed

  • Updated README video tutorial (#111)
  • Enhanced Timescale data handling (#119)
  • Updated dependencies and GitHub Actions (#120)
  • Improved default color contrast (#122)

[2.3.1] - 2023-12-14

Fixed

  • Draggable icon for Grafana 10.3 (#107)

[2.3.0] - 2023-12-13

Added

  • Persistent mode (#103)

Changed

  • Cleared table state on tab change (#101)
  • Updated ESLint config and refactored code (#102)
  • Upgraded to Grafana 10.2.2 with Volkov Labs package updates (#104)

[2.2.0] - 2023-11-20

Added

  • Dashboard redirect option (#92)
  • Clear filter value button (#99)

Changed

  • Updated ESLint config and sorted imports (#93)
  • Improved Safari layout for favorites (#97)
  • Upgraded to Grafana 10.2.1 (#98)

[2.1.0] - 2023-11-08

Added

  • Always-visible search filter option (#83)
  • Group rename functionality (#84)
  • Toggle for expanded row state via label click (#86)

Changed

  • Supported field selection from data frames without RefId (#85)

Fixed

  • Deselection of undefined "All" variable in URL (#87)
  • Removed group favoriting capability (#88)

[2.0.0] - 2023-10-16

Added

  • Enter/Escape key handling for Text Variable (#69)
  • Clear value for multi-choice variables (#66)

Changed

  • Updated parent item labels in Tree View (#62)
  • Implemented table virtualization for performance (#64, #74)
  • Upgraded to Plugin Tools 2.1.1 (#72)
  • Signed plugin with Grafana Access Policy (#72)
  • Upgraded to Grafana 10.1.5 (#73)

Fixed

  • Key:value option selection in Minimize/Button views (#75)

[1.7.0] - 2023-08-08

Added

  • Text/value variables in Table/Tree View (#57)
  • Button View (#59)
  • Group selection (#58)

Changed

  • Upgraded to Grafana 10.0.3 (#60)

[1.6.0] - 2023-07-26

Added

  • Status sort button (#49, #51)
  • Minimize mode for Query/Custom variables (#50)
  • Input for Textbox variable (#53)

Changed

  • Updated ESLint configuration (#47)

[1.5.0] - 2023-07-11

Added

  • Sticky header and autoscroll for multi-group selection (#38)
  • Drag-and-drop for groups (#42)
  • Expand/collapse all in header (#46)

Changed

  • Enhanced single-select variables with "All" option (#41)

[1.4.0] - 2023-07-06

Added

  • Tutorial (#21)
  • Favorite filter icon (#25)
  • Tree View groups (requires config update) (#20)
  • Option to prefix variable name to value (#30)
  • Autoscroll to selected value (#32)
  • Released as community-signed plugin (#37)

Changed

  • Updated level addition to append at end (#22)
  • Hid unselectable items (#24)
  • Supported Grafana 9 with main view scroll (#26)
  • Increased test coverage (#31)

[1.3.0] - 2023-06-30

Added

  • Display Header option (#15)
  • Collapsing parent rows (#16)
  • Sticky scrolling option (#17)
  • Table Filter (#18)
  • Favorite selection (#19)

Changed

  • Updated documentation (#20)

[1.2.0] - 2023-06-26

Added

Changed

  • Updated README and screenshot (#14)

[1.1.0] - 2023-06-21

Added

  • Variable statuses via thresholds (#6)
  • Field options for values/statuses (#9)

Changed

  • Replaced Table with react-table v8 (#8)
  • Updated provisioning and README (#10)
  • Supported Grafana 8.5.0 (#11)

[1.0.0] - 2023-06-19

Added

  • Initial release based on Volkov Labs Panel template

Changed

  • Updated README and configuration (#1)
  • Refactored legacy code (#2, #4)
  • Upgraded to Grafana 10.0.0 (#3)
  • Updated provisioning and README (#5)