Smart Solutions
Need help?
  • 100% Free & MIT Licensed
  • No third-party data hosting
SharePoint MigrationHow-toMicrosoft 365

How to copy a SharePoint library to another site with full version history (same tenant)

8 min readBy Offered as a service by our team

The most common SharePoint move isn't a tenant migration — it's an internal reorg. A team gets renamed, a department gets split, a project graduates from a scratch site to a proper hub site, and now you need to move a document library to a different site in the same tenant without losing version history or making yourself the author of every file.

SharePoint's built-in Move command works for individual files, but it doesn't scale to whole libraries and it doesn't always preserve version history the way you'd expect. Here's the workflow we use.

Scope: same tenant (cross-tenant covered separately)

To be clear up front: this workflow is for same-tenant moves — source and target both live in the same Microsoft 365 tenant. For cross-tenant moves (Contoso.com → Fabrikam.com), switch Smart Copy to Multi-tenant and set up Identity mapping — see the cross-tenant workflow. Microsoft's own SharePoint Migration Tool (SPMT) is not an option here — SPMT is designed for on-prem / file-share → SharePoint Online lifts, not for cross-tenant or same-tenant SharePoint Online → SharePoint Online copies.

Why not just click Move in the SharePoint UI?

  • File-by-file only — no whole-library move.
  • Version history — behavior varies; some scenarios collapse versions.
  • Custom columns — silently dropped when the target library lacks matching columns.
  • Author metadata — you become the "Modified By" on some paths.
  • No report — nothing to hand to auditors.

The workflow

1. Create an Azure AD app registration

In Entra ID → App registrations → New registration. Add the application permissions Sites.FullControl.All (SharePoint) and Files.ReadWrite.All (Graph). Grant admin consent. Copy the Application (client) ID.

2. Install Smart Copy

Download the free SharePoint Smart Copy Windows app from GitHub. Open Settings, paste your Client ID and Tenant ID (your domain, e.g. contoso.onmicrosoft.com), save, and sign in as an admin.

3. Pick source and target

Browse to the source site, pick the library. Smart Copy shows file count, total size, and version count so you know the shape of what you're about to move. Browse to the target site (any site in the same tenant), pick or create the destination library.

4. Turn on the preservation options

  • Preserve version history — every version of every file is recreated in the target with its original comment and timestamp.
  • Preserve original Created By / Modified By — the person who actually created and edited the file remains the author. Without this, every file looks like it was created by whoever ran the copy.
  • Copy permissions — unique role assignments on individual files and folders are recreated on the target. This is one of the biggest gaps in the built-in SharePoint Move command and in most PowerShell scripts, and it's a single checkbox here. Leave it off if you want the target library's inherited permissions to take over instead.

5. Run the copy and validate

Start the job. Smart Copy shows live progress per file. When it finishes, open the target library and pick three random files. Click Version history on each — every version, timestamp, comment, and original author should be present. Export the post-run report to Excel; that's your audit trail.

6. Prove it with a Verification Report

Spot-checking three files is a sanity check, not evidence. For evidence, open Copy History, select the run, and click Verify. Smart Copy walks the source and target folder trees again with fresh Microsoft Graph API calls — not data collected during the copy — and writes an Excel workbook with Overview, Source, Target, Comparison, and Scan Errors sheets. Most file types are compared by Graph's content hash; Office and Outlook files fall back to a modified-date check because SharePoint routinely re-serializes them for indexing (which changes the hash without changing the content).

For anything with legal-hold or compliance implications, also tick Deep Verify Office files — that downloads every flagged .docx/.xlsx/.pptx/.vsdx pair and compares their internal content byte-for-byte, ignoring only the specific parts SharePoint itself rewrites (Document IDs, custom document properties). Files that are byte-identical in real content are then reported as ordinary matches. That Excel workbook is what you give to the auditor.

What this workflow covers

  • Document libraries — full version history, authors, timestamps, custom columns.
  • Custom lists and list items (from the same tool).
  • Modern Site Pages (from the same tool).
  • Item-level permissions and unique role assignments — copied as an option.
  • Whole-site copies within the same tenant.

What it doesn't cover

  • Cross-tenant moves — use Smart Copy's Multi-tenant mode with identity mapping, or ShareGate / AvePoint Fly (SPMT does not support cross-tenant or SPO-to-SPO moves).
  • Power Automate flows bound to old URLs — rebind manually.
  • Nintex / K2 workflows — vendor migration tooling.
  • Teams chat history — Teams admin migration tooling.

Related

Free · MIT license · no sign-up

Get your first result in about 10 minutes

Copy sites, libraries, lists and pages with full version history. Free, MIT licensed, no sign-up.

  1. Download the Windows app from the latest release.
  2. Run it and sign in to your Microsoft 365 tenant.
  3. Pick a source and target site, then copy.
Install guide
Download the latest releaseView on GitHub
Email me when a new release ships
Get notified when SharePoint Smart Copy updates

No marketing spam. One short email when a new release ships. You can unsubscribe anytime.

Was this page helpful?

One click. No form, no email address.

Missing something in SharePoint Smart Copy? Feature requests and bug reports go straight to the developer on GitHub — no account needed to read, free account to post.

Request a feature

Related tool

SharePoint Smart Copy

Copy sites, libraries, lists and pages with full version history. Free, MIT licensed, no sign-up.

Running out of storage?

Let our team build your storage cleanup plan

We find what is driving your storage use, set version-history and retention policies that fit your organization, and help you avoid buying extra storage.

About the author

Sean Regan

SharePoint & Microsoft 365 consultant with 20+ years of hands-on experience building SPFx web parts, migration tooling and tenant-grade automation. Maintainer of the open-source SharePoint Smart Solutions suite.