Using the RSS feed builder, you can create customised RSS feeds to subscribe to changes within Confluence.

Wondering what an RSS feed is? See more information about RSS Feeds.

On this page:

Building an RSS Feed

Follow the steps below to build your feed, choosing the type of content and the time period you want to monitor.

To create a customised RSS feed:

  1. Choose Browse > Feed Builder.
  2. Select the content types you want in your feed. Check Mail if you want to know when the email archive is updated. (See the overview of mail archives in Confluence.)
  3. Select one or more spaces from the list.

  4. Click Advanced Optionsto set the following:

    Option

    Description

    Feed Name

    The default name is based on the name of your Confluence installation, e.g. 'Extranet RSS Feed'

    With these labels

    Enter one or more labels separated by spaces or commas. Confluence returns all content (of the selected types) that matches one or more of the labels. See the hint below about using labels to customise your feeds.

    Exclude these spaces

    Exclude specific spaces from those already selected.

    Sorted by

    Sort content by either the date or creation or the date they were last updated.

    Limit to

    Specify the number of items returned in your feed.

    Within the last

    Specify how old items returned can be.

    Include content for pages

    Specify whether the entire page is displayed in the feed.

  5. Click Create RSS Feed to create your feed.
  6. Drag or copy the link into your RSS reader.

(tick) Tip: Try building separate feeds, one for pages only and one that includes comments as well. This allows you to monitor only pages if you are short of time, and to read the comments when you have more time.

Hint: Using Labels to Customise your Feed

You can use the RSS feed builder to track updates to labelled pages and comments on those pages. Here is an idea for customising your RSS feed by using your own personal label(s). This is useful if you want to track updates to specific pages or blog posts, and you do not want to deal with emails. You can use this method as an alternative to watching pages.
  • Build an RSS feed that returns pages, blog posts and comments labelled with a personal label, such as 'my:feed'.
  • Each time you want to 'watch' a page, just label it with 'my:feed'.
  • All updates and comments will automatically come through your RSS feed.

Notes

  • Removing an RSS feed: You need only delete the RSS feed link built by the Confluence RSS feed builder to remove an RSS feed from your page. This is because the feed is dynamically generated using the parameters in the feed URL.
  • Feed authentication options:Confluence can offer you the option of an anonymous feed or a feed that requires authentication.
    • An anonymous feed will show only the content that is visible to anonymous users. The feed URL does not contain the &os_authType parameter mentioned below. This feed is useful only if your Confluence site allows anonymous access. If a feed is anonymous, you only get anonymously-viewable content in the feed regardless of whether you are a Confluence user or not.
    • An authenticated feed requires you to log in to Confluence before you can retrieve the content. The feed URL contains the following parameter: &os_authType=basic.
    • The option to choose between an anonymous and an authenticated feed is currently not available on the feed builder screen. The feed builder offers only authenticated feeds. See CONF-21601 for details and a workaround.

Related Topics

RSS Feeds FAQ
Watching Changes
Working with RSS Feeds

Take me back to Confluence User's Guide

  • No labels

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.