cogAllows committing XWiki pages to a GitLab repository
Developed by

Ludovic Dubost, Denis Gervalle

Active Installs33
1 Votes
LicenseGNU Lesser General Public License 2.1

Installable with the Extension Manager


XWiki GitLab Application allowing to commit XWiki code to a GitLab repository

The application will allow to check the differences between the content of your XWiki instance and the content of your repository, and allow to commit them as well as to update from the repository.

When committing, files are formatted similar to mvn xar:format and it is using the nested space format.

The application also allows to commit a sample pom.xml file.  

To authenticate to your GitLab instance, you need to use a Private Token which you can get from the settings of your user in the "Access Token" section.

Configuration of your Repository information


Listing pages to commit or update


Committing pages



Prerequisites & Installation Instructions

We recommend using the Extension Manager to install this extension (Make sure that the text "Installable with the Extension Manager" is displayed at the top right location on this page to know if this extension can be installed with the Extension Manager). Note that installing Extensions when being offline is currently not supported and you'd need to use some complex manual method.

You can also use the following manual method, which is useful if this extension cannot be installed with the Extension Manager or if you're using an old version of XWiki that doesn't have the Extension Manager:

  1. Log in the wiki with a user having Administration rights
  2. Go to the Administration page and select the Import category
  3. Follow the on-screen instructions to upload the downloaded XAR
  4. Click on the uploaded XAR and follow the instructions
  5. You'll also need to install all dependent Extensions that are not already installed in your wiki

Release Notes


  • The commit screen is improved to classify separately:
    • modified documents
    • documents to be added
    • minor format changes
  • The diffs is now using the unified format and highlighting like the ones available in the standard display of changes in document history.


  • Normalize attachment version, date and author


  • Fix handling of empty licence file


  • Fixes for nested spaces
  • Fixed for subdirectories in repositories


  • First version with limited testing
  • Support formatting of pages


Dependencies for this extension (org.xwiki.contrib.gitlab:application-gitlab 1.0.5):

  • org.gitlab:java-gitlab-api 4.0.0
Created by Ludovic Dubost on 2018/06/10 22:43

Get Connected