Skip to content

Group wikis

  • Tier: Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

If you use GitLab groups to manage multiple projects, some of your documentation might span multiple groups. You can create group wikis, instead of project wikis, to ensure all group members have the correct access permissions to contribute. Group wikis are similar to project wikis, with a few limitations:

For updates, follow the epic that tracks feature parity with project wikis.

Similar to project wikis, group members with at least the Developer role can edit group wikis. Group wiki repositories can be moved using the Group repository storage moves API.

View a group wiki

To access a group wiki:

  1. On the left sidebar, select Search or go to and find your group.
  2. To display the wiki, either:

Export a group wiki

Users with the Owner role in a group can import or export a group wiki when they import or export a group.

Content created in a group wiki is not deleted when an account is downgraded or a GitLab trial ends. The group wiki data is exported whenever the group owner of the wiki is exported.

To access the group wiki data from the export file if the feature is no longer available, you have to:

  1. Extract the export file tarball with this command, replacing FILENAME with your file's name: tar -xvzf FILENAME.tar.gz
  2. Browse to the repositories directory. This directory contains a Git bundle with the extension .wiki.bundle.
  3. Clone the Git bundle into a new repository, replacing FILENAME with your bundle's name: git clone FILENAME.wiki.bundle

All files in the wiki are available in this Git repository.

Configure group wiki visibility

Version history

Wikis are enabled by default in GitLab. Group administrators can enable or disable a group wiki through the group settings.

To open group settings:

  1. On the left sidebar, select Search or go to and find your group.
  2. Select Settings > General.
  3. Expand Permissions and group features.
  4. Scroll to Wiki and select one of these options:
    • Enabled: For public groups, everyone can access the wiki. For internal groups, only authenticated users can access the wiki.
    • Private: Only group members can access the wiki.
    • Disabled: The wiki isn't accessible, and cannot be downloaded.
  5. Select Save changes.

Delete the contents of a group wiki

  • Tier: Free, Premium, Ultimate
  • Offering: GitLab Self-Managed, GitLab Dedicated

You can delete the contents of a group wiki with the Rails console. You can then populate the wiki with new content.

This operation deletes all data in the wiki.

This command changes data directly and could be damaging if not run correctly. You should run these instructions in a test environment first. Keep a backup of the instance ready so you can restore the instance, if necessary.

To delete all of the data from a group wiki and recreate it in a blank state:

  1. Start a Rails console session.

  2. Run these commands:

    # Enter your group's path
g = Group.find_by_full_path('<group-name>')

# This command deletes the wiki group from the filesystem.
g.wiki.repository.remove

# Refresh the wiki repository state.
g.wiki.repository.expire_exists_cache

All data from the wiki has been cleared, and the wiki is ready for use.

Related topics