Manage users and assign access to your Visual Studio Team Services account

After you create your Visual Studio Team Services account, add users and assign them access at the same time. That way, you can make sure they get the correct features that they need.

What access do my team members need?

Team members need Stakeholder, Basic, or Visual Studio/MSDN subscriber access. Your Team Services account includes 5 free users with Basic access. You can add unlimited Stakeholders and Visual Studio subscribers at no extra charge.

For example, you can give Stakeholder access to team members who just need to work on the backlog. This includes creating work items and queries, and editing these items too.

If you have to pay for more users, you can do that in the Azure classic portal or the Azure portal after you set up billing for your account with an Azure subscription. Learn more about Team Services features or pricing.

Note: We replaced Visual Studio Online Advanced and Professional subscriptions. We'll transition users automatically. Learn more

Add team members and assign account access

  1. Sign in to your Team Services account (http://{youraccount}.visualstudio.com). You'll need account owner or project collection administrator permissions.

  2. Is your account associated with an organization, like a company or school?

    If you're not sure, find out whether your account uses your organization's directory to control who can get account access.

    • No: Your team will use Microsoft accounts (for example, @outlook.com or @hotmail.com) to sign in.

    • Yes: Only users in the directory can get access. Your team will use their work or school accounts (for example, @fabrikam.com) to sign in.

  3. View all the users in your account.

    Go to the Users hub

    You'll see your account access already set up here. For example, if you have a Visual Studio subscription that includes Team Services, that subscription appears here.

    Your account access appears in the Users hub

  4. Now add the sign-in addresses for your team members. You can add:

    For Team Services accounts that use a directory, you can choose names from that directory when you add users.

    Here's what a team might look like after paying for additional users:

    Add users and assign additional licenses

Try this next

Remove users from your account

When users don't need access to your Team Services account anymore, remove them.

  1. Sign in to your Team Services account (http://{youraccount}.visualstudio.com). You'll need account owner or project collection administrator permissions.

  2. Go to the Users hub.

    Delete users from the Users hub

If you paid for these users and don't want to reassign their access, reduce those users in Azure so you're not charged for them in the next billing cycle.

  1. Sign in as the Team Services account owner to the Azure classic portal or the Azure portal.

  2. Select your Team Services account.

    Azure classic portal

    Select your Team Services account

    Azure portal

    Select your Team Services account

  3. View your paid users.

    Azure classic portal

    Go to the Scale page

    Azure portal

    View users

  4. Reduce your paid users, then save your changes.

Q&A

Q: Why can't I add users?

A: You must have Team Services account owner or project collection administrator permissions to add users.

Q: When do I select "Visual Studio/MSDN Subscriber"?

A: Select this access level when the user has an active and valid Visual Studio subscription. You'll need the user's sign-in address that's associated with this subscription.

If you select "Visual Studio/MSDN Subscriber", but the user doesn't have a valid and active Visual Studio subscription, they can only work as a stakeholder.

If a user wants to use an MSDN subscription with Team Services, but has different sign-in addresses for Team Services and their subscription, they must link their Team Services sign-in address to their subscription on the My Account page.

Q: Which Visual Studio subscriptions can I use with Team Services?

A: These subscriptions include Team Services at no extra charge:

  • Visual Studio Enterprise - monthly
  • Visual Studio Enterprise - annual
  • Visual Studio Enterprise with MSDN
  • Visual Studio Professional - monthly
  • Visual Studio Professional - annual
  • Visual Studio Professional with MSDN
  • Visual Studio Test Professional with MSDN
  • MSDN Platforms

You can also use these subscriptions when you get them through the BizSpark program or Microsoft Partner Network (MPN). Or you can add users with Basic or Stakeholder access instead. Your Team Services account includes 5 free users with Basic access.

Subscriptions that aren't eligible: MSDN Operating Systems, MSDN Essentials, and Visual Studio Professional (MPN). Visual Studio Professional (MPN) is the subscription offered to Microsoft Action Pack partners in the Microsoft Partner Network and was formerly called "MSDN for Action Pack."

Learn more about Visual Studio subscriptions.

Q: On the Users hub, which subscription does "Visual Studio Enterprise subscription" and "Visual Studio Professional subscription" specifically mean?

A: Currently, "Visual Studio Enterprise subscription" can describe:

  • Visual Studio Enterprise - monthly
  • Visual Studio Enterprise - annual
  • Visual Studio Enterprise with MSDN

"Visual Studio Professional subscription" can describe:

  • Visual Studio Professional - monthly
  • Visual Studio Professional - annual
  • Visual Studio Professional with MSDN

Q: What happened to Visual Studio Online Advanced and Professional?

A: We replaced these subscriptions and will transition users automatically. If you're using your monthly Azure credits as a Visual Studio subscriber to pay for users, make sure to remove your subscription's default spending limit indefinitely. Learn more.

  • On December 1, 2015, Visual Studio Online Advanced users became Team Services users with the Test Manager extension.

    The Test Manager extension includes all the testing capabilities in Visual Studio Online Advanced. All Advanced users are now Team Services users, with Basic access, plus the Test Manager extension. Your billing now includes all Team Services users in your account and users assigned the Test Manager extension. You still get 5 free users.

    Learn more about managing extensions in your account or about manual testing with Team Services.

  • Visual Studio Online Professional users will transition to the Visual Studio Professional monthly subscription.

    While Visual Studio Online Professional purchases now appear as Visual Studio Professional monthly subscriptions on your monthly invoice, we haven't determined when users will be transitioned systematically. This transition provides an upgrade by offering access to unlimited Team Services accounts, not just one account, like Visual Studio Online Professional. The rest stays the same - monthly access to the Visual Studio Professional IDE, and pricing remains at $45 per user, per month.

    If you're buying Professional users for a specific Team Services account, which is possible only if you bought before November 2015, and want to upgrade, do this:

    1. Before the last day of the calendar month, sign in to the Azure portal. Reduce the number of paid Visual Studio Online Professional users to 0. This change will take effect on the 1st day of next month.

      This means that in the next calendar month, you won't be billed for Visual Studio Online Professional users at all.

    2. On the 1st day of the next calendar month, go to the Marketplace to buy Visual Studio Professional monthly subscriptions for the same users.

    3. Go to the Visual Studio User hub to assign the subscriptions that you bought to those users.

    4. Go to the Users hub in your Team Services account and set those users' access levels to "Visual Studio/MSDN Subscriber". This prevents disrupting services for those users.

    Learn more about Visual Studio subscriptions.

Q: Why won't my Visual Studio subscription validate?

A: There might be a delay if your Visual Studio subscription is new. Make sure that your subscription is active and valid.

If you have an MSDN subscription, make sure that subscription is linked to your Team Services sign-in address on your My Account page. Or try these sign-in troubleshooting tips. If you need more help, contact Support.

Q: What happens if I add people outside of the Users hub?

A: They'll get the next available access in this order: Basic, Stakeholder. Although you can change their access levels later, we recommend that you add users on the Users hub. That way, you control the specific access level that users get when you add them.

You can't add users outside of the Users hub if you don't have access levels available.

Q: Why do I have to add users to a directory?

A: Your Team Services account uses a directory to control access. All users must be in the directory to get access.

If you're a directory administrator, you can add users to the directory. If you're not, work with your directory administrator to add users. Learn more about controlling access with a directory.

Q: What happens if a user's subscription expires?

A: If no other access levels are available, they'll work as a stakeholder. To restore their access, they must renew their subscription.

Q: I or my team member lost access to certain features. Why did this happen?

A: This might happen for several reasons:

  • Your or your team member's Visual Studio subscription has expired. You can change the access level to Basic until the subscription is renewed.

  • The Azure subscription used for billing is no longer active. This affects all purchases made with this subscription, including Visual Studio subscriptions. To fix this problem, visit the Azure account portal.

  • The Azure subscription used for billing was unlinked from your Team Services account. To relink your account, visit the Azure classic portal or Azure portal. Or, learn more about linking your account.

Meanwhile, you or your team member can continue working as a stakeholder.

Q: How do I find out if my Team Services account uses a directory to control access?

A: Here's how:

  1. Go to your account's control panel.

    Go to control panel

  2. Go to your account settings. Check whether your account uses a directory to control access.

    Go to Settings, check for a connected directory

Learn more about setting up work access for your account with a directory. That way, you can only add users from your company's directory.

Q: My account uses a directory to control access. Can I just delete users from the directory?

A: Yes, but this removes their access to all Team Services accounts and other assets associated with that directory. You must be the directory administrator to delete a user from the directory.