diff --git a/docs/ide/file-nesting-solution-explorer.md b/docs/ide/file-nesting-solution-explorer.md index c076117438e..5fb4500e1ee 100644 --- a/docs/ide/file-nesting-solution-explorer.md +++ b/docs/ide/file-nesting-solution-explorer.md @@ -1,7 +1,7 @@ --- title: File nesting rules for Solution Explorer description: Discover Solution Explorer in Visual Studio and review how to work with file nesting rules, presets, and customization for project-specific settings. -ms.date: 6/4/2025 +ms.date: 04/15/2026 ms.topic: how-to helpviewer_keywords: - "file nesting" @@ -21,7 +21,13 @@ ms.subservice: general-ide ## File nesting options +:::moniker range="visualstudio" +![Screenshot that shows the button for turning file nesting on and off.](media/visualstudio/file-nesting-on-off.png) +:::moniker-end + +:::moniker range="vs-2022" ![Button for turning file nesting on/off](media/filenesting_onoff.png) +:::moniker-end The available options for non-customized file nesting are: @@ -31,17 +37,42 @@ The available options for non-customized file nesting are: * **Web**: This option applies the **Web** file nesting behavior to all the projects in the current solution. It has numerous rules, and we encourage you to check it out and tell us what you think. The following screenshot highlights just a few examples of the file nesting behavior that you get with this option: + :::moniker range="visualstudio" + ![Screenshot that shows file nesting in Solution Explorer.](media/visualstudio/file-nesting.png) + :::moniker-end + + :::moniker range="vs-2022" ![File nesting in Solution Explorer](media/filenesting.png) + :::moniker-end ## Customize file nesting + + +:::moniker range="visualstudio" +If you don’t like what you get out-of-the-box, you can create your own, custom file nesting settings that instruct **Solution Explorer** how to nest files. You can add as many custom file nesting settings as you like, and you can switch between them as desired. To create a new custom setting, you can start with an empty file, or you can use the **Default** settings as your starting point: + +![Screenshot that shows the Add Custom File Nesting Settings dialog.](media/visualstudio/file-nesting-add-custom.png) + +We recommend you use **Default** settings as your starting point because it’s easier to work with something that already functions. If you use the **Default** settings as your starting point, the *.filenesting.json* file looks similar to the following file: + +:::moniker-end + +:::moniker range="vs-2022" If you don’t like what you get out-of-the-box, you can create your own, custom file nesting settings that instruct **Solution Explorer** how to nest files. You can add as many custom file nesting settings as you like, and you can switch between them as desired. To create a new custom setting, you can start with an empty file, or you can use the **Web** settings as your starting point: ![Add custom file nesting rules](media/filenesting_addcustom.png) We recommend you use **Web** settings as your starting point because it’s easier to work with something that already functions. If you use the **Web** settings as your starting point, the *.filenesting.json* file looks similar to the following file: +:::moniker-end + +:::moniker range="visualstudio" +![Screenshot that shows nesting rule providers in a custom settings file.](media/visualstudio/file-nesting-edit-custom.png) +:::moniker-end +:::moniker range="vs-2022" ![Use existing file nesting rules as the basis for custom settings](media/filenesting_editcustom.png) +:::moniker-end Let’s focus on the node **dependentFileProviders** and its child nodes. Each child node is a type of rule that Visual Studio can use to nest files. For example, **having the same filename, but a different extension** is one type of rule. The available rules are: @@ -61,29 +92,45 @@ Let’s focus on the node **dependentFileProviders** and its child nodes. Each c This provider lets you define file nesting rules using specific file extensions. Consider the following example: +:::moniker range="visualstudio" +![Screenshot that shows an extentionToExtension rule.](media/visualstudio/file-nesting-extensiontoextension.png) + +![Screenshot that shows the effect of the extensionToExtension rule.](media/visualstudio/file-nesting-extensiontoextension-effect.png) +:::moniker-end + +:::moniker range="vs-2022" ![extentionToExtension example rules](media/filenesting_extensiontoextension.png) ![extentionToExtension example effect](media/filenesting_extensiontoextension_effect.png) +:::moniker-end -* *cart.js* is nested under *cart.ts* because of the first **extensionToExtension** rule +* *file.js* is nested under *file.ts* because of the first **extensionToExtension** rule. -* *cart.js* is not nested under *cart.tsx* because `.ts` comes before `.tsx` in the rules, and there can only be one parent +* *file.js* isn't nested under *file.tsx* because `.ts` comes before `.tsx` in the rules, and there can only be one parent. -* *light.css* is nested under *light.sass* because of the second **extensionToExtension** rule +* *light.css* is nested under *light.sass* because of the second **extensionToExtension** rule. -* *home.html* is nested under *home.md* because of the third **extensionToExtension** rule +* *home.html* is nested under *home.md* because of the third **extensionToExtension** rule. ### The fileSuffixToExtension provider This provider works just like the **extensionToExtension** provider, with the only difference being that the rule looks at the suffix of the file instead of just the extension. Consider the following example: +:::moniker range="visualstudio" +![Screenshot that shows a fileSuffixToExtension rule.](media/visualstudio/file-nesting-filesuffixtoextension.png) + +![Screenshot that shows the effect of the fileSuffixToExtension rule.](media/visualstudio/file-nesting-filesuffixtoextension-effect.png) +:::moniker-end + +:::moniker range="vs-2022" ![fileSuffixToExtension example rules](media/filenesting_filesuffixtoextension.png) ![fileSuffixToExtension example effect](media/filenesting_filesuffixtoextension_effect.png) +:::moniker-end -* *portal-vsdoc.js* is nested under *portal.js* because of the **fileSuffixToExtension** rule +* *portal-vsdoc.js* is nested under *portal.js* because of the **fileSuffixToExtension** rule. -* every other aspect of the rule works the same way as **extensionToExtension** +* Every other aspect of the rule works the same way as **extensionToExtension**. ### The addedExtension provider @@ -91,11 +138,23 @@ This provider nests files with an additional extension under the file without an Consider the following example: +:::moniker range="visualstudio" + +![Screenshot that shows the addedextension rule.](media/visualstudio/file-nesting-addedextension.png) + +![Screenshot that shows the effect of the addedextension rule.](media/visualstudio/file-nesting-addedextension-effect.png) + +:::moniker-end + +:::moniker range="vs-2022" + ![addedExtension example rules](media/filenesting_addedextension.png) ![addedExtension example effect](media/filenesting_addedextension_effect.png) -* *file.html.css* is nested under *file.html* because of the **addedExtension** rule +:::moniker-end + +* *file.html.css* is nested under *file.html* because of the **addedExtension** rule. > [!NOTE] > You don't specify any file extensions for the `addedExtension` rule; it automatically applies to all file extensions. That is, any file with the same name and extension as another file plus an additional extension on the end is nested under the other file. You can't limit the effect of this provider to just specific file extensions. @@ -106,11 +165,19 @@ This provider nests files with an additional extension under a file without an a Consider the following example: +:::moniker range="visualstudio" +![Screenshot that shows a pathSegment rule.](media/visualstudio/file-nesting-pathsegment.png) + +![Screenshot that shows the effect of the pathSegment rule.](media/visualstudio/file-nesting-pathsegment-effect.png) +:::moniker-end + +:::moniker range="vs-2022" ![pathSegment example rules](media/filenesting_pathsegment.png) ![pathSegment example effect](media/filenesting_pathsegment_effect.png) +:::moniker-end -* *jquery.min.js* is nested under *jquery.js* because of the **pathSegment** rule +* *jquery.min.js* is nested under *jquery.js* because of the **pathSegment** rule. > [!NOTE] > - If you don't specify any specific file extensions for the `pathSegment` rule, it applies to all file extensions. That is, any file with the same name and extension as another file plus an additional extension in the middle is nested under the other file. @@ -133,21 +200,37 @@ Consider the following example: This provider lets you define file nesting rules for files with any extension but the same base file name. Consider the following example: +:::moniker range="visualstudio" +![Screenshot that shows the allExtensions rule.](media/visualstudio/file-nesting-allextensions.png) + +![Screenshot that shows the effect of the allExtensions rule.](media/visualstudio/file-nesting-allextensions-effect.png) +:::moniker-end + +:::moniker range="vs-2022" ![allExtensions example rules](media/filenesting_allextensions.png) ![allExtensions example effect](media/filenesting_allextensions_effect.png) +:::moniker-end -* *template.cs* and *template.doc* are nested under *template.tt* because of the **allExtensions** rule. +* *Template.cs* and *Template.doc* are nested under *Template.tt* because of the **allExtensions** rule. ### The fileToFile provider This provider lets you define file nesting rules based on entire filenames. Consider the following example: +:::moniker range="visualstudio" +![Screenshot that shows a fileToFile rule.](media/visualstudio/file-nesting-filetofile.png) + +![Screenshot that shows the effect of the fileToFile rule.](media/visualstudio/file-nesting-filetofile-effect.png) +:::moniker-end + +:::moniker range="vs-2022" ![fileToFile example rules](media/filenesting_filetofile.png) ![fileToFile example effect](media/filenesting_filetofile_effect.png) +:::moniker-end -* *.bowerrc* is nested under *bower.json* because of the **fileToFile** rule +* *file.npmrc* is nested under *package.json* because of the **fileToFile** rule. ### Rule order @@ -159,13 +242,26 @@ Ordering is also important for rule sections themselves, not just for files with You can manage all settings, including your own custom settings, through the same button in **Solution Explorer**: + +:::moniker range="visualstudio" +![Screenshot that shows the menu items for activating custom file nesting rules.](media/visualstudio/file-nesting-activate-custom.png) +:::moniker-end + +:::moniker range="vs-2022" ![Activate custom file nesting rules](media/filenesting_activatecustom.png) +:::moniker-end ## Create project-specific settings +:::moniker range="visualstudio" +You can create solution-specific and project-specific settings by adding a *.filenesting.json* file to the solution root or project root folder. +:::moniker-end + +:::moniker range="vs-2022" You can create solution-specific and project-specific settings through the right-click menu (context menu) of each solution and project: ![Solution and project-specific nesting rules](media/filenesting_solutionprojectspecific.png) +:::moniker-end Solution-specific and project-specific settings are combined with the active Visual Studio settings. For example, you may have a blank project-specific settings file, but **Solution Explorer** is still nesting files. The nesting behavior is coming from either the solution-specific settings or the Visual Studio settings. The precedence for merging file nesting settings is: Visual Studio > Solution > Project. diff --git a/docs/ide/media/visualstudio/file-nesting-activate-custom.png b/docs/ide/media/visualstudio/file-nesting-activate-custom.png new file mode 100644 index 00000000000..9cab0f16855 Binary files /dev/null and b/docs/ide/media/visualstudio/file-nesting-activate-custom.png differ diff --git a/docs/ide/media/visualstudio/file-nesting-add-custom.png b/docs/ide/media/visualstudio/file-nesting-add-custom.png new file mode 100644 index 00000000000..bf03397a4df Binary files /dev/null and b/docs/ide/media/visualstudio/file-nesting-add-custom.png differ diff --git a/docs/ide/media/visualstudio/file-nesting-addedextension-effect.png b/docs/ide/media/visualstudio/file-nesting-addedextension-effect.png new file mode 100644 index 00000000000..d1d4bb30d7c Binary files /dev/null and b/docs/ide/media/visualstudio/file-nesting-addedextension-effect.png differ diff --git a/docs/ide/media/visualstudio/file-nesting-addedextension.png b/docs/ide/media/visualstudio/file-nesting-addedextension.png new file mode 100644 index 00000000000..e3c40669ceb Binary files /dev/null and b/docs/ide/media/visualstudio/file-nesting-addedextension.png differ diff --git a/docs/ide/media/visualstudio/file-nesting-allextensions-effect.png b/docs/ide/media/visualstudio/file-nesting-allextensions-effect.png new file mode 100644 index 00000000000..c854d53ef11 Binary files /dev/null and b/docs/ide/media/visualstudio/file-nesting-allextensions-effect.png differ diff --git a/docs/ide/media/visualstudio/file-nesting-allextensions.png b/docs/ide/media/visualstudio/file-nesting-allextensions.png new file mode 100644 index 00000000000..45a6a001bc6 Binary files /dev/null and b/docs/ide/media/visualstudio/file-nesting-allextensions.png differ diff --git a/docs/ide/media/visualstudio/file-nesting-edit-custom.png b/docs/ide/media/visualstudio/file-nesting-edit-custom.png new file mode 100644 index 00000000000..f8473a13c7b Binary files /dev/null and b/docs/ide/media/visualstudio/file-nesting-edit-custom.png differ diff --git a/docs/ide/media/visualstudio/file-nesting-extensiontoextension-effect.png b/docs/ide/media/visualstudio/file-nesting-extensiontoextension-effect.png new file mode 100644 index 00000000000..9d5b71fa16c Binary files /dev/null and b/docs/ide/media/visualstudio/file-nesting-extensiontoextension-effect.png differ diff --git a/docs/ide/media/visualstudio/file-nesting-extensiontoextension.png b/docs/ide/media/visualstudio/file-nesting-extensiontoextension.png new file mode 100644 index 00000000000..db8c851cc94 Binary files /dev/null and b/docs/ide/media/visualstudio/file-nesting-extensiontoextension.png differ diff --git a/docs/ide/media/visualstudio/file-nesting-filesuffixtoextension-effect.png b/docs/ide/media/visualstudio/file-nesting-filesuffixtoextension-effect.png new file mode 100644 index 00000000000..02d5734f32c Binary files /dev/null and b/docs/ide/media/visualstudio/file-nesting-filesuffixtoextension-effect.png differ diff --git a/docs/ide/media/visualstudio/file-nesting-filesuffixtoextension.png b/docs/ide/media/visualstudio/file-nesting-filesuffixtoextension.png new file mode 100644 index 00000000000..3b91483a2c1 Binary files /dev/null and b/docs/ide/media/visualstudio/file-nesting-filesuffixtoextension.png differ diff --git a/docs/ide/media/visualstudio/file-nesting-filetofile-effect.png b/docs/ide/media/visualstudio/file-nesting-filetofile-effect.png new file mode 100644 index 00000000000..969c30d704b Binary files /dev/null and b/docs/ide/media/visualstudio/file-nesting-filetofile-effect.png differ diff --git a/docs/ide/media/visualstudio/file-nesting-filetofile.png b/docs/ide/media/visualstudio/file-nesting-filetofile.png new file mode 100644 index 00000000000..7fcf10546b0 Binary files /dev/null and b/docs/ide/media/visualstudio/file-nesting-filetofile.png differ diff --git a/docs/ide/media/visualstudio/file-nesting-on-off.png b/docs/ide/media/visualstudio/file-nesting-on-off.png new file mode 100644 index 00000000000..fef040e8918 Binary files /dev/null and b/docs/ide/media/visualstudio/file-nesting-on-off.png differ diff --git a/docs/ide/media/visualstudio/file-nesting-pathsegment-effect.png b/docs/ide/media/visualstudio/file-nesting-pathsegment-effect.png new file mode 100644 index 00000000000..e5f0a57f892 Binary files /dev/null and b/docs/ide/media/visualstudio/file-nesting-pathsegment-effect.png differ diff --git a/docs/ide/media/visualstudio/file-nesting-pathsegment.png b/docs/ide/media/visualstudio/file-nesting-pathsegment.png new file mode 100644 index 00000000000..1a4d8330a8b Binary files /dev/null and b/docs/ide/media/visualstudio/file-nesting-pathsegment.png differ diff --git a/docs/ide/media/visualstudio/file-nesting.png b/docs/ide/media/visualstudio/file-nesting.png new file mode 100644 index 00000000000..c8fcba8d9b9 Binary files /dev/null and b/docs/ide/media/visualstudio/file-nesting.png differ diff --git a/subscriptions/about-benefits.md b/subscriptions/about-benefits.md index 16360d07864..fd634f3df92 100644 --- a/subscriptions/about-benefits.md +++ b/subscriptions/about-benefits.md @@ -1,11 +1,11 @@ --- -title: Understand benefits in Visual Studio subscriptions +title: Understand benefits in Visual Studio Subscriptions author: joseb-rdc ms.author: amast -ms.manager: shve -ms.date: 12/31/2025 +ms.manager: shve +ms.date: 04/28/2026 ms.topic: how-to -description: Explore benefits included in Visual Studio subscriptions, including benefits provided by partners, and how to activate the benefits. +description: Explore benefits included in Visual Studio Subscriptions, including benefits provided by partners, and how to activate the benefits. --- # About your subscription benefits @@ -13,15 +13,7 @@ description: Explore benefits included in Visual Studio subscriptions, including > [!div class="nextstepaction"] > **Get started:** View and activate your benefits in the **Subscriber portal** at https://my.visualstudio.com/benefits -## What's on this page - -+ **How benefits differ** based on your subscription level and how they might change over time. -+ **How to browse and filter benefits** by category to quickly find what applies to your subscription. -+ **How partner-provided benefits work**, including variations in duration, support, and availability. - -As a Visual Studio subscriber, the benefits available to you depend on your subscription level. Some benefits might change during your subscription as offers are added, updated, or retired. - -+ Visual Studio Subscription benefits might change over time, including during the lifetime of an active subscription. We regularly review and update benefits to ensure they remain current and aligned with program goals and partner offerings. As a result, benefits might be added, updated, or discontinued. +As a Visual Studio subscriber, the benefits available to you depend on your subscription level and might change over time, including during the lifetime of an active subscription. We regularly review and update benefits to keep them current and aligned with partner offerings and program requirements. As a result, benefits might be added, updated, or discontinued. ## Benefits vary based on your subscription @@ -45,9 +37,9 @@ When you visit , all benefits appear by de ## Benefits and offers provided by partners Some benefits—such as training, tools, and services—are provided by partners. Details for these offers vary. For example: -+ The duration of the benefit might not match the duration of your Visual Studio subscription. You might have a 12-month Visual Studio subscription, while many of the partner-provided benefits might last for a shorter term, such as three or six months. ++ The duration of the benefit might not match the duration of your Visual Studio Subscription. You might have a 12-month Visual Studio Subscription, while many of the partner-provided benefits might last for a shorter term, such as three or six months. + Any support available for those benefits or offers is also provided by the partners. -+ Some benefits renew when your Visual Studio subscription is renewed. In other cases, the partner offer is "once in a lifetime" and doesn't renew. ++ Some benefits renew when your Visual Studio Subscription is renewed. In other cases, the partner offer is "once in a lifetime" and doesn't renew. For more information about individual benefits, check out the corresponding article in the table of contents. + Partner-provided benefits are offered and fulfilled at the discretion of the partner. A claim or attempted redemption by a subscriber doesn't guarantee fulfillment; if the partner discontinues or can't provide the benefit, it might not be delivered. @@ -55,11 +47,11 @@ For more information on each benefit, see the corresponding article in the table ## Benefits that become temporarily unavailable -In rare cases, a benefit might become temporarily unavailable due to technical issues. When such issues happen, the benefit tile in the [Visual Studio subscription portal](https://my.visualstudio.com/benefits) displays **"Temporarily Unavailable"**. The benefit is restored once the issue is resolved. +In rare cases, a benefit might become temporarily unavailable due to technical issues. When such issues happen, the benefit tile in the [Visual Studio Subscription portal](https://my.visualstudio.com/benefits) displays **"Temporarily Unavailable"**. The benefit is restored once the issue is resolved. ## Support resources -For help with sales, subscriptions, accounts, or billing for Visual Studio subscriptions, contact [Visual Studio subscription support](https://aka.ms/vssubscriberhelp). +For help with sales, subscriptions, accounts, or billing for Visual Studio Subscriptions, contact [Visual Studio Subscription support](https://aka.ms/vssubscriberhelp). ## Frequently asked questions @@ -83,4 +75,4 @@ A: Some do, others don’t. Check each benefit’s documentation for renewal det + Thinking about purchasing a subscription? Check out our pricing page for a detailed list of what benefits are included in each subscription. You can also use the [Visual Studio Subscription benefits page](https://visualstudio.microsoft.com/vs/benefits/) to see more detailed information. + Already have a subscription? Learn how to activate and use individual benefits by reviewing benefit-specific articles in our documentation, including help if needed. -+ Want to learn how to get more value from your benefits? Watch the YouTube video "[Get the most of Azure with your Visual Studio subscription](https://www.youtube.com/watch?v=DqKa-hDoCl4)" to explore how your subscription helps you innovate and be more productive. \ No newline at end of file ++ Want to learn how to get more value from your benefits? Watch the YouTube video "[Get the most of Azure with your Visual Studio Subscription](https://www.youtube.com/watch?v=DqKa-hDoCl4)" to explore how your subscription helps you innovate and be more productive. \ No newline at end of file diff --git a/subscriptions/media/buy-vs-subscriptions/add-cloud-user.png b/subscriptions/media/buy-vs-subscriptions/add-cloud-user.png new file mode 100644 index 00000000000..eb19036838d Binary files /dev/null and b/subscriptions/media/buy-vs-subscriptions/add-cloud-user.png differ diff --git a/subscriptions/media/buy-vs-subscriptions/buy-visual-studio-sub-azure-sub.png b/subscriptions/media/buy-vs-subscriptions/buy-visual-studio-sub-azure-sub.png new file mode 100644 index 00000000000..4c5edcba185 Binary files /dev/null and b/subscriptions/media/buy-vs-subscriptions/buy-visual-studio-sub-azure-sub.png differ diff --git a/subscriptions/media/buy-vs-subscriptions/buy-vs-sub-users.png b/subscriptions/media/buy-vs-subscriptions/buy-vs-sub-users.png new file mode 100644 index 00000000000..ade7d84eb15 Binary files /dev/null and b/subscriptions/media/buy-vs-subscriptions/buy-vs-sub-users.png differ diff --git a/subscriptions/media/buy-vs-subscriptions/cloud-change-quantity.png b/subscriptions/media/buy-vs-subscriptions/cloud-change-quantity.png new file mode 100644 index 00000000000..35df71d600a Binary files /dev/null and b/subscriptions/media/buy-vs-subscriptions/cloud-change-quantity.png differ diff --git a/subscriptions/media/buy-vs-subscriptions/cloud-confirm-reduce.png b/subscriptions/media/buy-vs-subscriptions/cloud-confirm-reduce.png new file mode 100644 index 00000000000..dcf66f06cdc Binary files /dev/null and b/subscriptions/media/buy-vs-subscriptions/cloud-confirm-reduce.png differ diff --git a/subscriptions/media/buy-vs-subscriptions/cloud-expires-warning.png b/subscriptions/media/buy-vs-subscriptions/cloud-expires-warning.png new file mode 100644 index 00000000000..776a6de8ad8 Binary files /dev/null and b/subscriptions/media/buy-vs-subscriptions/cloud-expires-warning.png differ diff --git a/subscriptions/media/buy-vs-subscriptions/cloud-manage-users.png b/subscriptions/media/buy-vs-subscriptions/cloud-manage-users.png new file mode 100644 index 00000000000..8ad48b421a9 Binary files /dev/null and b/subscriptions/media/buy-vs-subscriptions/cloud-manage-users.png differ diff --git a/subscriptions/media/buy-vs-subscriptions/cloud-reduce-paid-users.png b/subscriptions/media/buy-vs-subscriptions/cloud-reduce-paid-users.png new file mode 100644 index 00000000000..ae32d4fe629 Binary files /dev/null and b/subscriptions/media/buy-vs-subscriptions/cloud-reduce-paid-users.png differ diff --git a/subscriptions/media/buy-vs-subscriptions/cloud-self-assign.png b/subscriptions/media/buy-vs-subscriptions/cloud-self-assign.png new file mode 100644 index 00000000000..fe3e4d45bea Binary files /dev/null and b/subscriptions/media/buy-vs-subscriptions/cloud-self-assign.png differ diff --git a/subscriptions/media/buy-vs-subscriptions/overview-button.png b/subscriptions/media/buy-vs-subscriptions/overview-button.png new file mode 100644 index 00000000000..768490229e6 Binary files /dev/null and b/subscriptions/media/buy-vs-subscriptions/overview-button.png differ diff --git a/subscriptions/vscloud-overview.md b/subscriptions/vscloud-overview.md index 197fa46887e..6933763edb2 100644 --- a/subscriptions/vscloud-overview.md +++ b/subscriptions/vscloud-overview.md @@ -2,21 +2,21 @@ title: Purchase Visual Studio cloud subscriptions author: joseb-rdc ms.author: amast -ms.manager: shve -ms.date: 01/09/2026 +ms.manager: shve +ms.date: 04/28/2026 ms.topic: overview -description: Purchase (rent) Visual Studio Professional or Visual Studio Enterprise on a month-to-month or annual basis, with no long-term contract. +description: Purchase (rent) Visual Studio Enterprise or Visual Studio Professional on a month-to-month basis, with no long-term contract. ms.custom: sfi-image-nochange --- -# Buy Visual Studio Professional and Visual Studio Enterprise cloud subscriptions +# Buy Visual Studio Enterprise and Visual Studio Professional cloud subscriptions -You can buy [Visual Studio Professional and Visual Studio Enterprise subscriptions](https://visualstudio.microsoft.com/subscriptions/) from the [Visual Studio Marketplace](https://marketplace.visualstudio.com). These subscriptions are called **"cloud subscriptions"**. +You can buy [Visual Studio Enterprise and Visual Studio Professional subscriptions](https://visualstudio.microsoft.com/subscriptions/) from the [Visual Studio Marketplace](https://marketplace.visualstudio.com). These subscriptions are called **"cloud subscriptions"**. [Compare cloud subscription benefits and pricing](https://visualstudio.microsoft.com/vs/pricing/). > [!NOTE] -> Microsoft no longer offers Visual Studio Professional Annual subscriptions and Visual Studio Enterprise Annual subscriptions in Cloud Subscriptions. There's no change to existing customers' experience and ability to renew, increase, decrease, or cancel their subscriptions. New customers are encouraged to go to [https://visualstudio.microsoft.com/vs/pricing/](https://visualstudio.microsoft.com/vs/pricing/) to explore different options to purchase Visual Studio. You can still purchase new monthly cloud subscriptions. +> Microsoft no longer offers Visual Studio Enterprise Annual subscriptions and Visual Studio Professional Annual subscriptions in Cloud Subscriptions. There's no change to existing customers' experience and ability to renew, increase, decrease, or cancel their subscriptions. New customers are encouraged to go to [https://visualstudio.microsoft.com/vs/pricing/](https://visualstudio.microsoft.com/vs/pricing/) to explore different options to purchase Visual Studio. You can still purchase new monthly cloud subscriptions. ## Before you start @@ -24,7 +24,7 @@ To bill your purchases, you need an [Azure subscription](https://azure.microsoft ## Who can buy Visual Studio cloud subscriptions? -You need to be a contributor or higher for an Azure subscription that was created for your EA subscription to purchase cloud subscriptions. +You can buy Visual Studio cloud subscriptions through the Visual Studio Marketplace if you have an Azure subscription for billing and are assigned **Contributor access or higher** on that subscription. ## How to buy cloud subscriptions @@ -34,52 +34,48 @@ You need to be a contributor or higher for an Azure subscription that was create 3. Select the "pay-as-you-go" Azure subscription to use for billing. You can create a new Azure subscription if you don't have one. > [!div class="mx-imgBorder"] - > [![Select Azure subscription for billing](_img/buy-vs-subscriptions/buy-vs-sub-Azure-sub.png "Screenshot of the monthly subscription purchase dialog. The Billing blade is selected.")](_img/buy-vs-subscriptions/buy-vs-sub-Azure-sub.png#lightbox) + > [![Select Azure subscription for billing](media/buy-vs-subscriptions/buy-visual-studio-sub-azure-sub.png "Screenshot of the monthly subscription purchase dialog. The Billing blade is selected.")](media/buy-vs-subscriptions/buy-visual-studio-sub-azure-sub.png#lightbox) -4. Select the number of subscriptions to buy. +4. Select the number of subscriptions to buy and continue. > [!div class="mx-imgBorder"] - > [![Select number of subscriptions](_img/buy-vs-subscriptions/buy-vs-sub-users.png "Screenshot of the monthly subscription purchase dialog. The Continue button is highlighted.")](_img/buy-vs-subscriptions/buy-vs-sub-users.png#lightbox) + > [![Select number of subscriptions](media/buy-vs-subscriptions/buy-vs-sub-users.png "Screenshot of the monthly subscription purchase dialog. The Continue button is highlighted.")](media/buy-vs-subscriptions/buy-vs-sub-users.png#lightbox) - If you don't want subscriptions assigned to yourself, don't select the **Assign this subscription to me** button during the purchase flow. - -5. Confirm and finish your purchase. If you assigned a subscription to yourself, you can visit the [Visual Studio subscription portal](https://my.visualstudio.com) -to start downloading software and using other subscriber benefits. +5. After the purchase is complete, assign the subscription by selecting **Assign one subscription to me** or select **Manage users** to assign the subscription to another user. > [!div class="mx-imgBorder"] - > [![Finish purchase successfully](_img/buy-vs-subscriptions/cloud-self-assign.png "Screenshot of a monthly subscription purchase confirmation dialog showing the purchase of one subscription and Assign one subscription to me option.")](_img/buy-vs-subscriptions/cloud-self-assign.png#lightbox) - -6. Select **Manage users** to open the subscription portal and begin using your subscription. + > [![Finish purchase successfully](media/buy-vs-subscriptions/cloud-self-assign.png "Screenshot of a monthly subscription purchase confirmation dialog showing the purchase of one subscription and Assign one subscription to me option.")](media/buy-vs-subscriptions/cloud-self-assign.png#lightbox) - If you purchased more than one subscription, you can proceed to the - [Visual Studio Subscriptions Admin portal](https://manage.visualstudio.com) to assign subscriptions to others. You might need to [add your new subscriptions](add-monthly-subs.md) to the Admin Portal if this purchase is your first. +To assign subscriptions to other users, select **Manage users**. This action opens the Visual Studio Admin portal where you can assign subscriptions to others. > [!div class="mx-imgBorder"] - > [![Assign subscriptions to others](_img/buy-vs-subscriptions/cloud-manage-users.png "Screenshot of a monthly subscription purchase dialog. 'Manage users' button is highlighted.")](_img/buy-vs-subscriptions/cloud-manage-users.png#lightbox) + > [![Assign subscriptions to others](media/buy-vs-subscriptions/cloud-manage-users.png "Screenshot of a monthly subscription purchase dialog. 'Manage users' button is highlighted.")](media/buy-vs-subscriptions/cloud-manage-users.png#lightbox) + +You can also proceed to the [Visual Studio Subscriptions Admin portal](https://manage.visualstudio.com) to assign subscriptions to others. You might need to [add your new subscriptions](add-monthly-subs.md) to the Admin Portal if this purchase is your first. > [!div class="mx-imgBorder"] - > [![View subscriptions](_img/buy-vs-subscriptions/add-cloud-user.png "Screenshot of the Visual Studio subscriptions management portal. The Add blade is highlighted. Select 'Individual subscriber' to assign subscriptions to users.")](_img/buy-vs-subscriptions/add-cloud-user.png#lightbox) + > [![Manage subscribers](media/buy-vs-subscriptions/add-cloud-user.png "Screenshot of the Visual Studio Admin portal with the Add Individual Subscriber highlighted.")](media/buy-vs-subscriptions/add-cloud-user.png#lightbox) ## Cancel renewals of cloud subscriptions you previously purchased -To cancel subscriptions, and if you're an admin, you just need to set the number of subscriptions for your agreement to zero (0). Follow these steps to reduce the number of subscriptions: +To cancel cloud subscriptions, and if you're an admin, you just need to set the number of subscriptions for your agreement to zero (0). Follow these steps to reduce the number of subscriptions: 1. Sign in to . -1. If you have more than one agreement, choose the desired agreement from the drop-down list. -1. Select the **Overview** icon at the top left to display information about your subscriptions. +1. If you have more than one agreement, select the appropriate agreement. +1. Select the **Overview** icon in the top left corner to display information about your subscriptions. > [!div class="mx-imgBorder"] - > [![Display subscription overview](_img/buy-vs-subscriptions/overview-button.png "Screenshot showing the Visual Studio subscriptions management portal. The Overview button at the top left is highlighted.")](_img/buy-vs-subscriptions/overview-button.png#lightbox) + > [![Display subscription overview](media/buy-vs-subscriptions/overview-button.png "Screenshot showing the Visual Studio subscriptions management portal. The Overview button at the top left is highlighted.")](media/buy-vs-subscriptions/overview-button.png#lightbox) 4. Locate the entry for the subscriptions you wish to cancel and select **Change quantity**. > [!div class="mx-imgBorder"] - > [![Change quantity](_img/buy-vs-subscriptions/cloud-change-quantity.png "Screenshot of the Visual Studio subscriptions management portal. The Change quantity option is highlighted.")](_img/buy-vs-subscriptions/cloud-change-quantity.png#lightbox) + > [![Change quantity](media/buy-vs-subscriptions/cloud-change-quantity.png "Screenshot of the Visual Studio subscriptions management portal. The Change quantity option is highlighted.")](media/buy-vs-subscriptions/cloud-change-quantity.png#lightbox) 5. You're redirected to the Marketplace where you can edit the number of monthly subscriptions by reducing the number of **Paid users**. > [!div class="mx-imgBorder"] - > [![Reduce Paid users quanity](_img/buy-vs-subscriptions/cloud-reduce-paid-users.png "Screnshot of monthly subscription purchase dialog. 'New total Paid users' option is highlighted.")](_img/buy-vs-subscriptions/cloud-reduce-paid-users.png#lightbox) -6. Set the quantity to zero (0) and select confirm. + > [![Reduce Paid users quanity](media/buy-vs-subscriptions/cloud-reduce-paid-users.png "Screnshot of monthly subscription purchase dialog. 'New total Paid users' option is highlighted.")](media/buy-vs-subscriptions/cloud-reduce-paid-users.png#lightbox) +6. Update the quantity to zero (0) and select confirm. Your subscriptions remain in place until their scheduled billing date, but don't renew when the billing date is reached. > [!div class="mx-imgBorder"] - > [![Confirm Paid users quantity](_img/buy-vs-subscriptions/cloud-confirm-reduce.png "Screenshot of monthly subscription purchase dialog. You are good to go! and Manage user button highlighted.")](_img/buy-vs-subscriptions/cloud-confirm-reduce.png#lightbox) -7. Back in the Manage Portal, you'll see a caution symbol and "Expires" note for any subscription scheduled to end. + > [![Confirm Paid users quantity](media/buy-vs-subscriptions/cloud-confirm-reduce.png "Screenshot of monthly subscription purchase dialog. You are good to go! and Manage user button highlighted.")](media/buy-vs-subscriptions/cloud-confirm-reduce.png#lightbox) +7. Back in the Manage Portal, you see a caution symbol and "Expires" note for any subscription scheduled to end. > [!dev class="mx-imgBorder"] - > [![Manage portal](_img/buy-vs-subscriptions/cloud-expires-warning.png "Screenshot of the Visual Studio subscriptions management portal. A subscription with 'Expires' note is highligthed.")](_img/buy-vs-subscriptions/cloud-expires-warning.png#lightbox) + > [![Manage portal](media/buy-vs-subscriptions/cloud-expires-warning.png "Screenshot of the Visual Studio subscriptions management portal. A subscription with 'Expires' note is highligthed.")](media/buy-vs-subscriptions/cloud-expires-warning.png#lightbox) ## Frequently asked questions @@ -101,7 +97,7 @@ There are also many options through our volume licensing program. You can resear A: You receive perpetual license rights for the Visual Studio IDE that came with the subscription. When it's time to renew, you only pay the software assurance price, which is lower. -### For existing annual cloud subscribers +### For existing annual cloud subscribers: #### Q: How does the end of annual cloud subscription sales affect me? @@ -113,7 +109,7 @@ A: No. Your subscriptions remain in place and you're able to manage them as you #### Q: What if I want to increase the number of subscriptions for my customers? -A: Annual subscriptions that are purchased during a given month are charged immediately for a full year and are valid for a full year. So, you can modify the number of licenses only in the current month of purchase (they're valid for one year and charged for one year). Outside of the month of purchase, it's no longer possible to increase the number of subscriptions. +A: Annual subscriptions that are purchased during a given month are charged immediately and are valid for a full year. So, you can modify the number of licenses only in the current month of purchase (they're valid for one year and charged for one year). Outside of the month of purchase, it's no longer possible to increase the number of subscriptions. #### Q: What if I want to decrease the number of subscriptions for my customers?