Plugins 〉Treemap
Treemap
Treemap for Grafana
Maintenance: Now the plugin is being maintained by Grafana Labs. Big thanks to Marcus Olsson for the awesome work!
A panel plugin for Grafana to visualize tree maps.
Configuration
This section lists the available configuration options for the Treemap panel.
Panel options
Dimensions
The dimension options determines what fields to use for each dimension of the visualization.
| Option | Description |
|---|---|
| Label by | Field to use for the text label. Defaults to the first textual field. All values must be unique. |
| Size by | Field to use for size. Defaults to the first numeric field. |
| Color by | Field to use for color. Defaults to the first numeric field. |
| Group by | Field to group by. |
| Additional labels | Fields to use as labels in the tooltip. |
Display
| Option | Description |
|---|---|
| Tiling algorithm | Determines where to make each split. |
Field options
| Option | Description |
|---|---|
| Separator | Set this value to a non-empty string to create a hierarchy as defined by the path defined by the separator. |
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 Treemap 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 Treemap 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.
Changelog
2.1.1 (2025-05-28)
- Fix an issue where the panel would not initialize for anonymous users when Grafana version was hidden
2.0.1 (2023-03-31)
- Fix broken docs and links.
- Updated dependencies
2.0.0 (2022-01-28)
This release bumps the minimum required Grafana to >=8.0. Grafana 8 introduces a new theming engine for panel plugins.
- If you're running a Grafana version before 8.0, you should stay with v1.0.0.
- If you're running Grafana 8.0 or above, you should update to v2.0.0.
1.0.0 (2021-11-19)
Enhancements
- Upgrade dependencies
0.9.3 (2021-11-04)
Bug fixes
- Fix tooltip overflow for long labels.
0.9.2 (2021-09-05)
Bug fixes
- Fix Data Links support for Grafana 8 (#24)
0.9.1 (2021-09-01)
Contains fixes for Grafana 8.
0.9.0 (2021-05-18)
Important notice: I've had to rewrite large parts of the plugins for this release. While I don't anticipate any issues with upgrading from a previous version, please backup your dashboards before upgrading.
Enhancements
- Hierarchical grouping of data (#16)
0.8.0 (2021-02-16)
Enhancements
- Add option to color by separate field
- Make dimensions clearable
- Add fallback panel for unsupported Grafana versions
- Add wizard for configuring the query
0.7.0 (2020-12-10)
Enhancements
- Support for data links: Add data links in the field options tab. Click an individual tile to reveal the links.
- Support for multiple queries: Results gets grouped by each query.
- Custom labels in tooltip: Add additional metadata in the tooltip.
- New Group by dimension: Replaces the Color dimension. You can now group data separately from the color selection.
- Add Min and Max standard option to enable control of the extents of the color scheme.
0.6.1 (2020-11-27)
Enhancements
- Updated
@grafanadependencies from^7.0.0to^7.3.0 - Improved release process using the new GitHub workflows for Grafana plugins
