[CONFLUENCE] How can I use VTL to find the home page of a space? (content.getAncestors)

Hi all,

I'm trying to find out what the home page of a space is. I'm aware of '$content.getAncestors().get(0)', which can be used to get the full name (i.e., not the display title) of a page. However, when I try to use this in a user macro on the home page itself, it throws up an exception ("Error occurred rendering template content").

Is there another way to find out what it is?

Also, is there a way of getting the display name of the home page too?

I can't seem to find anything in the API documentation relating to '.getAncestors', and doing something trippy like $content.getAncestors().get(0).getDisplayTitle() doesn't work. Can someone point me in the right direction?

2 answers

1 accepted

1 vote
Answer accepted

I've found one solution I'm after.

You can use


To find out if it is the home page in a space. This provides a simple boolean answer.

There's the $content.isHomePage() method. I'm not sure I get exactly what you're doing, but you might be able to iterate over all the pages until you find the home page. Something like this (not tested):

#if ($content.getAncestors())
  #set($ancestors = $content.getAncestors())
  ## iterate over the ancestors
  #foreach ($p in $ancestors)
    ## do your checking here by getting the content object and then calling isHomePage()...

I'm trying to write a conditional in a macro that will run part of the macro of if it is/isn't the home page.

I added the following to the loop but I still get a template error on the home page:

#if ($p.isHomePage())

<p>$p is the home page</p>


Question: why does $content.getParent().getDisplayTitle work but not $content.getAncestors().get(0).getDisplayTitle? I'd also like to get a list of child page names, e.g., $content.getSortedChildre().getDisplayTitle, but this doesn't work either.

Suggest an answer

Log in or Sign up to answer
Community showcase
Posted yesterday in United States

Confluence Security Advisory

Good morning Members, Not sure if you are aware. Please read the following: https://www.icloud.com/keynote/0RyJ4VEdNUpjDpGfMhfZx9fEg#Confluence_Security_Advisor More details: https://co...

35 views 1 0
View post

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you