Two methods exist for copying a SharePoint document library to another site. Here is what each can and cannot do before you begin:
| Capability | Native Copy To | Clone Master |
|---|---|---|
| File content | Yes | Yes |
| Folder hierarchy | Yes | Yes |
| File names and extensions | Yes | Yes |
| Custom column values (metadata) | Partial (matching columns only; managed metadata lost) | Yes |
| Version history | No | Yes |
| Item-level unique permissions | No | Yes |
| Resume after interruption | No | Yes |
| Cross-tenant copy | No | Yes |
What does SharePoint's built-in Copy To do?
Copy to is a SharePoint Online action that transfers file content and folder structure to any library in the same tenant. No admin tools or PowerShell required: any user who can read the source and edit the destination library can run it. It processes the copy in the background and works well for libraries with a few hundred to a few thousand small or medium files where managed metadata and version history do not matter. Microsoft limits each copy across sites to 100 GB and 30,000 files.
What copies successfully
- All file types and their binary content
- Folder hierarchy, including nested subfolders at any depth
- File names and extensions
- The current version of each file (the latest checked-in version)
What stays behind
- Some column values. Values survive only where the destination library has a matching column; a column such as Department or Project Code that does not exist at the destination is dropped. Microsoft also states that managed metadata values are not retained, even when the destination has the same column.
- Version history. Only the current version transfers. Every prior version is left behind. For document control or regulated content workflows, this is a significant limitation.
- Item-level unique permissions. Any file or folder that had its permissions broken from the library's inherited permissions will arrive at the destination with the library's default permissions instead.
- Checked-out state. Files that are checked out in the source library arrive checked in at the destination. If the source file is actively being edited, the destination copy reflects the last checked-in version.
- Content type assignment. Items may revert to the library's default content type at the destination if the destination library does not have the same content types configured.
For many reorganisation tasks, these limitations are acceptable. If the goal is to move files to a new library and custom metadata is not in use, Copy To is the right tool.
Step-by-step: Using Copy To in SharePoint Online
- Open the source library in the modern experience. Navigate to the SharePoint site containing the library you want to copy. If you are in classic view, switch to the modern experience using the link in the bottom-left corner of the library view.
- Select the content. Select the top-level folders and files you want to copy; selecting a folder copies everything inside it. For a large library, split the work into batches that stay within Microsoft's limit of 100 GB and 30,000 files per copy across sites.
- Open the Copy To panel. In the command bar above the item list, click Copy to. On narrower screens or when multiple items are selected, the button may be inside the three-dot overflow menu. A panel opens on the right side of the page.
- Browse to the destination. In the panel, choose the destination site from the list of places on the left. If it is not listed, select More places to find it. Select the site, then choose the target library or a folder within it.
- Start the copy. Click Copy here. A progress notification appears in the top-right corner of the screen while SharePoint runs the copy in the background.
- Verify the result. When the notification confirms completion, navigate to the destination library. Confirm that files and folders have arrived, check the item count, and spot-check a few files to ensure content is intact.
When to use Clone Master instead of Copy To
Three situations make the native Copy To insufficient for a library copy:
- The library uses custom columns. If items carry values in columns such as Department, Client, Status, Approval Stage, or any managed metadata field, those values will not transfer. The destination library receives the files with blank columns, and the metadata must be re-entered manually or rebuilt from a source export. For libraries with thousands of items, that is not a realistic option.
- Version history matters. Document control systems, regulated industries, and quality management workflows often require that previous versions remain accessible after a library is relocated. Native Copy To transfers only the current version. If auditors or end users need to open version 14 of a document that is now on version 22, Copy To is not viable.
- The library is large. Each Copy to operation across sites is capped at 100 GB and 30,000 files, so a big library means many separate operations, and there is no built-in way to resume from an interruption point or skip what already arrived. You must identify what transferred and what did not before restarting.
Try ShareMaster free for 14 days
Copying a library with metadata using Clone Master
Clone Master reads the source library's schema (its column definitions, content types, and view configuration) and creates a matching structure at the destination before transferring any files. Each item's column values are then read from the source and written to the corresponding columns at the destination, including lookup columns, managed metadata terms, and person fields. Copying needs a Clone Master licence. The 14-day trial lets you try the workflow, but a trial copy skips items at random, so treat it as a test rather than a usable copy.
The workflow for a library copy in Clone Master:
- Connect to the source site using the site picker.
- Select the source library from the library list.
- Connect to the destination site (same tenant or a different tenant).
- Choose an existing destination library, or let Clone Master create one that mirrors the source schema.
- Configure copy options: Retain all versions or a Number of versions to retain, Copy all permissions, Copy views, whether to skip files that already exist or are newer at the destination, and whether to match lookup values by value or by ID.
- Run the copy. Clone Master processes items in batches, logging each transferred file with its outcome. If a throttle limit is reached, Clone Master backs off and retries automatically.
- Review the transfer log. Any items that required a retry or produced a warning are listed with their specific error, so you can address them without rerunning the entire operation.
For large libraries, scheduling the copy outside peak business hours reduces the likelihood of hitting SharePoint Online's API rate limits. See the SharePoint Migration Throttling Limits Reference for the specific thresholds that apply to bulk data movement operations.
After the copy: checking your results
Run a post-copy validation before decommissioning or repurposing the source library. The checks that catch the most common issues:
- Item count comparison. The destination library should show the same number of files and folders as the source. A discrepancy means some items did not transfer.
- Metadata spot-check. Open five to ten items at random from different folders. Confirm that custom column values match what the source shows for those items.
- Version history check (if applicable). Open one or two files in the destination and click Version History. Confirm that historical versions are present and that the version count matches the source (within the version limit you set during the copy configuration).
- Permission check (if item permissions were copied). Ask a test user who had unique access to a specific item in the source to attempt to open the same item at the destination. Confirm access is as expected.
Do not delete the source library until the validation is complete. During any parallel-run period, set the source library to read-only by removing the Contribute permission from all user groups, so that no new edits accumulate in the old location while you are relying on the destination.
Frequently Asked Questions
Can I copy a SharePoint document library to another site in the same tenant?
Yes. SharePoint Online's built-in Copy to copies file content and folder structure to any library on any site in the same tenant. Only the latest version of each file is copied, item-level unique permissions and managed metadata values are not transferred, and other column values survive only where the destination has matching columns. For a full-fidelity copy including version history and permissions, use Clone Master.
Does copying a SharePoint library preserve the folder structure?
Yes. Copy To recreates the source library's folder hierarchy at the destination. Files land in the correct subfolders, and any subfolder that does not already exist at the destination is created automatically during the operation.
How do I copy a SharePoint library and keep metadata values?
The native Copy to keeps column values only where the destination has matching columns, and drops managed metadata values. To copy a library with metadata intact, use Clone Master, which can build the destination library from the source schema and maps source column values to destination columns for every item, including managed metadata fields and person columns.
Need to copy across tenants? See the cross-tenant document library migration guide.