What's New API

Last modified by Admin on 2023/04/24 13:15

cogProvide information about what's new in XWiki
Developed by

XWiki Development Team

0 Votes
LicenseGNU Lesser General Public License 2.1
Bundled With

XWiki Standard


Since XWiki 15.1

Installable with the Extension Manager


API to gather external news related to XWiki.

The following concepts are used:

  • News Source Type: The type of source of news, in the form of a component hint. For example xwikiblog represents an XWiki Blog Application news type (which means getting the news from the RSS feed generated by the XWiki Blog Application).
  • NewsSource: The actual Java object representing a new source, with the ability to filter the news and get the pieces of news (represented as NewsSourceItem).
  • NewsSourceFactory: Component used to get a NewsSource. The hint is the news source type.
  • NewsSourceDescriptor: Represents a configuration for a News Source. See the configuration section below.

See also the What's New Application which uses this API to display the news inside XWiki.


  • Get news items from a xwikiblog source, for a given user, filtered by a category:
    private NewsSourceFactory factory;

    private NewsConfiguration configuration;

    List<NewsSourceDescriptor> descriptors = this.configuration.getNewsSourceDescriptors();
    NewsSourceDescriptor descriptor = descriptors.get(0);
    List<NewsSourceItem> items = this.factory.create(descriptor.getParameters())
    NewsContent content = items.get(0).getDescription().get();
    String itemDescription = content.getContent();
    Syntax itemSyntax = content.getSyntax();


Defined in xwiki.properties. By default the following configuration is used:

whatsnew.sources = xwikiorg = xwikiblog
whatsnew.source.xwikiorg.rssURL = https://extensions.xwiki.org/news
whatsnew.sources = xwikisas = xwikiblog
whatsnew.sources.xwikisas.rssURL = https://xwiki.com/news

The feature can be disabled by defining an empty list of sources, as in:

whatsnew.sources = 

Prerequisites & Installation Instructions

We recommend using the Extension Manager to install this extension (Make sure that the text "Installable with the Extension Manager" is displayed at the top right location on this page to know if this extension can be installed with the Extension Manager).

You can also use the manual method which involves dropping the JAR file and all its dependencies into the WEB-INF/lib folder and restarting XWiki.


Dependencies for this extension (org.xwiki.platform:xwiki-platform-whatsnew-api 15.3):


Get Connected