Nested Pages and SubWikis

You organize content in your wiki by putting them inside pages (a.k.a Documents). Each page usually holds content on a given topic.

However there are several ways to organize your pages:

Also note that the 2 options are not exclusive. You can have several wikis and be using Nested Pages in each. They're just 2 options that you can combine as you see fit.

Using Nested Pages

You can create a hierarchy of pages, by creating pages inside other pages. This feature is called Nested Pages. For example you could have a page "Product Team" inside a page "XWiki" inside a page "Rue Beaubourg" inside a page "Paris" inside a page "Ile de France", inside a page "France" inside a page "Europe" inside a page "Earth". When viewing the "Product Team" page you would see a Breadcrumb with the following (you can click on the ellipsis symbol to expand the tree):


In order to view the full organization of your pages in the current wiki, we offer an Index Application, which has a Tree-view. For example:


We also offer Tree navigation in the breadcrumb for each level. For example:


Using several (sub)wikis

XWiki allows creating several (sub)wikis. There are a few reasons you may want to use a subwiki instead of using Nested Pages (inside a single wiki):

  • You want to provide custom Applications/Extensions to a group of users of your wiki but not to others
  • You want to implement an XWiki Farm where each wiki is seen as an island (own users, etc)
  • There might be other reasons. See the detailed Wiki vs Nested Pages comparison for more technical details.


  • Nested Page (a.k.a Non-Terminal Page): This is a wiki page that can have children pages. Technically a Nested Page is implemented as a Space (i.e. a WebHome page).
  • Non-Nested Page (a.k.a Terminal Page): This a wiki page that cannot have children pages. Applications and script can create Terminal Pages. Advanced Users are also able to create Terminal Pages from the UI. Standard Users are only able to create Nested Pages.
  • Nested Space: A Space which has another Space as parent. Users only have to deal with Nested Pages, which is hiding the fact that Nested Pages are emulated using Nested Spaces. This is why the concept of Nested Spaces still exists.

Migrating to Nested Pages

If you're upgrading from a version of XWiki prior to the Nested Pages feature (i.e. XWiki < 7.2) to a version that supports Nested Pages, you may want to migrate your content.

Created by Vincent Massol on 2015/08/07 15:40

Get Connected