The RSS Feed Builder

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.

Build 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 the help icon  at top right of the screen, then choose 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 Options to set the following:



    Feed Name

    The default name is based on the name of your Confluence installation. For example, '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. Choose Create RSS Feed
  6. Drag or copy the link into your RSS reader



  • Separate feeds. 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.
  • 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.


  • Removing an RSS feed: 

    There is no need to try to delete or remove an RSS feed built by the Confluence RSS feed builder.

    Explanation: The feeds generated by the RSS Feed Builder are dynamically generated via the parameters included in the feed URL (address). For example, take a look at the following feed URL:

    The above feed URL will generate a list of pages ('types=page'), sorted by the modification date and showing the page content. The feed is generated at the time when the URL is fetched and there is no RSS feed information stored on the database. For that reason, there is no need to remove anything.

  • 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.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

31 Archived comments

  1. User avatar



    I'm using the feed builder to build rss feeds using lables - all works well but the xml created can be huge as the feedbuilder pulls in the entire articles. IS there a way for the feed builder just to pull the title and link and ignore the actual body?


    08 Feb 2009
    1. User avatar

      Henry Tiong [Atlassian]

      Hi there,

      I am not sure the reason behind you would want to do that, AFAIK, most RSS Readers (I'm using FeedDemon) will download the title and link first, and will only download the content when you actually click on that RSS title. In any case, perhaps your concern here is not on the RSS Reader, but perhaps to massage the XML file itself.

      It is possible to do so, but it can be quite tedious - you will need to change the certain parameter in the Feed URL. When the Feed URL is generated, change the following:


      I believe both parameters are self-explanatory. Originally, both parameters above were set to true.

      Other that that, you might also want to remove the parameter, &types=comments to entirely not to pick up comments posted to the page as well.

      Take a look at this sample Feed URL that I'd modified as what mentioned above:

      hope this helps,
      Henry CL Tiong

      18 Feb 2009
      1. User avatar


        Hi Henry,

        Thanks for the reply. It works perfectly and has cut some of our feeds from 250k to 25k (thumbs up)

        We use the feed builder with labels and have found it can be slow. So I have a cron job that does a wget for the RSS with labels every 15 minutes and saves the xml files to a web server. We then parse this xml via MM_XSLTransform.class.php script to user selectable/customisable portlets in our portal server where we only require the a linked title so when a user clicks on the title it takes them to the Confluence page.

        Cutting down the xml saved to the server makes the portlets load much quick as the parse does not have to work so hard.

        Thank you


        18 Feb 2009
  2. User avatar

    Indra Gunawan


    I just upgraded from Confluence 2.8.0 to 2.10.1.  The upgrade involved change of server with new DNS name. 

    After the upgrade, our user found out that the RSS Feed created for a space tried to contact the old production with old URL.

    Where in Confluence should I make the fix so the RSS Feed Builder will create it on space now on new server with new URL?

    Thank you,


    27 Jul 2009
    1. User avatar

      Azwandi Aris [Atlassian]

      Hi Indra,

      First off, can you please ensure that the server base URL has been updated? In case there are feeds created before you changed the URL, please ensure that you replace the new URL in those feeds URL, too. Hope that helps.


      28 Jul 2009
  3. User avatar

    Bailey Policarpio

    Hi, Does anyone know what is the limitation on Confluence RSS storage? i.e. how many days worth of RSS or how many RSS feeds maximum will be available for download?

    The reason I ask is because there would be times when I would be offline for an extended period, when I can log on again and download - would I miss out any changes made (feeds I subscribed to)?

    If there's a limit, is it configurable?

    I'm using feeddaemon by the way.


    13 Sep 2009
    1. User avatar

      Bailey Policarpio

      You can only download 15 RSS per space - if there were more than 15 changes, you won't get it in feedaemon. What I tried is I did not open feedaemon for 2 days and there was a lot of posts and comments during that time. When I run feedaemon, it was only able to download 15 of the newest changes. When I looked at the recent changes of confluence and compared it to feedaemon - a lot were missing between the last time I logged on and the RSS feed just downloaded.
      Does anyone know if thIs is adjustable? I was hoping to get the complete updates thru RSS...

      15 Sep 2009
      1. User avatar


        @Bailey - if your business had an enterprise rss server like Attensa ( it would continue to aggregate this information for you whether you were in the office or not, and it's all available in the feed reader when you return to the office.

        22 Sep 2009
  4. User avatar

    Michelle Ziegmann

    I'm wondering if there are more options regarding the labels in a feed. For example, I only want to include pages that have BOTH of 2 labels (instead of either), or exclude pages that have a "draft" label.

    15 Oct 2009
    1. User avatar

      Zed Yap [Atlassian]

      Hi Michelle,

      I'm wondering if there are more options regarding the labels in a feed. For example, I only want to include pages that have BOTH of 2 labels (instead of either), or exclude pages that have a "draft" label.

      As far as I know the feature requested is not available yet. However, I found a feature request in JIRA which might be the closest to your requirement:

      Please add your comments to the discussion, vote on it and add yourself as a watcher for future updates. Also, please bare in mind the following document on how we schedule features for inclusion in our products: Implementation of New Features and Improvements.

      If you are least happy on the feature request, feel free to launch a feature request in JIRA:

      I have also personally tried with the AND and OR operator but it did not helps.

      Hope that helps.
      Best rgds,

      19 Oct 2009
      1. User avatar


        Hi folks

        I have raised an improvement request on this: CONF-21208. Seems as if this might help other confluence users as well.


        10 Nov 2010
  5. User avatar

    Arley Lewis

    Hi Atlassian folks,

    I'd like to use the RSS Feed Builder to make an rss feed and put it on a Confluence page where I can read it. (Am I barking up the wrong tree here? All I want is a Confluence page that aggregates news headlines from other Confluence pages on the same Confluence wiki. That seems like something that I should be able to do in Confluence without knowing what an "rss feed" is.)

    I've read your articles, Using the RSS Feed Builder and RSS Feed Macro and hacking in your username and pw and Working with RSS, ...and these led me to write the following (web url/username/pw changed here):

    but when I create the page, I see only this where my feed should be:

    Our Confluence server authenticates us using our Windows network login credentials in AD. Can you help? Thanks!

    15 Jun 2010
    1. User avatar


      The problem would appear to be that your Confluence setup does not trust the SSL certificate used by the feed, probably because it is signed by a CA which is not on the trusted CA list of the Java VM which is running Confluence. I believe that you can find instructions in the Confluence documentation on how to add additional CA certificates to to the certificate store.

      18 Feb 2011
  6. User avatar



    is it possible to make feed display also what pages have been deleted? All I can see in my feed are new or updated page. :(


    25 Aug 2010
    1. User avatar

      HengHwa Loi [Atlassian]


      I'm afraid that this is not possible for now. I would suggest you to raise a feature improvement for this in the following link:


      12 May 2011
  7. User avatar


    Is it possible to put the "Feed Builder" link anywhere else than the Dashboard? It seems that the file contains it within the  {webui-list:location=system.dashboard} macro, which isn't particularly useful.

    04 Apr 2011
    1. User avatar



      04 Apr 2011
  8. User avatar

    Steve Furness

    Is there any way to create a feed that only tracks major changes.  I dont want to update the feed every time a user corrects a typo I only want to know when a major content change happens


    03 May 2011
  9. User avatar

    Eddie Webb

    Anyway to go about getting these feeds in JSON format?

    We want to embed the latest updates in a standard HTML/JS webpage outside of confluence.



    19 Jul 2011
    1. User avatar


      We ended up using Rome, a Java library to retrieve and parse the feed for display.

      29 Jul 2011
  10. User avatar


    Hello All,

    I have created a feed using confluence feed builder. Below is my RSS URL:


    Now when I try to use this in Google Reader, it doesn't load the feed. Could anyone help me on this?

    How can I load Confluence Feed using Google Reader ?

    Thanks and Regards


    29 Jul 2011
    1. User avatar


      I got it working :)

      29 Jul 2011
  11. User avatar



    That domain is not publicly accessible, so Google servers are unable to retrieve the RSS content.  

    29 Jul 2011
    1. User avatar


      Thanks much for your reply.

      I too found out it was DNS issue, I got it working now.

      Thanks Much!


      29 Jul 2011
      1. User avatar



        How did you fix the problem?

        01 Aug 2011
        1. User avatar


          Just that I asked my client to put those Feed URL's in public domain.

          02 Aug 2011
  12. User avatar


    Hi there, I'm new to all this. I'm trying to get a RSS Feed onto this website I'm working on. I can use the builder and get to the "drag or copy this link into your rss reader". But when ever I put it into a rss reeder, its either not being recognised or it says "the 10 most recent pages, blogposts less than 5.0 days old" but no feeds, only that text.

    I think I'm doing something wrong, but I have no idea what. I'm using Ubuntu if that makes any difference.

    Any ideas?

    03 Aug 2011
  13. User avatar

    Prathamesh Patil

    Hi there, I need to read all my RSS FEED (Activity streams) in other application. Currently it showing only those feeds that authentication is anonymous, now I need to help that how I can read all feed(authenticated & anonymous) ? 

    13 Nov 2013
  14. User avatar

    Meagan Bird

    Hi, I'm wondering if there is any way to allow anonymous users to subscribe to an RSS feed through the RSS builder?

    18 Jun 2014
    1. User avatar

      Rachel Robins [Atlassian Tech Writer]

      Hi Meagan, There is some info about issues getting anonymous feeds out of the RSS builder here  CONF-21601 - Generating anonymous feed through Feed Builder is not possible anymore Open . I'm afraid I don't know a lot about that workaround. I'd suggest contacting Support for some help if you choose to go down that route. 

      Alternately, you could let your users know they need to remove the "&os_authType=basic" from the end of the feed for it to work without login, or provide them with the feed URL yourself. 

      18 Jun 2014
Powered by Confluence and Scroll Viewport