{
    "api_version": "1",
    "kind": "dse_post",
    "self": "https://update.dsesecurity.com/api/v1/posts/onedrive-known-folder-move-controlled-rollout/",
    "item": {
        "id": "https://update.dsesecurity.com/updates/onedrive-known-folder-move-controlled-rollout/",
        "slug": "onedrive-known-folder-move-controlled-rollout",
        "url": "https://update.dsesecurity.com/updates/onedrive-known-folder-move-controlled-rollout/",
        "alternate_urls": {
            "markdown": "https://update.dsesecurity.com/updates/onedrive-known-folder-move-controlled-rollout.md",
            "json": "https://update.dsesecurity.com/api/v1/posts/onedrive-known-folder-move-controlled-rollout/"
        },
        "title": "Move Windows known folders to OneDrive without creating an empty desktop",
        "summary": "OneDrive Known Folder Move can redirect familiar Windows folders to the cloud, but prior redirection, other tenants, unsupported files, storage, bandwidth, and sync health must be resolved first.",
        "format": {
            "slug": "playbook",
            "name": "Playbook"
        },
        "priority": {
            "slug": "advisory",
            "name": "Advisory"
        },
        "featured": false,
        "topics": [
            {
                "slug": "business-continuity",
                "name": "Business Continuity",
                "url": "https://update.dsesecurity.com/topic/business-continuity/"
            },
            {
                "slug": "it",
                "name": "IT",
                "url": "https://update.dsesecurity.com/topic/it/"
            },
            {
                "slug": "microsoft-365-identity",
                "name": "Microsoft 365 & Identity",
                "url": "https://update.dsesecurity.com/topic/microsoft-365-identity/"
            }
        ],
        "author": {
            "name": "DSE Security Editorial Team",
            "url": "https://update.dsesecurity.com/#editorial-team"
        },
        "publisher": {
            "name": "Detection Systems & Engineering",
            "url": "https://dsesecurity.com/"
        },
        "published_at": "2026-07-19T21:28:15+00:00",
        "modified_at": "2026-07-19T21:28:15+00:00",
        "reviewed_on": "2026-07-19",
        "reading_minutes": 3,
        "word_count": 457,
        "potentially_affected": "Windows users whose Desktop, Documents, Pictures, Screenshots, or Camera Roll data will move through the OneDrive sync app, including migrations from Folder Redirection or another tenant.",
        "dse_recommendation": "Inventory current folder locations and data, update OneDrive, test a small representative group, validate files and sync health, and expand within Microsoft rollout guidance.",
        "primary_source": {
            "name": "Microsoft Learn: Redirect and move Windows known folders to OneDrive",
            "url": "https://learn.microsoft.com/en-us/sharepoint/redirect-known-folders",
            "published_on": "2025-03-27",
            "authority": "Microsoft Learn"
        },
        "publishing_principles": "https://update.dsesecurity.com/updates/dse-updates-editorial-methodology/",
        "usage_info": "https://update.dsesecurity.com/usage/",
        "copyright_notice": "Copyright © 2026 Detection Systems & Engineering. All rights reserved.",
        "content_html": "<h2>Source fact: what Microsoft documents</h2>\n<p>OneDrive Known Folder Move redirects supported Windows folders such as Desktop, Documents, Pictures, Screenshots, and Camera Roll into the user&#8217;s OneDrive. Users continue working in familiar locations while the OneDrive sync app uploads the content and makes it available from other devices. Administrators can prompt users to move folders or silently redirect supported folders through Group Policy, Intune administrative templates, or documented registry policy.</p>\n<p>Microsoft recommends upgrading to the latest OneDrive build and rolling out slowly to control upload demand. For existing devices, Microsoft currently recommends limiting silent Known Folder Move deployment to 1,000 devices per day and 4,000 per week across Windows and macOS. For the prompt policy, Microsoft recommends no more than 5,000 devices per day and 20,000 per week.</p>\n<p>Existing Folder Redirection requires a transition process. Known Folder Move does not work when the user is syncing OneDrive files in SharePoint Server. If folders are already redirected to another organization&#8217;s OneDrive, redirecting immediately to the new tenant creates new folders and can leave the user viewing an empty desktop until data is migrated. Microsoft documents separate steps for local paths, file shares, and previous OneDrive redirection.</p>\n<h2>Licensing and applicability</h2>\n<p>The user needs an eligible OneDrive for work or school service, supported sync application, sufficient cloud storage, and supported Windows configuration. File names, paths, open files, policies, network proxies, tenant restrictions, unsupported content, and previous folder ownership can block migration. Syncing content to OneDrive improves service availability but is not a complete independent backup, legal retention, or offline recovery strategy.</p>\n<h2>DSE recommendation: production-safe operational steps</h2>\n<ol>\n<li>Inventory each user&#8217;s current Desktop, Documents, and Pictures paths, prior Folder Redirection, tenant association, file count and size, storage quota, unsupported files, permissions, and sync errors.</li>\n<li>Define the supported transition for local folders, network shares, or another OneDrive tenant. Preserve authoritative source data until destination validation is complete.</li>\n<li>Update the OneDrive sync app and verify required Microsoft 365 network endpoints, disk capacity, user identity, and Files On-Demand behavior.</li>\n<li>Pilot representative users with large data sets, laptops, remote connections, specialized applications, multiple devices, and redirected folders.</li>\n<li>Validate folder contents, timestamps where important, application save paths, desktop appearance, synchronization, conflict handling, web access, new-device recovery, and user support.</li>\n<li>Throttle or schedule upload where required and expand within Microsoft&#8217;s current daily and weekly rollout guidance.</li>\n<li>Monitor sync health and storage continuously. Remove the source only after documented acceptance and the applicable retention period.</li>\n</ol>\n<p>DSE recommends communicating the visual changes and error-resolution path before policy assignment. If a user sees an empty folder, stop further moves for that cohort, preserve both source locations, identify tenant and redirection state, and reconcile files before continuing.</p>\n<h2>Official reference</h2>\n<p><a href=\"https://learn.microsoft.com/en-us/sharepoint/redirect-known-folders\" target=\"_blank\" rel=\"noopener noreferrer\">Redirect and move Windows known folders to OneDrive</a> — supported folders, policies, rollout rates, prior redirection, bandwidth, and migration behavior.</p>",
        "content_text": "Source fact: what Microsoft documents\nOneDrive Known Folder Move redirects supported Windows folders such as Desktop, Documents, Pictures, Screenshots, and Camera Roll into the user’s OneDrive. Users continue working in familiar locations while the OneDrive sync app uploads the content and makes it available from other devices. Administrators can prompt users to move folders or silently redirect supported folders through Group Policy, Intune administrative templates, or documented registry policy.\nMicrosoft recommends upgrading to the latest OneDrive build and rolling out slowly to control upload demand. For existing devices, Microsoft currently recommends limiting silent Known Folder Move deployment to 1,000 devices per day and 4,000 per week across Windows and macOS. For the prompt policy, Microsoft recommends no more than 5,000 devices per day and 20,000 per week.\nExisting Folder Redirection requires a transition process. Known Folder Move does not work when the user is syncing OneDrive files in SharePoint Server. If folders are already redirected to another organization’s OneDrive, redirecting immediately to the new tenant creates new folders and can leave the user viewing an empty desktop until data is migrated. Microsoft documents separate steps for local paths, file shares, and previous OneDrive redirection.\nLicensing and applicability\nThe user needs an eligible OneDrive for work or school service, supported sync application, sufficient cloud storage, and supported Windows configuration. File names, paths, open files, policies, network proxies, tenant restrictions, unsupported content, and previous folder ownership can block migration. Syncing content to OneDrive improves service availability but is not a complete independent backup, legal retention, or offline recovery strategy.\nDSE recommendation: production-safe operational steps\n\nInventory each user’s current Desktop, Documents, and Pictures paths, prior Folder Redirection, tenant association, file count and size, storage quota, unsupported files, permissions, and sync errors.\nDefine the supported transition for local folders, network shares, or another OneDrive tenant. Preserve authoritative source data until destination validation is complete.\nUpdate the OneDrive sync app and verify required Microsoft 365 network endpoints, disk capacity, user identity, and Files On-Demand behavior.\nPilot representative users with large data sets, laptops, remote connections, specialized applications, multiple devices, and redirected folders.\nValidate folder contents, timestamps where important, application save paths, desktop appearance, synchronization, conflict handling, web access, new-device recovery, and user support.\nThrottle or schedule upload where required and expand within Microsoft’s current daily and weekly rollout guidance.\nMonitor sync health and storage continuously. Remove the source only after documented acceptance and the applicable retention period.\n\nDSE recommends communicating the visual changes and error-resolution path before policy assignment. If a user sees an empty folder, stop further moves for that cohort, preserve both source locations, identify tenant and redirection state, and reconcile files before continuing.\nOfficial reference\nRedirect and move Windows known folders to OneDrive — supported folders, policies, rollout rates, prior redirection, bandwidth, and migration behavior.",
        "content_markdown": "## Source fact: what Microsoft documents\n\nOneDrive Known Folder Move redirects supported Windows folders such as Desktop, Documents, Pictures, Screenshots, and Camera Roll into the user’s OneDrive. Users continue working in familiar locations while the OneDrive sync app uploads the content and makes it available from other devices. Administrators can prompt users to move folders or silently redirect supported folders through Group Policy, Intune administrative templates, or documented registry policy.\n\nMicrosoft recommends upgrading to the latest OneDrive build and rolling out slowly to control upload demand. For existing devices, Microsoft currently recommends limiting silent Known Folder Move deployment to 1,000 devices per day and 4,000 per week across Windows and macOS. For the prompt policy, Microsoft recommends no more than 5,000 devices per day and 20,000 per week.\n\nExisting Folder Redirection requires a transition process. Known Folder Move does not work when the user is syncing OneDrive files in SharePoint Server. If folders are already redirected to another organization’s OneDrive, redirecting immediately to the new tenant creates new folders and can leave the user viewing an empty desktop until data is migrated. Microsoft documents separate steps for local paths, file shares, and previous OneDrive redirection.\n\n## Licensing and applicability\n\nThe user needs an eligible OneDrive for work or school service, supported sync application, sufficient cloud storage, and supported Windows configuration. File names, paths, open files, policies, network proxies, tenant restrictions, unsupported content, and previous folder ownership can block migration. Syncing content to OneDrive improves service availability but is not a complete independent backup, legal retention, or offline recovery strategy.\n\n## DSE recommendation: production-safe operational steps\n\n- Inventory each user’s current Desktop, Documents, and Pictures paths, prior Folder Redirection, tenant association, file count and size, storage quota, unsupported files, permissions, and sync errors.\n\n- Define the supported transition for local folders, network shares, or another OneDrive tenant. Preserve authoritative source data until destination validation is complete.\n\n- Update the OneDrive sync app and verify required Microsoft 365 network endpoints, disk capacity, user identity, and Files On-Demand behavior.\n\n- Pilot representative users with large data sets, laptops, remote connections, specialized applications, multiple devices, and redirected folders.\n\n- Validate folder contents, timestamps where important, application save paths, desktop appearance, synchronization, conflict handling, web access, new-device recovery, and user support.\n\n- Throttle or schedule upload where required and expand within Microsoft’s current daily and weekly rollout guidance.\n\n- Monitor sync health and storage continuously. Remove the source only after documented acceptance and the applicable retention period.\n\nDSE recommends communicating the visual changes and error-resolution path before policy assignment. If a user sees an empty folder, stop further moves for that cohort, preserve both source locations, identify tenant and redirection state, and reconcile files before continuing.\n\n## Official reference\n\n[Redirect and move Windows known folders to OneDrive](https://learn.microsoft.com/en-us/sharepoint/redirect-known-folders) — supported folders, policies, rollout rates, prior redirection, bandwidth, and migration behavior."
    },
    "json_ld": {
        "@context": "https://schema.org",
        "@graph": [
            {
                "@type": "Organization",
                "@id": "https://dsesecurity.com/#organization",
                "name": "Detection Systems & Engineering",
                "alternateName": "DSE Security",
                "url": "https://dsesecurity.com/",
                "logo": {
                    "@type": "ImageObject",
                    "url": "https://update.dsesecurity.com/assets/dse-logo.png"
                }
            },
            {
                "@type": "Organization",
                "@id": "https://update.dsesecurity.com/#editorial-team",
                "name": "DSE Security Editorial Team",
                "url": "https://update.dsesecurity.com/",
                "parentOrganization": {
                    "@id": "https://dsesecurity.com/#organization"
                }
            },
            {
                "@type": "WebSite",
                "@id": "https://update.dsesecurity.com/#website",
                "name": "DSE Updates",
                "alternateName": "DSE Security Knowledge Hub",
                "url": "https://update.dsesecurity.com/",
                "inLanguage": "en-US",
                "publisher": {
                    "@id": "https://dsesecurity.com/#organization"
                },
                "potentialAction": {
                    "@type": "SearchAction",
                    "target": {
                        "@type": "EntryPoint",
                        "urlTemplate": "https://update.dsesecurity.com/?q={search_term_string}"
                    },
                    "query-input": "required name=search_term_string"
                }
            },
            {
                "@type": "WebPage",
                "@id": "https://update.dsesecurity.com/updates/onedrive-known-folder-move-controlled-rollout/",
                "url": "https://update.dsesecurity.com/updates/onedrive-known-folder-move-controlled-rollout/",
                "isPartOf": {
                    "@id": "https://update.dsesecurity.com/#website"
                },
                "lastReviewed": "2026-07-19"
            },
            {
                "@type": "BreadcrumbList",
                "@id": "https://update.dsesecurity.com/updates/onedrive-known-folder-move-controlled-rollout/#breadcrumbs",
                "itemListElement": [
                    {
                        "@type": "ListItem",
                        "position": 1,
                        "name": "DSE Updates",
                        "item": "https://update.dsesecurity.com/"
                    },
                    {
                        "@type": "ListItem",
                        "position": 2,
                        "name": "Move Windows known folders to OneDrive without creating an empty desktop",
                        "item": "https://update.dsesecurity.com/updates/onedrive-known-folder-move-controlled-rollout/"
                    }
                ]
            },
            {
                "@type": [
                    "Article",
                    "TechArticle"
                ],
                "@id": "https://update.dsesecurity.com/updates/onedrive-known-folder-move-controlled-rollout/#article",
                "identifier": "https://update.dsesecurity.com/updates/onedrive-known-folder-move-controlled-rollout/",
                "url": "https://update.dsesecurity.com/updates/onedrive-known-folder-move-controlled-rollout/",
                "headline": "Move Windows known folders to OneDrive without creating an empty desktop",
                "description": "OneDrive Known Folder Move can redirect familiar Windows folders to the cloud, but prior redirection, other tenants, unsupported files, storage…",
                "abstract": "OneDrive Known Folder Move can redirect familiar Windows folders to the cloud, but prior redirection, other tenants, unsupported files, storage, bandwidth, and sync health must be resolved first.",
                "articleBody": "Source fact: what Microsoft documents\nOneDrive Known Folder Move redirects supported Windows folders such as Desktop, Documents, Pictures, Screenshots, and Camera Roll into the user’s OneDrive. Users continue working in familiar locations while the OneDrive sync app uploads the content and makes it available from other devices. Administrators can prompt users to move folders or silently redirect supported folders through Group Policy, Intune administrative templates, or documented registry policy.\nMicrosoft recommends upgrading to the latest OneDrive build and rolling out slowly to control upload demand. For existing devices, Microsoft currently recommends limiting silent Known Folder Move deployment to 1,000 devices per day and 4,000 per week across Windows and macOS. For the prompt policy, Microsoft recommends no more than 5,000 devices per day and 20,000 per week.\nExisting Folder Redirection requires a transition process. Known Folder Move does not work when the user is syncing OneDrive files in SharePoint Server. If folders are already redirected to another organization’s OneDrive, redirecting immediately to the new tenant creates new folders and can leave the user viewing an empty desktop until data is migrated. Microsoft documents separate steps for local paths, file shares, and previous OneDrive redirection.\nLicensing and applicability\nThe user needs an eligible OneDrive for work or school service, supported sync application, sufficient cloud storage, and supported Windows configuration. File names, paths, open files, policies, network proxies, tenant restrictions, unsupported content, and previous folder ownership can block migration. Syncing content to OneDrive improves service availability but is not a complete independent backup, legal retention, or offline recovery strategy.\nDSE recommendation: production-safe operational steps\n\nInventory each user’s current Desktop, Documents, and Pictures paths, prior Folder Redirection, tenant association, file count and size, storage quota, unsupported files, permissions, and sync errors.\nDefine the supported transition for local folders, network shares, or another OneDrive tenant. Preserve authoritative source data until destination validation is complete.\nUpdate the OneDrive sync app and verify required Microsoft 365 network endpoints, disk capacity, user identity, and Files On-Demand behavior.\nPilot representative users with large data sets, laptops, remote connections, specialized applications, multiple devices, and redirected folders.\nValidate folder contents, timestamps where important, application save paths, desktop appearance, synchronization, conflict handling, web access, new-device recovery, and user support.\nThrottle or schedule upload where required and expand within Microsoft’s current daily and weekly rollout guidance.\nMonitor sync health and storage continuously. Remove the source only after documented acceptance and the applicable retention period.\n\nDSE recommends communicating the visual changes and error-resolution path before policy assignment. If a user sees an empty folder, stop further moves for that cohort, preserve both source locations, identify tenant and redirection state, and reconcile files before continuing.\nOfficial reference\nRedirect and move Windows known folders to OneDrive — supported folders, policies, rollout rates, prior redirection, bandwidth, and migration behavior.",
                "datePublished": "2026-07-19T21:28:15+00:00",
                "dateModified": "2026-07-19T21:28:15+00:00",
                "mainEntityOfPage": {
                    "@id": "https://update.dsesecurity.com/updates/onedrive-known-folder-move-controlled-rollout/"
                },
                "inLanguage": "en-US",
                "isAccessibleForFree": true,
                "author": {
                    "@id": "https://update.dsesecurity.com/#editorial-team"
                },
                "publisher": {
                    "@id": "https://dsesecurity.com/#organization"
                },
                "image": "https://update.dsesecurity.com/assets/dse-updates-share.png",
                "articleSection": [
                    "Business Continuity",
                    "IT",
                    "Microsoft 365 & Identity"
                ],
                "keywords": [
                    "Business Continuity",
                    "IT",
                    "Microsoft 365 & Identity",
                    "Playbook",
                    "Advisory priority"
                ],
                "genre": "Playbook",
                "about": [
                    {
                        "@type": "Thing",
                        "name": "Business Continuity",
                        "url": "https://update.dsesecurity.com/topic/business-continuity/"
                    },
                    {
                        "@type": "Thing",
                        "name": "IT",
                        "url": "https://update.dsesecurity.com/topic/it/"
                    },
                    {
                        "@type": "Thing",
                        "name": "Microsoft 365 & Identity",
                        "url": "https://update.dsesecurity.com/topic/microsoft-365-identity/"
                    }
                ],
                "wordCount": 457,
                "timeRequired": "PT3M",
                "publishingPrinciples": "https://update.dsesecurity.com/updates/dse-updates-editorial-methodology/",
                "usageInfo": "https://update.dsesecurity.com/usage/",
                "copyrightHolder": {
                    "@id": "https://dsesecurity.com/#organization"
                },
                "copyrightNotice": "Copyright © 2026 Detection Systems & Engineering. All rights reserved.",
                "citation": {
                    "@type": "CreativeWork",
                    "name": "Microsoft Learn: Redirect and move Windows known folders to OneDrive",
                    "url": "https://learn.microsoft.com/en-us/sharepoint/redirect-known-folders",
                    "datePublished": "2025-03-27"
                }
            }
        ]
    }
}