Map Legacy Folders to SharePoint Libraries: Step-by-Step Setup

You have file servers or local network drives filled with legacy folders that your team needs to access from anywhere. Moving these folders to SharePoint libraries gives you cloud-based storage, version history, and collaboration features without losing the original folder structure. This article explains how to map legacy folders directly to SharePoint libraries using the OneDrive sync client and the SharePoint Migration Tool. You will learn the exact steps to set up the mapping and what to watch out for during the transition.

What Does Mapping Legacy Folders to SharePoint Libraries Mean?

Mapping a legacy folder means connecting an existing folder from a file server, network drive, or local computer to a SharePoint document library. The goal is to move the folder contents into SharePoint while keeping the original folder hierarchy intact. After mapping, users access the files through SharePoint or File Explorer instead of the legacy location.

There are two main methods for this mapping:

• Manual sync with OneDrive: Best for small folders under 100,000 files. You sync the SharePoint library to File Explorer, then copy or move the legacy folder into the synced location.
• Automated migration with SPMT: Best for large folder structures with many files and subfolders. SPMT copies the folder contents directly into SharePoint and preserves metadata like modified dates and permissions.

Before you start, ensure you have the following prerequisites:

• A SharePoint site with at least one document library where you have Contribute or Edit permissions
• The OneDrive sync client installed on your Windows 10 or Windows 11 computer
• Access to the SharePoint admin center if you plan to use SPMT for bulk migrations
• Network connectivity to both the legacy folder location and SharePoint

Steps to Map Legacy Folders to SharePoint Libraries Using OneDrive Sync

This method works best for individual users or small teams migrating a few folders. The process creates a live connection between your File Explorer and the SharePoint library.

1. Open the SharePoint document library in your browser
   Go to the SharePoint site that contains the target library. Click Documents in the left navigation or select the library from the site contents. The library must be of type Document Library, not a list or other app.
2. Click the Sync button
   In the command bar at the top of the library, click Sync. If you do not see the Sync button, your admin may have disabled sync for this site. Contact your SharePoint admin to enable sync.
3. Allow the OneDrive sync client to open
   A dialog appears asking if you want to open Microsoft OneDrive. Click Open OneDrive. The sync client starts and creates a local folder for the SharePoint library under C:\Users\YourName\SharePoint.
4. Open the synced folder in File Explorer
   After sync completes, click Show my files in File Explorer from the sync notification. You see a folder with the same name as your SharePoint library. This folder is now linked to SharePoint.
5. Copy or move the legacy folder into the synced folder
   Drag the legacy folder from its original location into the synced SharePoint folder. You can also use Ctrl+C and Ctrl+V to copy. The OneDrive sync client uploads the folder and all its contents to the SharePoint library. Wait for the sync icon to turn green before closing File Explorer.
6. Verify the folder appears in SharePoint
   Go back to your browser and refresh the SharePoint library page. The legacy folder and its subfolders should now be visible. Open a few files to confirm they open correctly.

Steps to Map Legacy Folders Using the SharePoint Migration Tool

Use SPMT when you need to migrate many folders, preserve file permissions, or transfer metadata like Created By and Modified dates. SPMT is a free Microsoft tool that runs on Windows 10 and Windows 11.

1. Download and install the SharePoint Migration Tool
   Go to the Microsoft 365 admin center and search for Migration. Select SharePoint Migration Tool and click Download. Run the installer and follow the prompts to complete the installation.
2. Open SPMT and sign in
   Launch SPMT from the Start menu. Click Sign in and enter your Microsoft 365 credentials. You need at least SharePoint admin permissions to run migrations to multiple sites.
3. Choose the source location
   In the SPMT main window, click Add source. Select File share for a network folder or Local folder for a folder on your computer. Browse to the legacy folder you want to map. SPMT supports folders up to 15 TB in size.
4. Choose the destination SharePoint library
   Click Add destination. Select SharePoint Site and enter the URL of the SharePoint site. Click Browse to select the specific document library. You can also create a new folder inside the library as the destination.
5. Configure migration settings
   Click Edit settings. Under User mapping, choose how to map file server user accounts to Microsoft 365 users. Under Permissions, select Preserve user permissions to copy folder-level permissions. Under Metadata, check Preserve file dates to keep original Created and Modified timestamps.
6. Start the migration
   Click Start. SPMT scans the source folder and begins copying files to SharePoint. You see a progress bar for each file. When the migration finishes, SPMT shows a summary with any errors or warnings.
7. Review the migrated folder in SharePoint
   Open the SharePoint library in your browser. The legacy folder appears with its original name and structure. Check a few items to confirm permissions and dates were preserved.

Common Mistakes and Limitations When Mapping Legacy Folders

File names and paths exceed SharePoint limits

SharePoint has a 400-character limit for the full file path including the file name. Legacy folders with deep nesting or long file names may fail to sync or migrate. Before mapping, rename any files or folders that exceed 400 characters. Use PowerRename in PowerToys or a bulk rename tool to shorten them.

Special characters cause upload failures

SharePoint does not allow these characters in file or folder names: ~ # % & : < > ? / \ { | }. If your legacy folder contains these characters, rename them before migration. SPMT has an option to replace invalid characters automatically. In SPMT settings, enable Replace invalid characters to convert them to underscores.

Folder permissions do not match after migration

SharePoint uses site-level permissions, not NTFS permissions. If your legacy folder has unique permissions for subfolders, those permissions may not transfer exactly. In SPMT, use the Preserve user permissions setting to map Windows user accounts to Microsoft 365 users. After migration, review the SharePoint library permissions and add any missing groups.

Sync client stops responding during large uploads

The OneDrive sync client has a file limit of 100,000 items per library. If your legacy folder contains more files, the sync may slow down or stop. Use SPMT instead for libraries with more than 100,000 items. You can also split the legacy folder into multiple SharePoint libraries to stay under the limit.

Item	OneDrive Sync Method	SPMT Migration Method
Best for	Small folders under 100,000 items	Large folder structures over 100,000 items
Permission preservation	No permissions transferred	Preserves user permissions with mapping
Metadata preservation	Only file dates from copy time	Preserves Created By, Modified, and dates
Required software	OneDrive sync client	SharePoint Migration Tool
User interaction	Manual drag and drop	Automated with settings configuration

Now you can map legacy folders to SharePoint libraries using either the OneDrive sync client for quick manual transfers or the SharePoint Migration Tool for automated bulk migrations with full metadata and permissions. Start by assessing the size and permissions of your legacy folders, then choose the method that fits your scenario. For folders with special characters or deep nesting, use SPMT with the Replace invalid characters option enabled to avoid upload failures.