Documentation for Confluence 5.4.
Documentation for Confluence OnDemand and earlier versions of Confluence is available too.

Skip to end of metadata
Go to start of metadata

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.

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 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:

    Option

    Description

    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.

On this page:

Related pages:

Hints

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

Notes

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

29 Comments

  1. Anonymous

    Hello,

    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?

    Thanks

    1. 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:

      &showDiff=false
      
      &showContent=false
      

      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: http://confluence.atlassian.com/createrssfeed.action?types=page&types=blogpost&types=mail&types=attachment&sort=modified&showContent=false&showDiff=false&spaces=CONFKB&labelString%3D&rssType=atom&maxResults=10&timeSpan=5&publicFeed=false&title=Confluence+RSS+Feed&os_authType=basic

      hope this helps,
      Henry CL Tiong

      1. Anonymous

        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

        Mat

  2. HI,

    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,

    -Indra

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

      Cheers,
      Azwandi

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

    Thanks!

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

      1. Anonymous

        @Bailey - if your business had an enterprise rss server like Attensa (http://www.attensa.com) 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.

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

    1. 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,
      ZEd

      1. Anonymous

        Hi folks

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

        Regards
        Sansibar

  5. 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!

    1. Anonymous

      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.

  6. Anonymous

    Hi,

    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. :(

    Thanks.

    1. Hi,

      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:

      Regards,
      HengHwa

  7. Anonymous

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

    1. Anonymous

      Sorry,

      {webui-list:location=system.dashboard}
  8. 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

    S

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

    Regards,

    Eddie

    1. Anonymous

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

    1. I got it working :)

  10. Anonymous

    @Mukal

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

    1. Thanks much for your reply.

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

      Thanks Much!

      Regards

      1. Anonymous

        @Mukul

        How did you fix the problem?

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

  11. Anonymous

    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?

  12. 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) ?