Set up billing for your Visual Studio Team Services account

You only need to set up billing if your needs exceed the free amount of users or additional services that we include with your account. See the details in our Visual Studio Team Services Feature Matrix.

Billing happens through Microsoft Azure. To set up billing and make purchases for your account, link an active Azure subscription to your account in the Azure management portal or the Azure preview portal. After you set up this link, you can pay for users and additional services, like Build and Deployment or Cloud-based Load Testing.

Your Azure subscription has the necessary billing information; you won't set this up separately for Visual Studio Team Services.

Before you start

If you haven't already, sign up for an Azure subscription as the Visual Studio Team Services account owner. Can I use my Azure MSDN subscription?

Link your Visual Studio Team Services account to your Azure subscription

Follow the steps below for the Azure management portal or the steps for the Azure preview portal. Both portals give you the same results. You can link multiple Visual Studio Team Services accounts to an Azure subscription.

Azure management portal

  1. Sign in to the Azure management portal as the Visual Studio Team Services account owner.

  2. Start linking your account.

    Link your Visual Studio Team Services account to your Azure subscription

  3. Select your account and an Azure subscription, if you own more than one. For example:

    Select an Azure subscription

    What do all these settings mean?

    After you're done, your account appears in the Azure management portal.

    Your Visual Studio Team Services account appears in the Azure management portal

Azure preview portal

  1. Sign in to the Azure preview portal as the Visual Studio Team Services account owner.

  2. Select your Visual Studio Team Services account.

    Link your Visual Studio 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

    Your account is now linked to your Azure subscription.

    Your account is now linked to your Azure subscription

Add a backup administrator to manage billing

This way, other users can make billing changes, if necessary.

Add a backup administrator to your Azure subscription

Don't have a backup administrator for your Azure subscription? Contact Support to regain access.

Try this next

Q&A

Q: Can I use my Azure MSDN subscription for purchases?

A: Yes, but you can't use the monthly Azure credit that you get as an Azure MSDN subscription benefit for purchases.

To use the subscription for billing, first remove the spending limit. All charges for Visual Studio Team Services will be billed to the credit card that you use (or invoiced if you set up invoicing).

Important: Remove your spending limit indefinitely. 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 - not just for paid access and additional services in your Visual Studio Team Services account, but Visual Studio subscriptions and Azure resources too.

Remove spending limit indefinitely

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

A: Here's what they mean:

  • URL: The Visual Studio Team Services accounts that you own. Why don't I see any accounts?

  • Directory: The directory, if any, that's connected to your Visual Studio Team Services account. What's a directory? Why is it connected to my account?

  • Subscription: Appears only when you have more than one Azure subscription. These subscriptions are filtered by the directories selected in the Azure management portal's Subscriptions list:

    Subscriptions filter

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

A: This might happen because:

  • Only the Visual Studio Team Services account owner can set up billing. How do I find the account owner?

  • If you don't see any accounts, maybe your account is linked to another Azure subscription. Or maybe your account is connected to a directory that's different than the one selected in the Azure preview portal's Subscriptions list. To select another directory, open that list.

    Filter your subscriptions to the connected directory

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

A: Yes, you can link accounts in Australia East only to Azure subscriptions with billing addresses in Australia and New Zealand. Otherwise, you'll see this message:

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

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 Visual Studio Team Services account. All account users must be in the directory to get access. This works like an extra security layer.

Without a directory, the Visual Studio 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 Visual Studio Team Services account was connected to a directory by the account owner. Learn more about managing work access for your account.

Q: How 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.

Q: Where can I check my bill?

A: If you're the Azure subscription owner or an Azure administrator, check your bill here.

Q: How do I stop billing?

A: Sign in to the Azure management portal or the Azure preview portal as the Visual Studio 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 Visual Studio 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 Visual Studio 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 preview 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 Visual Studio 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 Visual Studio 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 Visual Studio 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 Visual Studio 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.

Q: What if I have other questions about my bill or Azure subscription?

A: Please contact Support.