Coming soon. The Wiki is in active development, so features and these docs may still change. Early adopters: contact us for access.

Spaces

What a space is, who can see it, roles and members, icons, labels, categories, archiving, stars, space settings, and creating one

1. What a space is

A space holds a team's or a project's pages, and has its own members. Every page belongs to one space, and the space decides who can read it and who can write. Pages have no access rules of their own: everyone who can read the space can read all of its published pages.

2. The space list

Spaces in the sidebar lists every space you can see, with its icon, visibility, category, labels, when it last changed and your role. All shows them all, Yours only those where you have a role. Filter by name with Search spaces, by visibility, or by category with the chips above the list (each shows how many spaces it holds).

  • Starred spaces show as cards at the top. Select the star next to a space, on the list or on its overview, to star or unstar it. Stars are yours alone: nobody else sees them.
  • Select a label on a space to list only the spaces with that label; select it again, or the cross on the filter, to see them all.
  • Archived spaces are left out. Turn on Show archived to list them too.
Spaces: starred spaces as cards, category chips, and each space's icon, labels and role
Spaces: starred spaces as cards, category chips, and each space's icon, labels and role

Besides its pages, each space has a Blog tab for dated posts: updates, announcements and stories. See Space blogs.

3. Who can see a space

VisibilityWho can readWho can edit
PrivateOnly members of the spaceMembers with the Editor or Admin role
InternalEveryone in your organization who can sign inMembers with the Editor or Admin role
PublicAnyone, even without signing inMembers with the Editor or Admin role

A space can only be made public while anonymous access is on, which a super admin turns on in Settings → Security. If anonymous access is turned off later, public spaces stay readable by signed-in people only until it is back on. See Anonymous access.

4. Roles

Each member of a space has one role. A person can be a member directly or through a group; everyone in a group gets the group's role, and the highest role a person has counts.

CanViewerCommenterEditorAdmin
Read pagesYesYesYesYes
Comment on pagesNoYesYesYes
Create, edit, move and delete pagesNoNoYesYes
Write blog posts and edit your ownNoIf the space allowsYesYes
Edit anyone's blog post, manage the blogNoNoNoYes
Manage membersNoNoNoYes
Change name, description and visibilityNoNoNoYes
Delete the spaceNoNoNoYes

5. Members

The Members tab lists the people, service accounts and groups with a role in the space. Compare roles shows the table above. Filter by kind (People, Groups, Service accounts) or by name.

Members: each member's kind and role, with the role comparison open
Members: each member's kind and role, with the role comparison open
  1. Open the space, then Members.
  2. Add member, search for a person, service account or group, pick a Role and Add.
  3. To change a role, pick another one next to the member. To take a member out, Remove and confirm. Roles they have through a group stay.

Only the space's admins can add members or change roles. Only the space's members, and people allowed to view profiles, can see who has a role in it.

6. Creating a space

Create → Space in the header, or New space on the space list, opens the form. By default only super admins may create spaces. Creating a space gives nobody a role in it: add members, and an admin, right after.

New space: name, key, description and visibility
New space: name, key, description and visibility
FieldWhat to enter
NameWhat people call the space, such as Engineering handbook.
KeyUsed in links (/spaces/eng). 2–40 lowercase letters and digits, optionally separated by single hyphens. It can't be changed later.
DescriptionWhat the space is for, shown on its overview.
VisibilityPrivate, internal or public (above).

7. Icon, labels and category

Each space has an icon, which shows next to its name on the space list, its overview and the space switcher. Until an admin picks one, the space shows the first letters of its name. Space admins change it in Settings → General with Change icon…:

KindWhat it is
GalleryOne of 24 built-in abstract images, grouped by style (gradients, rings, stripes, waves, shapes, dots). Surprise me picks one at random.
InitialsUp to 8 characters, such as two letters or an emoji, on one of six theme colours. Left empty, the letters come from the space's name.
UploadYour own image: PNG, JPEG or WebP, up to 2 MB. It is cropped to a square from the middle.

The preview shows the icon as it will appear. Use this icon saves it at once.

Space icon: the gallery with its style filters, and the preview
Space icon: the gallery with its style filters, and the preview
  • Labels: up to 10 per space. They are the same labels pages carry, so a label's page lists the spaces with it as well as its pages. See Labels and feedback.
  • Category: one per space, or none. Categories group the space list; the list of categories is kept by administrators in Settings → Space categories (below).

8. Archiving a space

A space that is no longer worked on can be archived instead of deleted. Space admins set Status to Archived in Settings → General and save.

  • Its pages stay readable by the same people, but nobody can create, edit, move or delete pages, write blog posts, comment or import into it, admins included.
  • It is left out of the space list (unless Show archived is on) and of the space switcher. Links and search still find its pages.
  • Its overview says it is archived and since when.
  • To restore it, set Status back to Active. Members, roles and settings are kept while it is archived.

9. Space categories

Settings → Space categories holds the categories spaces can be in, such as Teams, Projects or Knowledge base: add, rename, reorder or remove them, then Save. Up to 50 categories, each up to 50 characters. Removing a category leaves its spaces in none. It needs the settings:write permission, which super admins have.

Settings → Space categories: the list in the order the space list shows it
Settings → Space categories: the list in the order the space list shows it

10. Space settings

The space's admins see a Settings tab:

  • General: the name, description, visibility, icon, labels, category and status. Save applies them; Discard puts back what is saved. The key is fixed.
  • Templates: the space's own templates, and which of the library's templates it offers. See Copies and templates.
  • Delete space: removes the space, its pages and its members' roles for good. Type the space's key to confirm.
Space settings → General: icon, name, description, labels, category, status and visibility
Space settings → General: icon, name, description, labels, category, status and visibility

Deleting a space can't be undone. Its pages don't go to the trash.

11. Events and API for space properties

Changing a space's icon, category or status raises space.update; archiving and restoring also raise space.archive and space.restore, changing its labels raises space.label.update, and saving the category list raises space_categories.update. Policies can refuse them, for example to keep certain spaces from being archived, and automation can react. Stars raise no event: they are personal, like watching a page. Every change except a star is in the audit log.

MethodPathPermissionWhat it does
PATCH/api/spaces/{key}Space adminAlso sets icon (initials or gallery), categoryId (0 for none) and status (active or archived)
PUT/api/spaces/{key}/iconSpace adminUpload an image as the icon (the raw PNG, JPEG or WebP as the body)
GET/api/spaces/{key}/iconRead the spaceThe uploaded icon
PUT/api/spaces/{key}/labelsSpace adminReplace the space's labels
PUT, DELETE/api/spaces/{key}/starRead the space, signed inStar or unstar the space for yourself
GET/api/spacesSigned in or anonymousAlso filters by status, category, label and starred=true
GET/api/wiki/space-categoriesAnyone who may list spacesThe categories
PUT/api/wiki/space-categoriessettings:writeSave the category list whole

12. Other tabs

  • Locked pages: the space's page locks, with who locked each page and Unlock, for the space's admins. See Page locks.
  • Trash: pages deleted in the space, for people who can edit pages. See Pages and the page tree.
  • Import: bring in a Confluence space export or Markdown files (space admins, when imports are allowed). See Import and export.
  • Analytics: how the space's pages are read, when your licence includes analytics. See Analytics.