View wiki page history and revert changes

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

This article shows you how to view the revision history of a wiki page in Azure DevOps. It also provides information on how to revert changes made to a wiki page.

Prerequisites

  • You must have at least Basic access to create and modify a wiki.
  • You must have the permission Create Repository to publish code as wiki. By default, this permission 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 the permission Create Repository to publish code as wiki. By default, this permission 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.

View wiki page revision history

  1. Sign in to your organization (https://dev.azure.com/{yourorganization}) and go to your wiki page.

  2. Select More actions > View revisions.

    Screenshot of the context menu showing Print, Link work items, View revisions, and Delete options. The View revisions button is highlighted.

  3. Revision pages show who made the change along with the revision message, date, and version or commit ID. To view details of a revision, select the message or version link.

    Screenshot of Page for a provisioned wiki page.

  4. Similar to any git file revision, the revision details page provides a Show diff side-by-side view or the Show diff inline view. Choose Preview to see the content of the page of the specific revision.

    Screenshot of article revisions compared side-by-side. The article is in Markdown.

    For a publish as code wiki page, similar information displays, but the Revert button isn't active.

  5. Use the breadcrumbs to return to the page or revisions of the page.

Revert a commit to a provisioned wiki page

Select Revert on the revision details page to revert a change on a wiki page.

Screenshot fo the Dialog box revert revision. Revert option is selected.

Revert a commit to a publish as code wiki page

To revert to an earlier revision for a page that you published as code, do one of the following actions:

  • If the commit is the most recent revision to a page, you can revert from the web portal.
  • If the commit is an earlier revision, with more commits having occurred in between, create a separate branch and revert the changes in that branch.

Revert from a recent revision from the web portal

  1. Preview any version by choosing the commit ID from the Revisions page for the selected file.

  2. Copy the full ID of the commit by selecting Copy-clone.

    Screenshot of Copy the full commit ID.

  3. Go to Repos > Commits, paste the ID that you copied into the Commit ID box, and select Search.

    Screenshot of Paste the commit ID for an earlier commit.

  4. From the commit page, select More actions, and then choose Revert.

    Screenshot of Choose revert menu option of an earlier commit.

  5. Confirm that you want to revert. Select Revert.

    Screenshot of Revert commit dialog.

    A branch gets created with the reverted changes.

  6. Select Create Pull Request.

    If you receive an error message, you might need to create a local branch and make your changes manually as described in the next section.

  7. Select Create in the New Pull Request form.

  8. Select Complete merge to merge the changes into the main wiki branch. Optionally, add a check to the checkboxes to select post-completion options.

    Screenshot of Revert publish code as wiki, complete pull request.

To view the reverted content, return to the wiki and refresh the browser.

Revert from earlier revisions using a different branch

To revert to an earlier committed version of a publish as code wiki page, one that isn't the immediate last revision, update a branch other than the main branch for the wiki, and then create a pull request to the main branch.

  1. Create a local branch of the main wiki branch.
  2. View the commit history and locate the commit that contains the changes you want to undo.
  3. Use the revert command to revert the desired commit.
  4. When a conflict arises, use the conflict resolution tool to resolve the issues.
  5. Commit the changes to your local branch.
  6. Push the local branch to the remote server.
  7. Create a pull request for your local branch into main.
  8. Complete the pull request.