Compare ways to move Confluence pages
Shell for Confluence provides familiar commands such as ls, cd, find, tree, mv, cp, and rm. You can move multiple named pages within the same space. Use several argv sources, * / ? in the last segment of each source path on mv / cp, or pipe paths from find (including -mtime / -prune or -name; at most 100 sources). ls -l shows last-update details; ls --format csv is the machine-readable listing. tree prints an ASCII page tree (-L / --maxdepth; default depth 3). attach and less cover page attachments and long listings.
On first open, the console shows Try tips for tree, find -mtime, and ls --format csv.
When to use Shell
Section titled “When to use Shell”- You prefer commands such as
ls/ls -l/ls --format csv,cd,find(-mtime/-prune),tree, andmv. - You want to find or filter pages, then
mvorcpthem in the same space (including pipes intogrep/head/tail/wc/sort, and intomv/cp/chmod). - You need to search page content in a page tree with
find … -exec grep PATTERN. - You want tab completion (including command names and theme values), history,
^old^new, and short names viaalias/unalias(stored in this browser only). - You want to inspect or restore page versions with
checkout/restore. - You want to adjust explicit page restrictions via
chmod. It is not a space-permission admin UI or a bulk migrator. - Listing: Shell for Confluence (Kenputer). Free.
Recipes: Use cases.
Short product overview: Shell for Confluence intro
When to use another method
Section titled “When to use another method”| Need | Path |
|---|---|
| A handful of pages | Native hierarchy drag, or page Move. |
| Title-pattern move in the same space (up to 100) | Shell: mv Draft* DEST or find -name PATTERN | mv DEST (preview with -n). |
| More than 100 pages, or a different space | REST PUT /wiki/rest/api/content/{id} with ancestors: [{id: newParent}] and the next version number. Documented in Move multiple pages to another parent page. |
| Copy an entire tree then delete extras | Copy Page Tree (named in that thread’s 2017 Atlassian reply), not Shell. |
| Change title/body text or URLs | Find & Replace app (not Shell) |
| Spreadsheet multi-select / copy entire subtree / archive | Pages Manager–class GUI, or native / REST |
| Search once, then bulk-move to another space | Easy Bulk–class workbench, or REST — not Shell |
What Shell does not do
Section titled “What Shell does not do”- Bulk tree migrator or filtered multi-select Bulk panel UI for hundreds of pages (CLI globs, multi-source
mv/cp, andfind | mvare fine up to 100 sources). - Cross-space bulk move UI.
- Attachment upload or purge (list / trash / rename via
attachonly).
Canonical docs path: shell-for-confluence-cloud. Guide: https://documents.test-perspective.com/shell-for-confluence-cloud/guide-for-users/ FAQ: https://documents.test-perspective.com/shell-for-confluence-cloud/faq/
Feature requests (no promises): https://featureboard.netlify.app/product/shell-for-confluence