OneDrive Admin Checklist: storage quotas do not update for tenant migrations
🔍 WiseChecker

OneDrive Admin Checklist: storage quotas do not update for tenant migrations

When you migrate a Microsoft 365 tenant, OneDrive for Business storage quotas often fail to reflect the new environment. Users see old quota limits in their OneDrive sync client and web interface, even after Microsoft has updated the tenant subscription or license. This happens because the storage quota value is cached at the user level and does not automatically refresh when the tenant configuration changes. This article explains why quotas get stuck, provides a step-by-step admin checklist to force an update, and covers related failures that may occur during or after a tenant migration.

Key Takeaways: Fixing Stale OneDrive Storage Quotas After a Tenant Migration

  • Microsoft 365 admin center > Users > Active users > OneDrive tab: Directly view and modify the per-user storage quota for OneDrive.
  • SharePoint Online Management Shell > Set-SPOSite -StorageQuota: PowerShell command to update the quota value for a specific OneDrive site collection.
  • OneDrive sync client > Settings > Account > Unlink this PC: Forces the client to re-fetch quota information from the server after a migration.

ADVERTISEMENT

Why OneDrive Storage Quotas Do Not Update After a Tenant Migration

When you migrate a tenant to a new subscription, domain, or Microsoft 365 plan, the underlying storage quota for each user’s OneDrive is stored in the SharePoint site collection properties. The quota value is not tied to the tenant’s license in real time. Instead, it is set during initial provisioning and remains static until an admin explicitly changes it. During migration, the new tenant’s license may grant a different default quota, but existing OneDrive sites keep their old values. The sync client and web interface both read this cached property, so users see the outdated limit.

Another cause is that the tenant migration process does not trigger a quota recalculation. Even if you assign a new license with a higher or lower storage limit, the per-site quota remains unchanged. You must update each affected OneDrive site manually or via PowerShell. Additionally, the OneDrive sync client caches quota information locally. Until the user unlinks and re-links their account, the client will continue to show the old quota, leading to sync errors or warnings about exceeding storage.

Storage Quota vs Tenant License Quota

The tenant license quota is the total storage available across all users. The per-user storage quota is the amount assigned to a single user’s OneDrive. After migration, the tenant license quota changes, but per-user quotas do not automatically adjust. You must align them manually.

Admin Checklist: Steps to Update OneDrive Storage Quotas After a Migration

Use this checklist to ensure all OneDrive storage quotas reflect the new tenant configuration. Perform these steps in the order shown.

  1. Verify the new tenant license quota
    Open the Microsoft 365 admin center. Go to Billing > Licenses. Note the total storage limit shown for your subscription. This is the maximum storage your tenant can allocate across all OneDrive sites.
  2. Check the default OneDrive storage quota for new users
    In the admin center, go to Settings > Org settings > OneDrive. Under Storage limit, confirm the default value. This setting applies only to new OneDrive sites created after the change. Existing sites are not affected.
  3. Identify users with stale quotas
    Use the SharePoint Online Management Shell to list all OneDrive site collections. Run Get-SPOSite -IncludePersonalSite $true -Limit All | Select Owner, StorageQuota, StorageUsageCurrent. Compare the StorageQuota values to the expected new quota. Note any mismatches.
  4. Update the quota for a single user via the admin center
    Go to Users > Active users. Select the user. Click the OneDrive tab. Under Storage limit, enter the new quota in MB. Click Save. This change takes effect immediately on the server.
  5. Update quotas in bulk with PowerShell
    Run the following command to set the quota for all OneDrive sites to the new tenant default. Replace NewQuotaInMB with the desired value, for example 1024000 for 1 TB.
    Get-SPOSite -IncludePersonalSite $true -Limit All | Set-SPOSite -StorageQuota NewQuotaInMB
    This command updates every OneDrive site. It may take several minutes to complete for large tenants.
  6. Notify users to unlink and re-link their OneDrive sync client
    Each user must right-click the OneDrive cloud icon in the system tray, select Settings > Account, and click Unlink this PC. After unlinking, they sign in again with their work or school account. This forces the client to download the updated quota from the server.
  7. Verify the updated quota in the web interface
    As a final check, open a user’s OneDrive in a browser. Click the gear icon and select OneDrive settings > More settings > Storage. Confirm the displayed quota matches the new value.

ADVERTISEMENT

If OneDrive Storage Quotas Still Do Not Update

After following the checklist, some users may still see old quotas. The following issues explain why and how to resolve them.

OneDrive web interface shows the old quota after admin update

The SharePoint site collection property may not have propagated to all front-end servers. Wait 15 to 30 minutes and refresh the browser. If the quota remains unchanged, run Set-SPOSite -Identity -StorageQuota again for that specific site. Then clear the browser cache or use an InPrivate window to verify.

OneDrive sync client shows a quota warning even though the server quota is correct

The sync client caches the quota locally. Unlinking and re-linking the account is the only reliable fix. If the warning persists after re-linking, restart the OneDrive process. Press Ctrl+Alt+Delete, open Task Manager, find Microsoft OneDrive, and click End task. Then start OneDrive again from the Start menu.

Tenant migration changed the domain but not the quota

When you add a new domain and remove the old one, OneDrive site URLs may change. The quota property on the new URL is inherited from the old site. After the domain change, run the PowerShell bulk update command again to ensure all new site URLs have the correct quota.

Manual Admin Center Update vs PowerShell Bulk Update: Key Differences

Item Admin Center Update PowerShell Bulk Update
Scope One user at a time All OneDrive sites at once
Time required 2-3 minutes per user Minutes to hours for large tenants
Error handling Manual review for each user Use -ErrorAction SilentlyContinue to skip problematic sites
Prerequisite No special permissions beyond admin center access SharePoint Online Management Shell installed and connected
Best for Small tenants or single-user corrections Tenants with 50 or more users

After completing the checklist, your tenant’s OneDrive storage quotas will match the new subscription. Run the PowerShell bulk update command every time you change the tenant license or after a domain migration. For ongoing monitoring, set up a weekly script that compares StorageQuota to your expected value and logs mismatches. This proactive approach prevents users from hitting false storage limits after future migrations.

ADVERTISEMENT