Get extensions for Visual Studio Team Services

Last Update: 4/19/2017

To add new features and capabilities to your Visual Studio Team Services account, install extensions from the Visual Studio Marketplace. You can install free, preview, or paid extensions, and you can start extension trials, if they're offered.

TIP

To learn about building your own Team Services extensions, see developing and publishing extensions.

Install an extension for your Team Services account

What do I need to install extensions?

Team Services project collection administrators or account owners can install extensions. If you don't have permissions, you can request extensions instead.

Private extensions must be shared with your Team Services account to be installed. Check out the publishing documentation for information on how to share private extensions.

For paid extensions, you'll need an Azure subscription to bill your purchase. If you don't have an Azure subscription, you can create a new subscription when you make your first purchase.

NOTE

To use an existing Azure subscription for billing, you must have at least Co-administrator permissions for that subscription. If you don't have permissions, have an Azure Account Administrator or Service Administrator go to the Azure classic portal and add you as Co-administrator to the Azure subscription that you want to use for billing. Co-administrator permissions are available only in the classic Azure portal.

Your Team Services account will reuse your Azure subscription for future Visual Studio Marketplace purchases or for team services purchased through Azure, like Cloud-based Load Testing. Where can I find more info about Azure billing?

  1. Sign in to the Visual Studio Marketplace > Visual Studio Team Services.

    Visual Studio Marketplace

  2. Find and select the extension that you want to install.

  3. Based on the extension that you select, install or buy the extension.

    • For free or preview extensions, click Install.
    • For extensions that you haven't paid for access yet, click Buy.
    • For extensions that you've already paid for access, expand Buy, and select Install for paid users.

    Start Trial appears only if the extension offers a trial. Learn how to try extensions.

    Install or buy the extension

  4. Select your Team Services account to install this extension.

    Select Team Services account for this extension

  5. If you chose a paid extension, select an Azure subscription that you'll use to pay for extension access.

    For paid extensions, select an Azure subscription for billing

    Then select the number of users who will need paid access.

    Select number of users who need paid extension access

  6. Finish your installation.

  7. If you installed a paid extension like Test Manager, make sure that you assign the extension to users who need access. Otherwise, you can now go to your Team Services account to use your extension. Also, tell your team about this extension, so they can start using its capabilities too.

    Extension installed

Request extensions for your Team Services account

Don't have permissions to install extensions? You can request extensions instead.

  1. Sign in to Visual Studio Marketplace > Visual Studio Team Services.

    Visual Studio Marketplace

  2. Find and select the extension that you want to request.

  3. Try to install the extension.

    Extension details

  4. Select the Team Services account where you want to install the extension. If you don't have permissions to install the extension, you can request it now.

    Request extension

    You can review your requests after the Visual Studio Marketplace sends the request to the account owner.

    Go to requests

    Your requests appear on your Team Services account's extensions page.

    View requested extensions

    Your Team Services account owner or project collection administrator can review your request after they get it.

    Need help?

Approve extension requests for your Team Services account

If you're the Team Services project collection administrator or account owner, you'll get email when another Team Services account user requests an extension. When you approve the request, Team Services automatically installs the extension.

  1. Sign in to your Team Services account (https://{youaccount}.visualstudio.com).

  2. From your account toolbar, go to Extensions.

    Extensions tab

  3. Review and approve your requested extensions.

    Extensions tab, requested extensions

  4. After you approve extension requests, Team Services automatically installs those extensions.

  5. If you installed paid extensions, go to the next section to assign those extensions, to users who need access so they can start using those extensions.

Assign paid extension access to users

After you install a paid extension, you must assign that extension to users who need access, so they can start using that extension's capabilities. To assign extensions, you'll need Team Services project collection administrator or account owner permissions.

TIP

You only have to assign extensions to users who need access. If you have Visual Studio subscribers, they automatically get access to specific extensions that are included with their subscriptions as benefits, like Test Manager. If you installed these extensions, you don't have to assign them to Visual Studio subscribers in your account.

  1. Sign in to your Visual Studio Team Services account (https://{youraccount}.visualstudio.com).

  2. Go to Users.

    Go to Users

  3. Most extensions require that users have at least Basic access, not Stakeholder. Check your users' access levels here:

    Check that users have required access

    For example, Johnnie has a Visual Studio Enterprise subscription, which includes access to the Test Manager extension. To find the access that your extension requires, see the extension's description in the Visual Studio Marketplace.

  4. To assign the extension, go to the extension pane, for example, Test Manager.

    Go to the extension

  5. Assign the extension.

    Assign extension to users

    Extension now assigned

    You can assign the extension to one user, specific users, or to all users at the same time, up to the number allowed for free extensions or the number that you purchased for paid extensions.

  6. Tell your team about this extension, so they can start using its capabilities.

Change number of paid extension users

To scale with your team's needs, increase or decrease your total number of paid extension users. You'll need Team Services project collection administrator or account owner permissions.

IMPORTANT

To cancel access completely for a paid extension, reduce all your paid users to zero (0). How do you bill changes in users?

  1. Sign in to your Visual Studio Team Services account (https://{youraccount}.visualstudio.com).

  2. Go to Users.

    Go to Users

  3. Go to the extension pane. Change the number of extension users that you're paying for.

    Edit your total paid extension users

  4. Update your total paid extension users.

    Update total paid extension users

Uninstall or disable extensions in your Team Services account

When you don't need an extension anymore, you can uninstall or disable this extension. You'll need Team Services project collection administrator or account owner permissions.

IMPORTANT

To cancel access completely to a paid extension, you must reduce all extension users to zero (0). How do you bill changes in users?

  1. Sign in to your Team Services account (https://{youaccount}.visualstudio.com).

  2. From your account toolbar, go to Extensions.

    Extensions tab

  3. On the extensions tab, select the extension, then uninstall or disable it.

    Uninstall or disable an extension

Q&A

General

Q: What's the difference between free, preview, and paid extensions?

Extensions that are available during preview don't incur charges, aren't fully supported, and have no financially-backed service level agreements.

Paid extensions require that you buy and assign them to users who need access but don't have it already, for example, through subscription benefits. You'll use an Azure subscription to pay for an extension. If you don't have an Azure subscription, you can create a new subscription when you install your extension. If you have multiple subscriptions, you can select the Azure subscription that you want to use. Where can I find more info about Azure billing?

Q: What happened to my preview extension?

A: Your extension is no longer in preview and is now generally available as a paid extension, but offers a grace period before you have to buy the extension. All preview extensions will automatically convert to a free trial before you have to buy the extension.

Install, request, assign, and access extensions

Q: Who can install extensions for Visual Studio Team Services?

A: The Team Services account owner and project collection administrator can install extensions. If you don't have permissions, but you're an account member, you can request extensions instead.

Q: How do I find the account owner?

If you have at least Basic access, you can find the current owner in your Team Services account settings.

  1. Go to your Team Services account settings.

    Go to account settings

  2. Under Settings, find the current owner.

    Find current owner

Q: How do I find a project collection administrator?

A: If you have at least Basic access, you can find your project collection administrator in your Team Services account's security settings.

  1. Go to your Team Services account's security settings.

    Click gear button, Security

  2. Under Security, view your project collection administrators.

    Go to Project Collection Administrators, Members

Q: Why don't I see my Team Services account in the Visual Studio Marketplace?

A: If you don't see your account when buying from the Visual Studio Marketplace, try these steps:

  1. Check the identity that you use to sign in to the Visual Studio Marketplace. In the top right corner of the page, click your user name to view your profile.
  2. On the left side, make sure that your email address and directory are correct.
  3. Close all browser windows.
  4. Open a private or incognito browsing session.
  5. Sign in to the Visual Studio Marketplace with the identity that's a user in the Team Services account that you want.

    TIP

    If you're asked to choose "work or school account" or "personal account", this means you used an email address that's the same for a Microsoft account and a "work or school account" that's managed by your organization in Azure Active Directory. Although these identities have the same email address, they're still separate identities with different profiles, security settings, and permissions.

    Choose the identity that's the user in the Team Services account that you want to select.

Q: Why can't I install extensions for Team Services?

A: This might happen for these reasons:

  • If you get an error that your extension is already installed or requested, check with your project collection administrator or account owner, and ask them to assign the extension to you.

Q: When do I choose Install for paid extensions?

A: You can just choose Install when:

  • You want to install a free or preview extension.
  • You paid for access, uninstalled the extension, and want to reinstall the extension.
  • You just need the extension for Visual Studio subscribers who have access for that extension included with their subscriptions. These subscribers get specific extensions, like Test Manager, included with their subscriptions as benefits. They can use these extensions after they're installed without paid access and assignment. You only have to buy and assign extensions for users who need access.

Q: Why can't I assign extensions?

A: This might happen for several reasons.

  • You don't have at Team Services project collection administrator or account owner permissions.

  • Your users don't have the correct access levels. Most extensions require that users have Basic access, not Stakeholder. For example, the Test Manager extension requires at least Basic access.

  • You assigned all the paid extensions that you bought.

Q: Why can't users access extension features?

A: This can happen for these reasons:

  • Most extensions require that users have at least Basic access, not Stakeholder. For example, you can install the free Code Search extension, but each user must have at least Basic access to search for code. To help your team improve app quality, you can install the free Test & Feedback extension, but you'll get different capabilities based on your access level and whether you work offline or connected to Team Services or TFS. For more details, see the extension's description in the Visual Studio Marketplace.

  • If you're using a Team Services account, and you started a free extension trial, your trial might have expired. To check whether your trial expired:

    1. On your Team Services account toolbar, go to Users.
    2. Go to the extension pane.
    3. Check for an expiration message to find if or when your extension expired.

  • If you're using a Team Services account, and you paid for this extension, make sure that you assigned this extension to users.

    1. On your Team Services account toolbar, go to Users.
    2. Go to the extension pane.
    3. Check whether the extension is assigned to the user. If not, assign the extension to the user.

Learn more about assigning paid extensions to users.

Purchases & billing

Q: How does Azure billing work?

A: When you buy from the Visual Studio Marketplace, you select an Azure subscription to use for billing. If you don't have an Azure subscription, you can sign up either before or during your first purchase. You can set up payment with a credit card, or by invoice in some cases. Charges for your purchases will show up on your monthly Azure bill.

Note: You must keep your Azure subscription in good standing to use your Visual Studio Marketplace 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. To continue using your Visual Studio Marketplace purchases, please keep your Azure subscription active and updated.

Q: Can I use an Enterprise Agreement to buy from the Visual Studio Marketplace?

A: Yes, please buy directly from the Visual Studio Marketplace where you can bill purchases to the Azure subscription that was created under your Enterprise Agreement (EA). Don't order Visual Studio Marketplace services through your reseller.

Q: Can I use the Azure Monetary Commitment funds from my Enterprise Agreement to buy from the Visual Studio Marketplace?

A: Yes. You can use these prepaid funds to pay for:

You can't use these funds to pay for Visual Studio cloud subscriptions and non-Microsoft extensions for Team Services and Team Foundation Server.

Q: Can I use the Azure Free Trial to buy from the Visual Studio Marketplace?

A: No, you can't use the Azure Free Trial to pay for Visual Studio Marketplace purchases, which applies to Visual Studio Team Services, HockeyApp plans, Xamarin University, and so on. Instead, set up a separate Pay-As-You-Go Azure subscription, which you can do before or during your purchase.

Q: Can I use the monthly Azure credits from Visual Studio subscriptions or Visual Studio Dev Essentials to buy from the Visual Studio Marketplace?

A: No, you can't use the monthly Azure credits from Visual Studio subscriptions and Visual Studio Dev Essentials to pay for Visual Studio Marketplace purchases. However, you can use the included Azure subscriptions to bill your purchases. Before you make purchases, you must remove your spending limit from these subscriptions.

Spending limit

Important: Remove your spending limit indefinitely. This prevents disabling your Azure subscription when your monthly charges are billed the next month. Otherwise, all resources billed to this subscription will be suspended, including virtual machines and all other workloads.

Remove spending limit indefinitely

Q: Where can I check my bill or correct any billing information on my Azure subscription?

A: If you're the Azure account administrator, visit the Azure Account portal.

Q: How do you bill for extension purchases or changes?

A: For Microsoft extensions:

  • Your charges are prorated during the 1st month of use. After that, they renew and are billed automatically on the 1st day of the calendar month unless you cancel.

  • If you reduce users for a paid extension, those decreases won't take effect until the 1st day of the next calendar month. You're still charged for the users that you've committed for the current month.

  • If you add users for a paid extension, those increases will take effect immediately. Charges for increases are prorated, but only above the number of users that you've committed for the current month.

  • If you reduce users and add users for the same paid extension in the same month, you're not double-charged if you don't go above the number of users that you've committed for the current month.

  • If you uninstall or disable a paid extension, charges will continue unless you cancel the extension by reducing all your users to zero (0).

For non-Microsoft extensions:

  • Your charges start on the day that you purchase and renew on the same day each month until you cancel.

  • Changes to your user plan will be pro-rated on your next bill based on the number of days you were on each plan.

  • If you uninstall or disable a paid extension, charges will continue unless you cancel the extension by reducing all your users to zero (0).

Troubleshooting purchases & billing

Q: Why can't I buy extensions from Microsoft partners?

A: This might happen for these reasons:

  • Restricted countries

    In some countries, you can't use specific Azure subscriptions to buy extensions or resources from Microsoft partners in the Visual Studio Marketplace, although you can use those same subscriptions to buy extensions published by Microsoft. See Who can purchase applications and services sold/provisioned through the Azure Marketplace?

    If your country is supported in the Azure Marketplace, but not for the extension that you want to purchase, please contact the extension publisher.

  • Credit card required

    Unless you have an Enterprise Agreement, you must have a credit card associated with your Azure subscription. For example, you can't use a Pay-As-You-Go subscription that's set up for invoice billing.

    If you can't use your subscription, try using creating another Pay-As-You-Go Azure subscription with a credit card.

    NOTE

    If you get this message: "This Azure subscription doesn't have a credit card on file. Please select another subscription", select another subscription, or click Create a new Azure subscription to continue.

  • Enterprise Agreement purchases

    To buy extensions or resources from Microsoft partners in the Visual Studio Marketplace, your Azure Enterprise Agreement administrator must enable Azure Marketplace purchases. Go to the Microsoft Azure Enterprise Portal (https://ea.azure.com) > Manage > Enrollment, and enable Azure Marketplace.

    NOTE

    If you get this message: "The ordering account is not eligible to purchase from azure store using Enterprise Agreement.", have your Azure Enterprise Agreement administrator go to the Microsoft Azure Enterprise Portal (https://ea.azure.com) > Manage > Enrollment, and enable Azure Marketplace.

  • Credit card problems

    Purchases from Microsoft partners are charged immediately, not at the end of your billing cycle, like Microsoft resources. This means that if your credit card is declined for any reason, your purchase won't be completed. If this happens, try your purchase again, or contact your credit card customer service.

    NOTE

    If you get this message: "The payment provider declined the transaction. Please check your credit card information", try your purchase again later, or contact your credit card customer service.

Q: What if I already set up billing with a subscription that I can't use?

A: If your Team Services account is linked to an Azure subscription that wasn't created from an Enterprise Agreement or with a credit card on file, you'll get this message: "Your account is linked to an Azure subscription that doesn't have a credit card on file. Learn how to change your subscription."

Follow these steps to create a new Azure subscription with a credit card, then change the Azure subscription that's linked to your Team Services account.

Set up billing with a new Azure subscription

  1. Use a credit card to create a new Pay-As-You-Go Azure subscription.
  2. Follow these steps to change your Azure subscription for your Team Services account.

Q: Why is my first Azure bill larger than expected?

A: Charges for your first purchase are prorated during the 1st month and are combined with charges for the next month, which are billed on the 1st day of the calendar month. This means your first Azure bill might include these partial charges and your 1st full month.

Q: What happens if my Azure subscription is disabled?

A: If you're the Team Services account owner or Azure subscription Account Administrator, check your subscription status in the Account Center, 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: How do I get other help or support for Azure subscriptions and billing?

A: Check these topics about Azure billing and subscriptions, the Azure Billing and Subscription FAQ, or try Azure Support.

Q: How do I get support for the Visual Studio Marketplace?

A: Depending on the support you need:

Q: Can I use an Enterprise Agreement to buy from the Visual Studio Marketplace?

A: Yes, please buy directly from the Visual Studio Marketplace where you can bill purchases to the Azure subscription that was created under your Enterprise Agreement (EA). Don't order Visual Studio Marketplace services through your reseller.

Q: How can I tell whether I have the necessary privileges to buy services in the Visual Studio Marketplace through my organization's Enterprise Agreement?

A: The easiest approach to determine if you have the right privileges is to click the Buy button for a service offered in the Visual Studio Marketplace. You need to select an Azure subscription (which is a billing account) from a presented list of Azure subscriptions that are currently linked to your login. Because the name of the Azure subscription defaults to the type of billing account ("Pay-As-You-Go", "Enterprise Agreement", etc.), it is often clear if the Azure subscription is part of your Enterprise Agreement.

Another approach is to attempt to visit the Azure Enterprise Portal. If you can reach it successfully, then you already have either the Enterprise Admin or the Account Owner role. Only Account Owners can set up new Azure billing accounts in an Enterprise Agreement. If you cannot access the Azure Enterprise Portal, then please inquire within your organization to find out who your Enterprise Admin is, and ask that person to add you as an Account Owner within the Azure Enterprise Portal. If you are unable to find this person, you can submit a support ticket and request the contact information. You need your organization's name and your Enterprise Agreement enrollment number for the support ticket.