Plugins 〉Business Calendar
Business Calendar
Business Calendar for Grafana
Business Calendar is a powerful Grafana plugin that transforms your data into an intuitive calendar view. Seamlessly visualize schedules, deadlines, and time-based metrics from any Grafana-supported data source.
📺 Watch Overview and Tutorial Video
🚀 Features
- Multi-Language Toolbar: Switch between Day, Week, Month, Work Week, Year, and Agenda views with ease. Navigate to today’s events or browse time ranges.
- Data Flexibility: Integrate and display events from any Grafana data source.
- Time Range Filtering: Zoom in on specific periods for focused analysis.
- Threshold Coloring: Highlight events with customizable colors using Grafana thresholds.
- Quick Links: Click events to access data links directly (bypassing sidebars).
- Annotations: Display dashboard annotations for selected time ranges.
- Localization: Available in Spanish, French, German, Portuguese, and Chinese.
📋 Requirements
- Version 4.x: Grafana 11 or Grafana 12.
- Version 3.x: Grafana 10 or Grafana 11.
- Version 2.x: Grafana 9.2 or Grafana 10.
- Version 1.x: Grafana 8.5 or Grafana 9.
🛠️ Installation
Get started with Business Calendar in just a few steps:
- Install the plugin via the Grafana Plugins Catalog or using the Grafana CLI:
grafana-cli plugins install marcusolsson-calendar-panel
- Restart Grafana to load the plugin.
- Add the Business Calendar panel to your dashboard and configure your data source.
📺 Need help with installation?
📚 Documentation
Explore comprehensive guides and resources to master the plugin:
Section | Description |
---|---|
Basic Configuration | Learn the essentials to get started. |
Configuration Options | Dive into all customization settings. |
Features | Discover key capabilities and use cases. |
Tutorials | Follow step-by-step guides for practical setups. |
Release Notes | Stay updated on new features and fixes. |
🌟 Business Suite for Grafana
Business Calendar is part of the Business Suite, a collection of open-source Grafana plugins by Volkov Labs. These plugins are crafted to address common business challenges with user-friendly interfaces, detailed documentation, and supporting video tutorials.
📜 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 Calendar 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 Calendar 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
All notable changes to the Business Calendar Panel plugin for Grafana are documented in this file.
This changelog follows the Keep a Changelog format and adheres to Semantic Versioning.
[4.1.0] - 2025-08-19
Changed
[4.0.1] - 2025-06-23
Changed
- Revert react-big-calendar version (#268).
[4.0.0] - 2025-06-04
Breaking Changes
- Now requires Grafana 10 or 11.
Changed
- Updated Multi-Day Events (#264).
- Upgraded to Grafana 12.0.1 and updated dependencies (#265).
- Fix panel crashes on switching color scheme to single color(#266).
[3.9.1] - 2025-03-18
Added
- Updated "There are no events in this range" message in the alert info component (#258).
- Adjusted Yearly view layout to prevent shifting with smaller panel sizes (#257).
- Enabled Yearly view to display events from previous years (#260).
[3.9.0] - 2025-02-20
Added
- Updated end-to-end (E2E) tests (#250).
- Upgraded to Grafana 11.5 and updated dependencies (#252).
- Enhanced release workflow to include attestation (#252).
[3.8.0] - 2024-10-25
Added
- Added multi-day event support in Yearly view (#243).
- Updated migration process for threshold color filters (#248).
- Improved
useRuntimeVariables
hook for Scenes dashboards (#247). - Upgraded to Grafana 11.3 and updated dependencies (#248).
[3.7.0] - 2024-09-15
Added
- Enhanced Yearly view to display events (#240).
- Upgraded to Grafana 11.2 and updated dependencies (#241).
[3.6.0] - 2024-08-19
Added
- Modified tooltip to prevent drawer opening when selecting text (#235).
- Updated date-time format to support multiple languages (#236).
- Hid event detail actions when no actions are available (#238).
[3.5.0] - 2024-07-25
Added
- Added event details in tooltip on hover (#217, #221).
- Introduced option to disable event time display (#223).
- Updated daily calendar view to reflect time range changes (#229).
- Reordered description fields for consistency (#230).
- Adjusted date handling to use time zone option (#227).
[3.4.0] - 2024-07-16
Added
- Improved E2E workflow using Docker (#211).
- Added font size configuration option (#213).
- Upgraded to Grafana 11.1 and updated dependencies (#214).
[3.3.0] - 2024-06-19
Added
- Enhanced variables with static datasource for time range in source dashboard (#205).
- Added support for multiple description fields (#206).
- Introduced threshold-based color options (#208).
- Added Portuguese language support in Grafana 11 (#209).
[3.2.0] - 2024-06-11
Added
- Updated tutorial video (#190).
- Added formatting options for event descriptions (#182).
- Improved details drawer layout (#192).
- Added support for additional time range sources (#179).
- Enhanced event format (#188).
- Updated time range in Agenda view (#196).
- Improved mouse cursor behavior in Agenda view (#200).
- Updated dependencies (#200).
- Added display of dashboard annotations (#194).
- Introduced Portuguese language support (#201).
- Localized toolbar and messages to the selected language (#203).
[3.1.0] - 2024-05-19
Added
- Added Agenda (List) view (#177).
- Enhanced customization for event bubbles (#178).
- Improved multi-day window handling (#183).
- Upgraded to Grafana 11 (#184).
[3.0.0] - 2024-05-02
Breaking Changes
- Renamed plugin to "Business Calendar Panel".
- Replaced Legacy Calendar with Big Calendar.
- Now requires Grafana 10 or 11.
Added
- Preserved dashboard refresh on time range changes (#167).
- Added plugin E2E tests and removed Cypress (#168, #170).
- Replaced Legacy Calendar with Big Calendar (#172).
- Prepared compatibility for Grafana 11 (#175, #176).
[2.5.0] - 2024-03-20
Added
Fixed
- Fixed display of location in Month and Work Week views (#160).
[2.4.0] - 2024-03-07
Added
- Upgraded Big Calendar to version 1.10.3 (#150).
- Added option to select date format (#151).
- Updated ESLint configuration and refactored code (#152).
- Updated dependencies and GitHub Actions (#154).
- Added option to hide end time (#155).
Fixed
- Fixed retention of calendar dates when time range is unchanged (#156).
[2.3.1] - 2023-11-06
Fixed
- Corrected import order for default Big Calendar styles and overrides (#143).
[2.3.0] - 2023-11-01
Added
- Added Yearly view (#134).
- Introduced internationalization (Spanish, French, German, Chinese) (#135, #138).
- Added default view selection option (#137).
- Enabled "scroll to time" feature in Big Calendar (#140, #141).
[2.2.0] - 2023-10-06
Added
- Added event location support in Big Calendar (#127).
- Improved contrast for event text colors (#129).
- Upgraded to Grafana 10.1.4 and Plugin Tools 2.0.2 (#132).
- Updated Grafana Access Policy for plugin signing (#132).
- Added dashboard timezone support for start and end times (#128).
- Added view selection options: Day, Week, Work Week, and Month (#133).
[2.1.0] - 2023-08-14
Added
- Added annotation type and limit options (#121).
- Upgraded to Grafana 10.0.3 (#122).
- Added language messages for Big Calendar (#123).
[2.0.1] - 2023-08-03
Fixed
- Fixed display of annotation options (#119).
[2.0.0] - 2023-07-28
Breaking Changes
- Now requires Grafana 9.2 or 10.
Added
- Increased test coverage (#105).
- Introduced Big Calendar component for rendering (#106).
- Updated ESLint configuration (#106).
- Removed support for Grafana 8.5 (#110).
- Upgraded to Grafana 10.0 (#110).
- Improved event overlap handling when start and end dates are equal in Big Calendar (#112).
- Added quick links in Big Calendar (#113).
- Updated back/next buttons for Weekly and Daily views in Big Calendar (#114).
- Enhanced button styles in Big Calendar (#115).
- Improved calendar resizing in Big Calendar (#116).
[1.4.0] - 2023-06-10
Added
- Upgraded to Grafana 9.5.2 (#96, #101).
- Added text formatting, mappings, and overrides (#97).
- Removed unused standard options (#97).
- Increased test coverage and updated testing library (#100, #103).
- Migrated to Plugin Tools 1.5.2 (#101).
- Upgraded to Node 18 (#101).
- Added E2E Cypress testing (#102).
Fixed
- Increased event spacing to prevent overflow (#96).
[1.3.0] - 2023-03-08
Added
- Upgraded to Grafana 9.4.3 (#87).
- Added label splitting for display in drawer (#88).
- Added annotation tags as labels (#88).
- Improved multi-day interval handling (#89).
- Enabled color display based on event or frame ID if color field is unspecified (#90).
- Added support for color schemes (#91).
- Added video configuration tutorial (#92).
Fixed
- Fixed scrollable content in Day drawer (#93).
[1.2.0] - 2023-02-23
Breaking Changes
- Refactoring and styles migration may introduce breaking changes. Test before upgrading in production.
Added
- Added color selection for calendar entry queries (#67).
- Filtered out undefined events (#69).
- Updated CI and release workflows (#72).
- Rebuilt using Grafana 9.3.6 (#73).
- Refactored options editors to use field pickers (#74).
- Refactored Day and Events drawer (#75).
- Removed panel padding (#75).
- Updated Day view and styles (#76).
- Migrated to Styles v2 (#79).
- Aligned week start with Grafana settings (#80).
- Skipped undefined events in drawer (#81).
- Added display time option (#82).
- Updated styles and screenshot (#83).
[1.1.0] - 2022-12-12
Breaking Changes
- Refactoring may introduce breaking changes. Test before upgrading in production.
Added
- Updated panel options in README (#53).
- Added YouTube tutorial for Calendar with JSON API datasource (#54).
- Updated CI to Node 16 and synced with release workflow (#56).
- Upgraded to Grafana 9.2.2 (#57).
- Refactored code (#58).
- Upgraded to Grafana 9.3.1 (#59).
- Updated CI to upload signed artifacts (#60).
- Refactored panel options and increased test coverage (#61).
- Added annotation support (#8).
- Removed legacy code (#62).
- Enhanced panel options with annotations (#63).
[1.0.0] - 2022-10-02
Added
- Transferred maintenance to Volkov Labs (#51).
- Updated based on Volkov Labs Panel Template (#51).
- Upgraded to Grafana 9.1.6 (#52).
[0.7.1] - 2022-08-28
Added
- Upgraded to Grafana 9.
[0.7.0] - 2022-03-09
Added
- Added quick links to follow data links on event click instead of opening a modal.
- Upgraded to Grafana 8.4.3.
[0.6.0] - 2022-01-28
Breaking Changes
- Increased minimum Grafana requirement to 8.0 due to new theming engine.
- Use v0.5.0 for Grafana versions below 8.0.
- Upgrade to v0.6.0 for Grafana 8.0 or higher.
[0.5.0] - 2021-09-06
Added
- Added data links support (#25).
- Introduced inline drawer for event details, replacing tooltips (#25).
- Note: Feedback welcome on the new design; considering a custom sidebar alternative.
[0.4.3] - 2021-06-12
Added
- Renamed "Apply time interval" to "Apply time range" to align with Grafana.
- Increased contrast for single-day events.
[0.4.2] - 2021-05-22
Fixed
- Fixed issue where
classicColors
was still undefined (#16).
[0.4.1] - 2021-05-21
Fixed
[0.4.0] - 2021-05-20
Added
- Displayed event names for events starting outside the filtered day (#13).
- Added support for more calendars and colors (#14).
- Enabled line breaks in event descriptions (#11).
[0.3.0] - 2021-05-18
Added
- Added detailed view for individual events (#10).
[0.2.0] - 2021-05-09
Added
- Added multi-day event support (#1).
- Enabled display of truncated events (#6).
- Supported string and number fields for time dimensions.
[0.1.1] - 2021-02-10
- No changes.
[0.1.0] - 2021-02-10
Added
- Initial release (not production-ready).