Skip to content

Commit 6111020

Browse files
committed
Update migrate-subscriptions.md
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.
1 parent b2ca46e commit 6111020

File tree

1 file changed

+8
-9
lines changed

1 file changed

+8
-9
lines changed

subscriptions/migrate-subscriptions.md

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -3,15 +3,15 @@ title: Migrate subscriptions to a new agreement
33
author: joseb-rdc
44
ms.author: amast
55
manager: shve
6-
ms.date: 09/16/2024
6+
ms.date: 09/17/2025
77
ms.topic: how-to
88
description: Migrate assigned Visual Studio subscriptions from one agreement to another, and understand how the move affects subscription benefits and Azure credits.
99
ms.custom: sfi-image-nochange
1010
---
1111

1212
# Migrate subscriptions from one agreement to another
1313

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).
1515

1616
When you move your subscribers to the new agreement, here's what happens:
1717
+ They get a new subscription GUID.
@@ -25,7 +25,7 @@ The process for moving subscribers to the new agreement consists of three steps:
2525

2626
> [!IMPORTANT]
2727
> 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 4872 hours after they submit the agreement. Before you proceed with the process to manually move your subscribers, check with your reseller.
2929
> + You can use Microsoft Entra groups to simplify the process of moving subscribers to the new agreement.
3030
3131
## Export your current subscription assignments
@@ -97,7 +97,7 @@ Take these steps to open your exported subscriptions list and move the relevant
9797
> [!NOTE]
9898
> 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:
9999
100-
| Export list | Bulk add template |
100+
| Export list | Bulk-add template |
101101
|----------------------------|--------------------|
102102
| Subscriber Name | Name |
103103
| Email | Sign-in Email |
@@ -108,13 +108,12 @@ Take these steps to open your exported subscriptions list and move the relevant
108108
| Country | Country |
109109
| Language | Language |
110110

111-
112111
> [!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.
114113
115114
> [!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.
118117
119118
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.
120119

@@ -126,7 +125,7 @@ Take these steps to open your exported subscriptions list and move the relevant
126125
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**.
127126
The migration of your subscribers from your old agreement to your new one is complete.
128127
> [!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.
130129
131130
## Resources
132131

0 commit comments

Comments
 (0)