This is documentation for the next version of Grafana documentation. For the latest stable release, go to the latest version.

Documentationbreadcrumb arrow Grafana documentationbreadcrumb arrow Visualize databreadcrumb arrow Panels and visualizationsbreadcrumb arrow Visualizationsbreadcrumb arrow News
Grafana Cloud Enterprise Open source

News

The news visualization displays an RSS feed. By default, it displays articles from the Grafana Labs blog, but you can change this by entering a different RSS feed URL.

A news visualization showing the latest Grafana news feed

Note

In version 8.5, we discontinued the “Use Proxy” option for Grafana news visualizations. As a result, RSS feeds that are not configured for request by Grafana’s frontend (with the appropriate CORS headers) may not load.

You can use the news visualization to provide regular news and updates to your users.

Give it a try using Grafana Play
Give it a try using Grafana Play

With Grafana Play, you can explore and see how it works, learning from practical examples to accelerate your development. This feature can be seen on News Panel.

Try it

Refresh the news feed

The news visualization doesn’t have its own refresh interval. It requests the feed when the dashboard first loads and each time the dashboard refreshes.

To update the articles, do one of the following:

  • Refresh the dashboard manually: Click the Refresh dashboard icon.
  • Set an auto-refresh interval: Click the drop-down next to the Refresh dashboard icon and select an interval. For more information on setting these intervals, refer to Refresh dashboard.

The refresh interval applies to the whole dashboard, so pick one that suits your other visualizations as well as your feed.

Configure a news visualization

After you’ve created a dashboard, enter the URL of an RSS in the URL field in the News section. This visualization type doesn’t accept any other queries, and you shouldn’t expect to be able to filter or query the RSS feed data in any way using this visualization.

If you’re having trouble loading an RSS feed, you can try re-hosting the feed on a different server or using a CORS proxy. A CORS proxy is a tool that allows you to bypass CORS restrictions by making requests to the RSS feed on your behalf. You can find more information about using CORS proxies online.

If you’re unable to display an RSS feed using the news visualization, you can try using the community RSS/Atom data source plugin RSS/Atom data source in combination with the Dynamic text community panel Dynamic text. This allows you to display the RSS feed in a different way.

Supported data formats

The news visualization supports RSS and Atom feeds.

Configuration options

The following section describes the configuration options available in the panel editor pane for this visualization. These options are, as much as possible, ordered as they appear in Grafana.

Panel options

In the Panel options section of the panel editor pane, set options like the panel title, description, and show/hide rules. To learn more, refer to Configure panel options.

OptionDescription
TitleText entered in this field appears at the top of your panel in the panel editor and in the dashboard. You can use variables you have defined or global variables.
DescriptionAdd a description to a panel to share with users any important information about it, such as its purpose. Text entered in this field appears in a tooltip in the upper-left corner of the panel. Conversely, toggle on the Use as subtitle switch to display the description just below the panel title instead. You can use variables you have defined or dashboard-scoped global variables (such as $__from, $__to, $__dashboard, $__org, and $__user). Query-scoped global variables (such as $__interval and $__interval_ms) are not available in this field.
Transparent backgroundToggle this switch on and off to control whether or not the panel has the same background color as the dashboard.
Panel linksAdd links to the panel to create shortcuts to other dashboards, panels, and external websites. Access panel links by clicking the icon next to the panel title.
Repeat optionsSet whether to repeat the panel for each value in the selected variable.
Show/hide rulesSet whether to show or hide panels based on various rules.

News options

Use the following options to refine your news visualization:

  • URL - The URL of the RSS or Atom feed. If you leave the field empty, the Grafana Labs blog is used.
  • Show image - Controls if the news social image displays beside the text content.