Remove user accounts

VSTS | TFS 2018 | TFS 2017 | TFS 2015 | TFS 2013

When a user with access to Visual Studio Team Services (VSTS) or Team Foundation Server (TFS) leaves a company, an administrator would typically remove them from Azure Active Directory or Active Directory. This will automatically void their user account and remove their ability to access or connect to VSTS or TFS.

If you manage your VSTS users with Microsoft Service Accounts (MSA), then you'll need to remove their account from the Users hub.

In this topic you'll find:

  • A checklist to review when removing user accounts
  • Options for removing users from VSTS accounts
  • Links to topics for removing user accounts from AD or Azure AD

Consider when removing users

  • Have you granted users any paid extensions? You'll want to transfer those extensions to another user from the Users hub.
  • Do users have any tokens that you need to revoke?
  • Have you granted individual user accounts special permissions that need to be revoked?
  • Have you reassigned work users you are removing to current team members?

Remove users from VSTS accounts

If your VSTS account uses MSA accounts, then to you must remove users from the VSTS account as you have no other way to prevent access. When you do so, you'll not be able to create a query for work items assigned to the removed user account. To learn more, see Delete users for VSTS.

If your VSTS account is backed by Azure AD, then you can disable or delete the Azure AD user account while leaving their VSTS account active. In this way, you can continue to query their work item history using their account name.

Remove users from AD or Azure AD

For information on removing users from AD or Azure AD, see one of these topics:

Reduce the number of paid users, reassign paid extensions


To access the VSTS Users hub and manage users, you must have VSTS project collection administrator or account owner permissions.

Feedback and support

We welcome your feedback.

For product related inquiries, review our User Voice page or report a problem at Developer Community. Also, you can get advice on Stack Overflow, or get support via our Support page.

Follow us on Twitter @vsts.