4 KiB
| stage | group | info |
|---|---|---|
| Create | Editor | To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments |
Group wikis (PREMIUM)
Introduced in GitLab 13.5.
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:
- Git LFS is not supported.
- Group wikis are not included in global search.
- Changes to group wikis don't show up in the group's activity feed.
- Group wikis are enabled by default for GitLab Premium and higher tiers. You can't turn them off from the GitLab user interface.
For updates, follow the epic that tracks feature parity with project wikis.
Similar to project wikis, group members with at least the Developer role and higher 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:
- On the top bar, select Main menu > Groups and find your group.
- To display the wiki, either:
- On the left sidebar, select Wiki.
- On any page in the project, use the g + w wiki keyboard shortcut.
Export a group wiki
Introduced in GitLab 13.9.
Users with the Owner role in a group can import and export group wikis when importing or exporting 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:
- Extract the export file tarball with
this command, replacing
FILENAMEwith your file's name:tar -xvzf FILENAME.tar.gz - Browse to the
repositoriesdirectory. This directory contains a Git bundle with the extension.wiki.bundle. - Clone the Git bundle into a new repository, replacing
FILENAMEwith your bundle's name:git clone FILENAME.wiki.bundle
All files in the wiki are available in this Git repository.
Configure group wiki visibility
Introduced in GitLab 15.0.
Wikis are enabled by default in GitLab. Group administrators can enable or disable a group wiki through the group settings.
To open group settings:
- On the top bar, select Main menu > Groups and find your group.
- On the left sidebar, select Settings > General.
- Expand Permissions and group features.
- Scroll to Wiki and select one of these options:
- Enabled: Everyone who can access the group can access the wiki.
- Private: Only group members can access the wiki.
- Disabled: The wiki isn't accessible, and cannot be downloaded.
- Select Save changes.