Plugins 〉Interactive learning
Interactive learning
Interactive learning Plugin
Get help exactly when and where you need it. Interactive learning brings contextual documentation and interactive guides directly into Grafana, so you can learn and build without leaving your workflow.
What is Interactive learning?
Interactive learning is your in-app learning companion. It provides:
- Smart recommendations – Get relevant docs and guides based on what you're working on
- Interactive guides – Follow step-by-step guided learning journeys with "Show Me" and "Do It" features
- Tab-based navigation – Open multiple docs and guides in tabs, just like a browser
- Milestone tracking – See your progress through learning journeys with clear milestones
- Always available – Access help without switching windows or searching documentation sites
How to Access Interactive learning
- Look for the Help button (?) in the top navigation bar of Grafana
- Click the Help button to open the Interactive learning panel
- Browse recommended documentation based on your current context
- Click View to read a doc or Start to begin an interactive guides
Getting Started
Once you open Interactive learning:
- Review recommendations – See docs and guides tailored to what you're doing in Grafana
- Open content in tabs – Click "View" or "Start" to open content in a new tab
- Navigate guides – Use the milestone navigation at the bottom to move through learning journeys
- Try interactive features – Click "Show Me" to see where things are, or "Do It" to have Interactive learning guide you through actions
- Manage your tabs – Close tabs you're done with, or keep them open for reference
Keyboard Shortcuts
Alt + Left Arrow– Previous milestoneAlt + Right Arrow– Next milestone
For Administrators
Discovering Interactive learning
Users can find Interactive learning in multiple ways:
- Help button – Click the Help (?) button in the top navigation
- Command palette – Search for "Interactive learning", "Need help?", or "Learn Grafana" in the command palette (
Cmd+KorCtrl+K)
Configuration Options
Admins can configure Interactive learning from the plugin's configuration page in Grafana. The configuration includes three sections:
1. Configuration (Basic Settings)
- Auto-launch guide URL – Set a specific learning journey or documentation page to automatically open when Grafana starts (useful for demos and onboarding)
- Global link interception – (Experimental) When enabled, clicking documentation links anywhere in Grafana will open them in Interactive learning instead of a new tab
2. Recommendations
- Context-aware recommendations – Enable/disable recommendation service that provides personalized documentation based on your current actions in Grafana
- Data usage controls – Review what data is collected and toggle the feature on or off
3. Interactive Features
- Auto-completion detection – (Experimental) Enable automatic step completion when users perform actions themselves (without clicking "Do it" buttons)
- Timing settings – Configure timeouts for requirement checks and guided steps to optimize the guide experience
Contributing
We welcome feedback, issues, and contributions. Visit our GitHub repository to get involved.
License
See CHANGELOG.md for details on project changes and license information.
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 Interactive learning 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 Application
Use the grafana-cli tool to install Interactive learning 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. Enable it
Next, log into your Grafana instance. Navigate to the Plugins section, found in your Grafana main menu.
Click the Apps tabs in the Plugins section and select the newly installed app.
To enable the app, click the Config tab. Follow the instructions provided with the application and click Enable. The app and any new UI pages are now accessible from within the main menu, as designed by the app creator.
If dashboards have been included with the application, they will attempt to be automatically installed. To view the dashboards, re-import or delete individual dashboards, click the Dashboards tab within the app page.
Changelog
1.1.73 (2025-11-25)
Added
- Added assistant RudderStack analytics integration
- Added cancel button and cleanup for guided components
Fixed
- Applied React anti-pattern validator fixes
1.1.72 (2025-11-25)
Added
- Added support for bundled and GitHub links
Changed
- Improved WYSIWYG editor based on RichiH feedback
- Refreshed documentation to align with current architecture
Fixed
- Fixed issues with sections not rechecking requirements
- Fixed DOM selector logic in interactive engine
- Fixed formfill selectors to descend into input elements
1.1.71 (2025-11-21)
Fixed
- Hotfix for requirements in guided step
- Fixed documentation issues
1.1.70 (2025-11-21)
Added
- Added new inline assistant feature
- Added ability to open learning journeys and docs on load
- Implemented featured recommendations
Changed
- WYSIWYG cosmetic improvements
1.1.69 (2025-11-19)
Changed
- Changed requirements to be event driven rather than poll-based
1.1.68 (2025-11-18)
Added
- Added highlight feature to dev tools
- Added skip button for steps in guided mode
Changed
- Renamed "Pathfinder Tutorials" to "Pathfinder Guides" throughout
- Allows buttons to also use CSS selectors
Fixed
- Fixed issue with auto loading
- Fixed multistep validation for reftargets in WYSIWYG editor
Removed
- Removed old interactive code
- Removed dead requirements code
Chore
- Updated grafana/plugin-actions
- Updated grafana/plugin-ci-workflows/ci-cd-workflows action to v4.0.0
- Updated actions/checkout
- Updated dependency glob to v11.1.0 (security)
- Added new e2e test and updated test IDs to best practices
1.1.67 (2025-11-17)
Added
- Added WYSIWYG interactive HTML editor (initial implementation)
Fixed
- Prevent opening sidebar on onboarding
1.1.66 (2025-11-13)
Added
- Added Grafana e2e selectors
- Added collapse on complete feature
Fixed
- Fixed interactive styles
- Fixed UI theme and tab appearance
1.1.65 (2025-11-12)
Changed
- Centralized types to reduce duplication
- Refactored devtools
Fixed
- Fixed regression for guided handler
Chore
- Updated grafana/plugin-actions
- Added changelog and documentation links
1.1.64 (2025-11-11)
Added
- Added offline cloud suggestions for improved user guidance when recommendations are not available
- Implemented hand raise functionality for live sessions
Changed
- Refactored global link interception and sidebar state management
- Moved workshop and assistant into integration folder
- Moved docs rendering into separate module
- Moved DOM helpers into lib for better organization
- Updated plugin and runtime dependencies
Fixed
- Fixed deprecated lint issues
Chore
- Updated GitHub artifact actions
- Spring cleaning of Agents information
1.1.63 (2025-11-07)
Added
- Added function for quick complete for DOM changes
Changed
- Cleaned up interactive guides implementation
- Grouped requirements manager files for better organization
- Grouped security related files
Removed
- Removed plans feature
1.1.62 (2025-11-05)
Added
- Implemented live sessions functionality
Fixed
- Fixed browser storage issues
1.1.61 (2025-11-04)
Fixed
- Fixed rendering issues
1.1.60 (2025-11-04)
Fixed
- Fixed rendering issues
1.1.59 (2025-11-04)
Fixed
- Fixed rerendering issues
1.1.58 (2025-11-03)
Changed
- Improved sequence manager functionality
1.1.57 (2025-11-03)
Changed
- Updated dependencies and workflows
Fixed
- Fixed plugin update issues
1.1.56 (2025-10-31)
Added
- Added backend proxy for context engine
- Added "open sidebar by default" feature flag
Fixed
- Fixed scroll behavior
- Fixed auto launch tutorial
Changed
- Updated multiple GitHub Actions (download-artifact to v5, setup-go to v6, setup-node to v6)
- Updated Grafana plugin actions and CI/CD workflows
1.1.55 (2025-10-31)
Previous stable release
