A space is a container for pages. It is made of all the pages in that space. In other words it's a set of pages grouped together under the same name. You may have noticed the notation [Space.Page]. This is a link to the page named "Page" in the "Space" space. Thus a page is uniquely identified by both its name and its space name (in a given sub-wiki). For XWiki.org for instance, the content is organized within the spaces listed on the right (they are the spaces for this sub-wiki).

This type of organization helps in creating a taxonomy whereby you have the ability to create subdivisions (e.g., server.name/Wiki/XWiki) to better organize information and manage rights more easily on your XWiki.

Note that starting with version 7.2, XWiki support nested spaces.  You can have more details about that feature in the documentation about Content Organization.

Before XWiki 7.2, pages can have parents that can simulate nested spaces (limited though). Starting with XWiki 2.5, to set the parent for a page, click the pencil located after the breadcrumbs, in edit mode:


After you have set the parent for that page the change will be reflected in the breadcrumb navigation:


Setting parents to pages allows for easy creation of hierarchies, as deep as you want.

Starting with XWiki Enterprise 4.1, a new features called "Hide Technical Content Spaces" was introduced. Because of this, certain spaces (ColorThemes, Panels, etc) will not be visible in the Spaces macro. If a space has all its pages marked as hidden, then the space itself will become hidden.

On your wiki's homepage you will see a list of all available spaces:


Space creation

Spaces are created implicitly and automatically as soon as one page is created with its name as the page space name. For example if you create a link in a page to [NewSpace.Page], the first time you click on the link to create the page the "NewSpace" space will be created and the page will be saved inside it.

Starting with XWiki 2.6, you can create a new space by using the Add menu:


Fill in the Space homepage name and click "Create":


Starting with the 3.4 release you can create simple space templates

On XE you can choose one of the two default templates to use for the homepage of the new space: 

  • a blank homepage
  • a space dashboard

Of course more space templates can be created and used when first creating a space.

You can also create spaces straight from the homepage by clicking the "Create a new space" link as presented below:


Deleting a space

In order to delete a space you have to delete all the pages in that space. 

Starting with the 3.4 release you can delete spaces directly from the "Space" menu.

Click on the "Space" menu and then on "Delete".


When deleting a space, you are asked to confirm the operation. Starting with 6.2M2, the list of documents that are about to be deleted is also displayed in the confirmation screen.
Note: This list of documents also contains hidden documents that are possibly not show in the space index if the current user has "Display hidden documents" set to "No" in his profile.


This way, all the pages of that space will be moved to the recycle bin. To restore the space, you will have to restore its pages one by one. To do so, click on "View the list of documents from this space that are currently present in the Recycle Bin".


You will be redirected to "Main.AllDocs" in which the livetable displays the "Deleted Documents" tab which stands for the Recycle Bin. There for each page you have 2 options:

  • To restore a page, click on the corresponding green icon located in the last column of the livetable.
  • To empty the Recycle bin: click on the red cross icon for each page you want to delete permanentlyerror this operation can not be undone.


Snippets for spaces

Created by VincentMassol on 2007/12/09 15:43

Get Connected