Favourite Pages Macro

Use the Favourite Pages macro to display a list of your favourite pages.

The output of the Favourite Pages macro appears as in the following screenshot.

Screenshot: The Favourite Pages Macro in Confluence

Using the Favourite Pages Macro

To insert the favourite pages macro into a page using the Macro Browser:

  1. In the Confluence editor, choose Insert > Other Macros
  2. Find and select the required macro

Speeding up macro entry with autocomplete: Type { and the beginning of the macro name, to see a list of suggested macros. Details are in Autocomplete for links, files, macros and mentions.

To edit an existing macro: Click the macro placeholder and choose Edit. A macro dialog window will open, where you can edit the parameters of the macro.

There are no parameters for this macro.

Code examples

The following examples are provided for advanced users who want to inspect or edit the underlying markup for a Confluence page. 

Macro name: favpages

Macro body: None.

Parameters: None.

Storage format example

Wiki markup example

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

22 Archived comments

  1. User avatar

    Thomas Van de Velde

    Is it possible to list favorite pages without the default header?

    15 Dec 2005
    1. User avatar

      Vidya Madabushi


      Currently, this is not possible, but I have created a feature request here.

      16 Dec 2005
  2. User avatar

    Guy Fraser (Adaptavist)

    This macro doesn't appear in the notation guide - I've looked a couple of times but could not see it mentioned when viewing "All" items in the guide?

    11 Feb 2006
    1. User avatar

      oliver schormann

      this macro is part (a module) of a macro-plugin called "Advanced Macros" which ships at least with confluence 2.1.4 (see dashboard > administration > plugins). though some of these Advanced Macros are actually in the notation guide(smile)

      03 Mar 2006
  3. User avatar

    Judy Sing

    Is it possible for the Confluence administrator to change the spelling of "favourite" to "favorite"?  If so, where can you accomplish this task?

    15 Aug 2006
  4. User avatar


    I have the same issue - any way to change the spelling to "favorite"
    Same issue with "Colour Scheme" - would like to change to "Color Scheme".

    29 Aug 2006
    1. User avatar

      Jeff Guthrie

      Did this get resolved?

      03 Nov 2006
      1. User avatar


        AFAIK, this is not being looked at, judging from the fact that http://jira.atlassian.com/browse/CONF-4956 (request to hide default header for Favourites) was created in 2005. Maybe the subject of the issue is too narrow - "enable users to set custom titles to default headers". Much like you'd do with a {note} macro, for example.

        I think this is a larger issue of i18n in Confluence. Ideally, you should be able to specify your language set globally, and the default headers and such would render with appropriate spelling. But if Atlassian could provide an interim solution (e.g. ability to override the default header title with custom text), that would fend off the helpful user feedback about misspellings(wink).

        14 Jan 2009
        1. User avatar

          Mark Hrynczak [Atlassian]

          The default for the Confluence interface is Australian English. However you can translate this into other languages by installing a language pack.

          See this page for the installation steps. There is a US English pack available, which will provide you with the appropriate spellings.

          I will also update CONF-4956 with this information.


          15 Jan 2009
  5. User avatar

    Charlie Perry

    Quick question. I've just put this macro on my personal space and now I can see a list of my favourite pages. If someone else comes along and looks at the same page do they see my favourite pages or their favourite pages? Is the macro user specific and if not can I specify which user's favourites I want to list (ie {favpages:user=charlie})?

    30 Apr 2007
  6. User avatar


    Is there a way to specify the order to return the results in i.e. alpha, group by conf space, most visits? It currently returns the most recently added.

    It would also be nice to have the option of {favpages:maxResults=all}. I have worked around this by using a large max value like 6000.

    09 Nov 2007
    1. User avatar

      Tony Cheah Tong Nyee

      Hi Ahmad,

      Unfortunately, there are no parameters that I know of which would meet your requirement. If you are keen on this feature, I would suggest you to raise a feature request to this in our Issue Tracker system:


      13 Nov 2007
  7. User avatar

    Mark Troutfetter

    I second Charlie's comment.  When I use this macro and somone else looks at my page they see there favorites instead of mine.  Why?

    15 Apr 2008
    1. User avatar

      Tony Cheah Tong Nyee

      Hi guys,

      I believe this is due to the macro rendering result based on the label "my:favourite". Hence, it shows the current login user's favourites instead of a specific user's favourite list. There is an open improvement request regarding this feature to be included in the Favourite Pages macro. Please see:

      Feel free to cast your vote to increase its popularity and add yourself as a watcher for future updates.


      16 Apr 2008
  8. User avatar


    Is there any way to restrict the favourites displayed to a particular space?

    20 Jun 2008
    1. User avatar

      Azwandi Aris [Atlassian]

      Hi there,

      As far as I know, the macro is not equipped with that feature. If you are eager to see this feature to be included in the future version of this macro, I would suggest you to lodge a feature request at our issue management tracker:



      23 Jun 2008
  9. User avatar

    Mauricio Salles


    I've followed the orientations to add a navigation sidebar . I've inserted the list of favorites within the sidebar (as a macro in TreeNavigation page), but its title (pagetree title) is always above the list of favorites, because it is stated in page layout decorator.

    I'd like to know how to insert the list of favorites within the sidebar, but above the pagetree title.


    23 Nov 2009
    1. User avatar

      Zed Yap [Atlassian]

      Hi Mauricio,

      I have a mere suggestion, you might need to change the Page layout for the space. To do so, Please follow this documentation:

      Now replace the following code:


      Hope that helps.
      Best rgds,

      25 Nov 2009
  10. User avatar

    William Winner

    this macro doesn't work in a sidebar.  I have set up our site with the Document theme.  I then build a page to use for the sidebar and used the {include} macro to add the page to the sidebar and I end up with javascript showing up in the pane.  It does load the favorites, but the link to add a new favorite isn't there (which I assume was supposed to be added by the javascript that get interpreted as html.

    17 Aug 2010
  11. User avatar

    Subasree Nithiyanandam

    The macro opens hyperlink in new tab.when i click "favorite" page/space hyperlink, it opens in new tab. I want to avoid this. Is there any way to do that ? thanks in advance.  

    13 Apr 2012
  12. User avatar

    Ramsay Mayka

    I think it would be useful to be able to get the list of all my favourites, and not just the recent additions.

    I am able to get this result by using the Content by Label macro and specifying "my:favourite" as the label and only requesting "page" as the content type, but that is really not intuative.

    11 Oct 2012
  13. User avatar


    I strongly agree.  I want to see ALL of my favourites on the dashboard, not just the most recent additions.

    Here's my use case: I want to have access to a certain page from my dashboard, so I navigate to that page and click the star icon to add it as a favourite.  I go to my dashboard and I see the link to the page in the Favourite Pages section.  That works nicely, so I add a few other pages as favourites.  However, after I exceed ten pages in my favourites list, the older pages start dropping off the list.  Suddenly, I'm no longer finding this feature as valuable, as I have to go to other pages to find the not-so-recent favourites.

    The most interesting pages (or most favourite) for me aren't necessarily the most recently added pages.

    15 Aug 2013
Powered by Confluence and Scroll Viewport