Skip to content

Understand the filesystem

Shell maps your Confluence site to a filesystem:

/ +
+-- /<space1> +
| +-- /<page1> +
| | +-- /<page1a>
| +-- /<page2>
+-- /<space2> +
+-- /<page1>
  • The absolute path to <page1a> is /space1/page1/page1a.
  • <space1> and <space2> are global, personal, collaboration, and knowledge_base space names.
  • <page1>, <page2>, and so on are page titles.
  • / is the site root. Run ls there to list the spaces you can access. Archived spaces aren’t shown.

If a space or page name contains spaces, enclose that part of the path in single quotation marks:

$ cd 'My space'
$ ls /'My space'/'Getting started'

You can combine a quoted name with the next part of the path:

$ ls 'sample pages'/child
$ touch ./'Weekly notes'

A leading ./ or ../ inside quotes is read as a relative path, so touch './Weekly notes' creates Weekly notes in the current space or page. Double quotes ("./Weekly notes") and backslash-escaped spaces (./Weekly\ notes) work the same way. A quoted span is still one title: './a/b' is a single title a/b; write ./'a'/'b' for nested titles.

To treat / as part of a page title instead of a path separator, enclose the full title in single quotation marks:

$ cd 'Release notes (2024/11)'
$ pwd
/SpaceName/Release notes (2024/11)

Without quotation marks, / splits the path, so cd can’t find the page.