Quickstart: Create a Wiki for your project

Azure DevOps Services | Azure DevOps Server 2019 | TFS 2018

In this quickstart, learn how to open a wiki and provision a Git repo for your wiki.

Every team project can have a wiki. Use the wiki to share information with your team to understand and contribute to your project.

Each team project wiki is powered by a Git repository in the back-end. When you create a team project, a Wiki Git repo is not created by default. Provision a Git repository to store your wiki Markdown files, or publish existing Markdown files from a Git repository to a wiki.

Each team project wiki is powered by a Git repository in the back-end. When you create a team project, a Wiki Git repo isn't created by default. Provision a Git repository to store your wiki Markdown files.

Prerequisites

  • You must have a team project. If you don't have a team project yet, create one in Azure DevOps.
  • You must have the permission Create Repository to publish code as wiki. By default, this permissions is set for members of the Project Administrators group.
  • Anyone who is a member of the Contributors security group can add or edit wiki pages. Anyone with access to the team project, including stakeholders, can view the wiki.
  • You must have a team project. If you don't have a team project yet, create one on-premises.
  • You must have the permission Create Repository to publish code as wiki. By default, this permissions is set for members of the Project Administrators group.
  • Anyone who is a member of the Contributors security group can add or edit wiki pages. Anyone with access to the team project, including stakeholders, can view the wiki.

Open the Wiki

Connect to your project using a supported web browser and choose Wiki.

Create wiki, provision a Git repo for your wiki or publish existing repo Markdown files

If you need to switch your team project, choose the  Azure DevOps logo to browse all team projects and teams.

Provision a wiki Git repository

Provision a new Git repository that stores all your wiki pages and related artifacts. From the Wiki landing page, select Create Project Wiki. (Even if you use TFVC for source control, you can create a wiki with a Git repository.)

Create wiki, Git repo for your wiki or publish existing repo Markdown files

Create wiki, Git repo for your wiki

If you don't have access to create a Wiki Git repository or if you don't have access to any of the existing wikis, the following message appears.

Insufficient permissions to create a Wiki repository

Your administrator can provision the Wiki Git repository or you can request that they elevate your permissions. Stakeholders can't create a wiki, as they have no permissions to work in Repos or Code.

The Wiki Git repo is referred as TeamProjectName.wiki. For example, if your team project is 'foobar' then the Wiki repo is labeled 'foobar.wiki'.

Note

If you want to provision more wikis, then you must publish code as a wiki. You can set up multiple wiki repos within a single project.

Why is the Git repository hidden?

The TeamProjectName.wiki doesn't appear in the drop-down menu of repositories from Repos or Code. It also isn't in the list provided from the Project Settings>Code>repositories or Project Settings>Version Control pages.

However, you can navigate to it from the following URL:

https://dev.azure.com/<AccountName>/<TeamProjectName>/_git/<WikiName>

https://<ServerName>/DefaultCollection/<TeamProjectName>/_git/<WikiName>

Choose Clone Wiki from the ellipsis near the wiki picker to access the Wiki URL.

Clone wiki

The URL of the wiki Git repository is exposed. Copy and paste it into your web browser to access the underlying Git repo.

Next steps