Getting Started with XWiki Enterprise

Version 28.1 by Silvia Macovei on 2016/05/26

Welcome to the XWiki "Get Started" page. This guide provides basic information on how to set up and use XWiki Enterprise. (Click here to learn more about wikis.)

XWiki's use cases are diverse: collaborative intranet, knowledge base, CMS, competitive intelligence, public debate, collaborative creation of school courses, web site creation, etc. Read more on what wikis can be used for, what makes XWiki Enterprise special and a second generation wiki.

You can visit the references page to see a list of varied projects based on XWiki. You can add your own project to the same page by filling in a short form. You can also go to the XWiki project homepage to see some of the companies that use XWiki or check out the testimonials page to view what our users have to say.

If you need more help with your wiki or you'd like to get in touch with the community please visit the support page. There you'll find more information on:

Basic information

As you log in to your wiki the first thing you see is the wiki homepage.


1.png XWiki Enterprise is divided into Wikis and Pages. Inside a wiki, you can create a hierarchy of pages, by creating pages inside other pages. This feature is called Nested Pages. From this area you can add new pages by clicking the "+" button.

2.png Whenever you want to modify a page, click on the pen edit button, make your changes and save the page. The modified page now replaces the previous version. Each version of the page is stored in the page history and can be reverted to if needed. More page actions, such as Administer, Copy, Rename, Delete, Export, are also available from the last two menus on the right.

3.png From the upper right corner you may click on your profile, or the notifications menu.

4.png By expanding the drawer menu on the right you can access you profile or go to the wiki administration. You can also access the wiki, page or user indexes, as well as add a new wiki.

5.png The dashboard allows users to customize pages by adding gadgets. You can edit/modify the dashboard by editing the page which contains the dashboard. The default dashboard has:

  • A welcome message
  • The pages macro
  • A tags cloud
  • The ability to send messages 
  • The activity stream

6.png Lateral menus are handled using panels. A panel is a widget you can see on the left and right of every page of your wiki in the standard version of XWiki Enterprise. By default you will see a small sized Applications panel on the left and medium sized panels on the right.

7.png The tabbed area at the bottom of the page features by default comments, attachments, page history, page information.

To see the complete list of features go to the features page. More information on the first steps with XWiki Enterprise can be found on this page.

If you're an Administrator

Before you perform admin actions, you will need to log in using the following credentials:
Username: Admin
Password: admin

We strongly recommend you change the Admin's password to a secret one as soon as you can.

The XWiki Platform provides general information for admins that need to customize their wiki application (authentication, DB, performance tuning, etc.). Everything you want to know about administrating XWiki, from installation to backups is available in the Administrator's Guide:

If you're a Developer

XWiki is also a second generation wiki. You can build simple applications, extend the platform with custom plugins, or even build complex Web applications. XWiki's powerful programming features are documented in the Developer's Guide. A number of applications are built-in, such as the Blog. Additional applications, macros and other extensions are available on the Extensions wiki. The documentation for the XWiki Rendering has a dedicated wiki.

For documentation related to contributing to the XWiki project, visit the XWiki Development Zone

Get Connected