Smart Copy vs PnP PowerShell for copying SharePoint content
Every SharePoint admin has the same first instinct when asked to move content: open PnP PowerShell and pipe Copy-PnPFile at it. It's free, it's already installed, and for a folder of 20 files it works exactly as advertised. The problem is that "20 files" and "a real document library" behave completely differently, and the failure modes only show up at scale.
This post is an honest side-by-side of PnP PowerShell against the free open-source SharePoint Smart Copy app. Both are free. Both run against SharePoint Online. They fail in very different places.
Where PnP PowerShell breaks down
1. Timeouts on long-running jobs
Copy-PnPFolder and Copy-PnPFile ultimately call CSOM or Microsoft Graph. Both have request timeouts (typically 30 minutes for the Graph copy operation, shorter for CSOM). A single library of a few thousand versioned files routinely exceeds that. The script throws a ServerException, PowerShell exits, and you're left guessing which files landed and which didn't. Retries have to be rebuilt by hand — usually a second script that diffs source and target and re-runs the delta.
2. Version-history metadata quietly collapses
This is the one that catches people out. Copy-PnPFile copies the current version's bytes cleanly, but prior-version metadata is where the gaps are: the original author on version 3, the check-in comment on version 5, the exact timestamp on version 7 — many of these come across stamped with the account that ran the script and the current time. If you're moving files for an audit or a legal hold, that's not "preserved" version history, that's fabricated version history.
3. No per-file reporting
PowerShell gives you a stream of exceptions in the console. There is no built-in per-file report of what copied, what skipped, what failed and why. On a 5,000-file library, reconstructing that from a scrollback buffer is a job in itself.
4. Throttling handling is your problem
SharePoint Online will throttle any script that hammers it. PnP handles some 429s automatically, but not all — long copy jobs still hit hard-stop throttles and you'll need to add your own Start-Sleeplogic and exponential backoff.
Side-by-side
| Capability | PnP PowerShell | Smart Copy |
|---|---|---|
| Cost | Free | Free (MIT) |
| Handles 5,000+ file libraries in one job | Prone to timeout | Chunked with retry |
| Preserves original author on prior versions | Unreliable | Yes |
| Preserves check-in comments per version | Unreliable | Yes |
| Preserves original timestamps per version | Unreliable | Yes |
| Copies item-level permissions | Manual — extra script | Checkbox |
| Per-file success / failure report | No (console only) | Exportable to Excel |
| Automatic 429 / throttle backoff | Partial | Built-in |
| Resume from failure | DIY — diff and re-run | Delta-copy from report |
| Independent post-copy verification | DIY — write another script | Verify button → Excel workbook (hash, date, optional Deep Verify) |
| Ideal batch size | Dozens | Whole libraries / sites |
When PowerShell is still the right tool
- Twenty files between two folders, one-off.
- Fully automated pipelines where you already own the retry, logging, and reporting layer.
- Copies that don't touch version history at all — a single-version file into a fresh library.
When to reach for Smart Copy instead
- Any move over a few hundred versioned files.
- Anything with audit / compliance / legal-hold implications — the version-history metadata has to be intact.
- Anything where you'll be asked "what got copied?" — the exportable report is the answer.
- Anything where the copy needs to include item-level permissions.
Related
Get your first result in about 10 minutes
Copy sites, libraries, lists and pages with full version history. Free, MIT licensed, no sign-up.
- Download the Windows app from the latest release.
- Run it and sign in to your Microsoft 365 tenant.
- Pick a source and target site, then copy.
Email me when a new release ships
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 featureRelated tool
SharePoint Smart Copy
Copy sites, libraries, lists and pages with full version history. Free, MIT licensed, no sign-up.
Keep reading
SharePoint Migration Tools 2026: Free vs ShareGate & SPMT
Free vs paid SharePoint migration tools tested for 2026: what each preserves, where each breaks, and which one fits tenant-to-tenant, file-share, on-prem, and SPO-to-SPO moves.
How to Copy a SharePoint List Structure: Columns, Content Types and Views
How to copy a SharePoint list or library's columns, content types, views and settings to another site, with or without the items.
Free SharePoint Tenant-to-Tenant Migration (2026): Step-by-Step With Smart Copy
A free, step-by-step SharePoint tenant-to-tenant migration: Multi-tenant mode, identity mapping and full version history with Smart Copy.
Want our team to do it for you? If you would rather not run this yourself, our team can plan and run your migration using the free tools on this site. You get hands-on help and no software license to buy. Talk to us
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.
