Plugins 〉Business Variable
Business Variable
Business Variable for Grafana
This project was originally contributed by Volkov Labs - thanks for all your great work!
We have republished under the same plugin ID, keeping the community signature. This means you can simply update your plugin version. A new ID would have required manual updates to your dashboards. For additional information on the changes, see the Notices.
This project is currently maintained by Grafana Labs. We welcome pull requests and will review them on a best-effort basis. If you're interested in taking on this project long-term, contact integrations@grafana.com. We're eager to work with new maintainers and eventually hand over the project.
Business Variable 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.
🚀 Key Features
- Display Modes: Choose from Table, Minimize, Button, or Slider layouts.
- TreeView: Hierarchical data visualization within Table mode for complex nested variables.
- Thresholds: Highlight statuses using data source thresholds for visual clarity.
- Variable Support: Handle single or multi-value variables with an "All" option.
- Filtering: Apply pattern-based or favorite-based value filtering to quickly find options.
- Sticky Positioning: Panel follows scrolling for easy access across long dashboards.
- Tabbed TreeViews: Organize multiple TreeViews into groups or tabs for better organization.
- Input Box: Support for text input variables with custom validation.
- Responsive Design: Adapts seamlessly to different screen sizes and panel dimensions.
- Theming: Fully compatible with Grafana's light and dark themes.
📋 Requirements
| Plugin Version | Compatible Grafana Versions |
|---|---|
| Business Variable 5.x | Grafana 11.5 or 12 |
| Business Variable 4.x | Grafana 11 or 12 |
| Business Variable 3.x | Grafana 10.3 or 11 |
| Business Variable 1.x/2.x | Grafana 9.2 or 10 |
🛠️ Installation
Install the Business Variable panel through the Grafana Plugins Catalog or using the Grafana CLI:
grafana-cli plugins install volkovlabs-variable-panel
After installation, restart Grafana and add the Business Variable panel to your dashboard.
📚 Documentation
Dive into detailed guides to make the most of Business Variable:
| Section | Description |
|---|---|
| Data Flow | Understand the panel's data flow |
| Display Modes | Explore layout customization options |
| Features | Learn about key capabilities |
| Tutorials | Follow step-by-step guides |
| Release Notes | Stay updated with recent changes |
📜 License
This project is licensed under the Apache License 2.0.
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Grafana Cloud Free
- Free tier: Limited to 3 users
- Paid plans: $55 / user / month above included usage
- Access to all Enterprise Plugins
- Fully managed service (not available to self-manage)
Self-hosted Grafana Enterprise
- Access to all Enterprise plugins
- All Grafana Enterprise features
- Self-manage on your own infrastructure
Installing Business Variable on Grafana Cloud:
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
Note that it could take up to 1 minute to see the plugin show up in your Grafana.
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.
Alternatively, you can manually download the .zip file for your architecture below and unpack it into your grafana plugins directory.
Alternatively, you can manually download the .zip file and unpack it into your grafana plugins directory.
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.
[5.1.0] - 2025-10-29
Project Updates
- Grafana Labs fork.
[5.0.0] - 2025-09-29
Breaking Changes
- Requires the Scenes framework in Grafana 11.5 or Grafana 12.
Added
- Added display tree view in the dock menu (#291).
- Added group listbox instead of tabs with a 3-dot menu to expand (#294).
Changed
- Updated minimum Grafana version to 11.5.0 (#292).
- Updated panel in docked menu on window resize (#293).
[4.2.0] - 2025-08-31
Changed
[4.1.0] - 2025-07-29
Overview
This release introduces new features and enhancements to improve user experience and functionality in the Business Variable plugin. Key additions include pinning group filters, custom icons for minimized panels, and new options for latency requests and tree view. Alongside these, we've made important updates to dependencies and configurations.
Added
- Pin/Unpin Group Filters: Added the ability to pin or unpin group filters for better customization and usability (#274).
- Custom Icons for Minimized Panels: Introduced the option to select native or custom icons for minimized variable panels (#281).
- Latency Request Option: Added a new option to configure latency requests for improved performance tuning (#283).
- Tree View Values Wrap: Implemented wrapping options for values in Tree View to enhance readability (#285).
Changed
- Updated
useDatasourceRequestHook: Improved theuseDatasourceRequesthook by integrating updates from related packages (#282). - Updated ESLint Configuration: Revised ESLint settings to ensure better code quality and consistency (#286).
[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
Removed
- Dependency on
@volkovlabs/grafana-utils(#247).
[3.7.0] - 2025-02-13
Added
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
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/virtualto 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
[3.3.0] - 2024-08-14
Added
- Scrollbar to Button view (#187)
Changed
[3.2.0] - 2024-07-09
Added
- Image threshold styling for status in Table view (#170)
Changed
[3.1.0] - 2024-06-06
Added
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
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
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
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
[2.0.0] - 2023-10-16
Added
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
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
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




