Set up billing to pay for more Visual Studio Team Services users and services

You only have to set up billing if you:

  • Need more than the amounts of free users and additional services included with your Visual Studio Team Services account.
  • Want to make purchases for your Team Services account from the Visual Studio Marketplace.

Learn more about free users and additional services for your account or buying from the Visual Studio Marketplace.

To set up billing, which happens through Microsoft Azure, link an Azure subscription to your Team Services account in the Azure classic portal or Azure portal. After you set up this link, you can pay for more Team Services users and services, like Build and Deployment or Cloud-based Load Testing. Your Azure subscription has all the necessary billing information, so you won't set this up separately for your Team Services account.

Before you start

Link an Azure subscription to your Team Services account for billing

You can follow the steps for the Azure classic portal or Azure portal. Both portals give you the same results. You can link an Azure subscription to multiple Team Services accounts. You can't link a Team Services account to multiple Azure subscriptions.

Azure classic portal

  1. Sign in to the Azure classic portal as:

    • Team Services account owner

      -and-

    • Azure Co-administrator or greater

  2. Start linking your account.

    Link your Team Services account to your Azure subscription

  3. Select your account and an Azure subscription, if you have more than one. Finish linking your account.

    Select an Azure subscription

    What do all these settings mean?

    When you're done, your account appears here and is now linked to your Azure subscription.

    Your Team Services account appears in the Azure classic portal

Azure portal

  1. Sign in to the Azure portal as:

    • Team Services account owner

      -and-

    • Azure Co-administrator or greater

  2. Select your Team Services account.

    Link your Team Services account to your Azure subscription

  3. Select an Azure subscription, if you have more than one. Finish linking your account.

    Select an Azure subscription

    When you're done, your account appears here and is now linked to your Azure subscription.

    Your account is now linked to your Azure subscription

Add Azure subscription backup administrators to manage billing

Add a Co-administrator to the Azure subscription that's linked to your Team Services account, so others can make billing changes or purchases, if necessary.

  1. Sign in to the Azure classic portal as the Azure subscription administrator.

  2. Add a Co-administrator to your Azure subscription.

    Add a Co-administrator to your Azure subscription

Learn more about how to add or change Azure administrators. If you've lost access to your Azure subscription, contact Support.

Next

Q&A

Q: How does Azure billing work?

A: When you link your Team Services account to an Azure subscription, you can select eligible Azure subscriptions where you're at least a Co-administrator. If you don't have an Azure subscription, you can either sign up, or have an Azure administrator add you as Co-Administrator to an Azure subscription that you can use to bill purchases.

Your Azure subscription is set up for payment with a credit card, or by invoice in some cases. All charges for your Team Services purchases will show up on your monthly Azure bill.

Note: You must keep your Azure subscription in good standing to use your Team Services purchases. If your Azure subscription is canceled or becomes disabled, for example, because the credit card used for payment expires, then any purchases with this Azure subscription will be deactivated on the 1st day of next month.

For example, if you purchased the Test Manager extension using an Azure subscription that becomes disabled, then Test Manager will stop working on the 1st of the following month.

To continue using your purchases, please keep your Azure subscription active and updated.

Q: Which Azure subscriptions can I link to my Team Services account?

A: You can use an Azure subscription that's not:

If you have one of these subscriptions, set up a separate Pay-As-You-Go Azure subscription instead.

Important: Some Azure subscriptions include:

  • Azure credits as a benefit. However, you can't use these credits to pay for Team Services purchases.

  • A default spending limit.

    If your Azure subscription has a spending limit, you must remove this limit indefinitely before you use your Azure subscription for billing.

    Spending limit

    This prevents disabling your Azure subscription the next month when your monthly charges are billed. Otherwise, all resources billed to this subscription will be suspended, including Visual Studio Team Services purchases, Visual Studio Marketplace purchases, and Azure resources.

    Remove spending limit indefinitely

    If you have Account Administrator permissions for your subscription, remove the spending limit by visiting the Azure Account Center:

    1. Sign in to Azure Account Center (Account > subscriptions).
    2. Select your Azure subscription.
    3. Remove your spending limit indefinitely.

    Learn more about how to manage your subscription's spending limit.

Q: How do I find the account owner?

  1. Sign in to your Team Services account (https://{youraccount}.visualstudio.com), if you haven't already.

  2. Go to your account's control panel.

    Go to account control panel

  3. Go to your account settings.

    Go to settings

Q: What are all these settings to link my Team Services account in the Azure classic portal?

A: Here's what they mean:

Q: Why can't I link my Team Services account?

A: This might happen because:

  • Only the Team Services account owner can set up billing.

  • If you don't see any accounts, maybe your account is already linked to another Azure subscription.

    Or maybe your Team Services account is connected to an Azure Active Directory (Azure AD) that's different than the currently selected directory in portal's Subscriptions list. To select another directory, open that list:

    Filter your subscriptions to the connected directory

Q: Why is my Team Services account already linked to an Azure subscription?

A: This happens if you or a previous account owner already set up your account for billing with an Azure subscription, either manually in the Azure portal or while buying items from the Visual Studio Marketplace for your account. In this scenario, you select an Azure subscription that's used to bill current and future purchases for your account.

Q: Are there restrictions that might stop me from linking my Team Services account to my Azure subscription?

A: Yes, you can link accounts in Australia East and India South only to Azure subscriptions with billing addresses in the same region. Otherwise, you'll see one of these messages:

  • "You need an Azure subscription that is valid for Team Services accounts in Australia East."

    -or-

  • "You need an Azure subscription that is valid for Team Services accounts in India South."

Q: What's a directory? Why is it connected to my account?

A: A directory helps you authenticate users and control access to assets in the cloud using Azure Active Directory (Azure AD). Here, the directory controls who can get access to your Team Services account. All account users must be in the directory to get access.

Without a directory, the Team Services account administrator is solely responsible for managing access. With a directory, the directory administrator controls who can join the directory and get access. Your Team Services account was connected to a directory by the account owner. Learn more about managing work access for your account.

Q: When do I get billed?

A: You're billed monthly but only after you've paid for users or used additional services above the free limits. Learn more about pricing here.

Q: Where can I check my bill or update billing details on my Azure subscription?

A: If you're the Azure Account Administrator, view your subscription at the Azure account portal.

Q: What if I have other questions about Azure subscriptions and billing?

A: Check the Azure Billing and Subscription FAQ, or try Azure Support.

Q: How do I stop billing?

A: Sign in to the Azure classic portal or the Azure portal as the Team Services account owner or Azure subscription administrator. Select your account, reduce the paid users to zero, and turn off any paid additional services. Your Team Services account and bill won't show any changes in paid users or Build and Deployment agents until next month when these changes take effect. You're still charged for additional services that you've already used.

Q: What happens if I unlink my Team Services account?

A: Your account goes back to 5 free users with Basic access starting next month.

  • You're still charged for paid users and for Build and Deployment agents for the current month.

  • Services, like Build and Deployment or Cloud-based Load Testing go back to the free monthly limits immediately. You're charged for any amounts you've already used.

  • Your account won't appear in the Azure portal anymore.

You can relink your account to another Azure subscription at any time.

Q: What happens if I cancel my Azure subscription?

A: Your Team Services account goes back to the free monthly limits, but you'll keep any paid users or Build and Deployment agents until next month. Your account stays linked to your subscription until you unlink your account, or until your account unlinks automatically when your subscription is disabled.

Q: What happens if my Azure subscription is disabled?

A: If you're the Team Services account owner, check your subscription status here, then try to fix your subscription. This will restore your account's paid settings. Or you can link your Team Services account to another Azure subscription by unlinking your account from the disabled subscription. While your subscription is disabled, your account goes back to the free monthly limits until your subscription is fixed.

Q: What happens if my credit card expires?

A: Your Team Services account goes back to the free monthly limits, but you'll keep any paid users or Build and Deployment agents until next month. Your Azure subscription will eventually become disabled, but fixing this issue reactivates your subscription and restores your account's paid settings.