You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Added a link to "What happens when agreements renew" article as there were questions from user feedback that it wasn't clear. Also updated the article throughout as per Acrolinx suggestions.
Copy file name to clipboardExpand all lines: subscriptions/migrate-subscriptions.md
+8-9Lines changed: 8 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,15 +3,15 @@ title: Migrate subscriptions to a new agreement
3
3
author: joseb-rdc
4
4
ms.author: amast
5
5
manager: shve
6
-
ms.date: 09/16/2024
6
+
ms.date: 09/17/2025
7
7
ms.topic: how-to
8
8
description: Migrate assigned Visual Studio subscriptions from one agreement to another, and understand how the move affects subscription benefits and Azure credits.
9
9
ms.custom: sfi-image-nochange
10
10
---
11
11
12
12
# Migrate subscriptions from one agreement to another
13
13
14
-
If you have Visual Studio subscriptions assigned as part of one agreement and your company purchases a new agreement, you might need to migrate subscribers from the current agreement to the new one. This article explains how to move your assigned subscriptions to the new agreement.
14
+
If you have Visual Studio subscriptions assigned as part of one agreement and your company purchases a new agreement, you might need to migrate subscribers from the current agreement to the new one. This article explains how to move your assigned subscriptions to the new agreement. To learn how to access your new or renewed agreement, visit [What happens when agreements renew](https://learn.microsoft.com/visualstudio/subscriptions/agreement-renewals).
15
15
16
16
When you move your subscribers to the new agreement, here's what happens:
17
17
+ They get a new subscription GUID.
@@ -25,7 +25,7 @@ The process for moving subscribers to the new agreement consists of three steps:
25
25
26
26
> [!IMPORTANT]
27
27
> Note the following considerations before you start this process:
28
-
> +If your reseller selected the option to automatically transfer the subscribers to the new agreement when it was purchased, you might not see the changes until 48-72 hours after the agreement was submitted. Before you proceed with the process to manually move your subscribers, check with your reseller.
28
+
> +Your reseller might choose the option to automatically transfer subscribers to the new agreement when they purchase it. In that case, you won't see the changes until 48–72 hours after they submit the agreement. Before you proceed with the process to manually move your subscribers, check with your reseller.
29
29
> + You can use Microsoft Entra groups to simplify the process of moving subscribers to the new agreement.
30
30
31
31
## Export your current subscription assignments
@@ -97,7 +97,7 @@ Take these steps to open your exported subscriptions list and move the relevant
97
97
> [!NOTE]
98
98
> The order of the columns in the exported subscriber list is different from the order in the template. The names of the columns also differ slightly. The following table shows the names of the fields that are common to both spreadsheets:
@@ -108,13 +108,12 @@ Take these steps to open your exported subscriptions list and move the relevant
108
108
| Country | Country |
109
109
| Language | Language |
110
110
111
-
112
111
> [!IMPORTANT]
113
-
> Do not copy data from the **Subscription GUID** column into the bulk add template. Leave that column blank in the Bulk add template. Adding the GUIDs will cause the upload to fail.
112
+
> Don't copy data from the **Subscription GUID** column into the bulk add template. Leave that column blank in the Bulk add template. Adding the Global Unique Identifiers (GUIDs) causes the upload to fail.
114
113
115
114
> [!TIP]
116
-
> If you have a lot of subscribers, you might find it helpful to use keyboard shortcuts when you're copying and pasting data.
117
-
> To select all the entries in a column like "Subscriber Name", select the first entry in the column (not the column heading), select and hold **Ctrl+Shift**, and then select the Down arrow key. This will select all the data in that column.
115
+
> If you have many subscribers, you might find it helpful to use keyboard shortcuts when you're copying and pasting data.
116
+
> To select all the entries in a column like "Subscriber Name", select the first entry in the column (not the column heading), select and hold **Ctrl+Shift**, and then select the Down arrow key. This action selects all the data in that column.
118
117
119
118
4. When all your data is moved to the bulk add template, save the template and close it. This list is the subscription list that you upload to your new agreement.
120
119
@@ -126,7 +125,7 @@ Take these steps to open your exported subscriptions list and move the relevant
126
125
0. The name of your subscription list appears in the **Upload multiple subscribers** dialog. Select **OK** to upload the file. In the admin portal, you might briefly see a status message stating that a file is being uploaded. When the upload is complete, you see the message **Subscribers updated successfully**.
127
126
The migration of your subscribers from your old agreement to your new one is complete.
128
127
> [!NOTE]
129
-
> After you add your subscribers to your new agreement, you should remove them from your old agreement. Removing them will prevent them from getting notifications about their old subscriptions.
128
+
> After you add your subscribers to your new agreement, you should remove them from your old agreement. Removing them prevents them from getting notifications about their old subscriptions.
0 commit comments