Document Management - Space Tools

Screen Location: Space Tools → Document Management → Document Management tab


The space tools document management dashboard allows space admins to add and manage workflows that can be applied in the space.

A space administrator can manage the available

Space workflows dashboard

The Space workflows dashboard is displayed by default in the Document Management dashboard. Any space workflows added to the space will be shown. On creating a new space, this dashboard is empty by default.

To add a workflow to the space, a space administrator can choose Add Workflow.

Using the Add Workflow option the space administrator can

  • add an existing workflow from the global workflows dashboard

  • create a new workflow using workflow builder or the markup editor

Space workflows - space workflows can be added to a space from the global workflows dashboard as either a global scope workflow or space scope workflow.

  • a global scope workflow remains linked to the global workflow template and only editable in the global workflows dashboard by a global administrator

  • a space scope workflow can be edited in the space and will be unique to the space

If a space administrator can also import a workflow to the space if they are a member of a Confluence user group added to the workflow importers group by a global administrator.

A single active workflow listed in the Space Workflows dashboard will be (by default) applied across the content in the space.

Global scope space workflow

A global scope workflow is active by default when added to the space workflows dashboard.

A space administrator cannot disable the global scope workflow. It can only be removed from the space.

Space scope workflow

Adding a copy of a global workflow is by default disabled when initially added to the space.

This copy is a space scope workflow and is unique to the space. It can be edited by the space administrator.

Multiple space workflows in a space

Multiple active space workflows (with no workflow content label filters or page/blog post filter) are applied in the order in which they appear on the list in the dashboard, with the first listed workflow will taking priority.

  • global scope workflows added to the space dashboard are listed at the top of the dashboard

  • workflows of the same scope are listed alphabetically

If a global scope workflow is added to the dashboard (and does not have a content label filter), this workflow is applied to all the content in the space even if there are active space workflows with a content label filter.

Application of a workflow can be filtered by both a page/blog post content setting for the workflow and a content label filter.

Page Workflows Templates dashboard

You can view templates available for users to apply in page mode by choosing the Page Workflows Templates option on the Space Workflows dropdown menu.

By default, the Page Workflows Templates dashboard will display all global workflows enabled by the global administrator in the global workflows dashboard.

A space administrator can add workflows to the Page Workflows Templates dashboard by

  • copying a global scope workflow template and editing the copy (added as a space scope workflow)

  • adding an existing space workflow

  • creating a new workflow

Page workflows - a page workflow can only be applied by user on the content if there is no space workflow active on that content. If a space workflow is enabled for content with an existing page workflow, the space workflow will be applied.

Add an existing workflow

The available workflows include those defined in Workflows - Global, and also any from Import - Space Tools.

Choose Add Workflow button (bottom of dashboard)

This opens the workflow picker.

Select a workflow and choose Next.

Choose either

  • Link to Global Template (adds workflow as an active global scope workflow and cannot be edited by space admin)

  • Copy as Space Workflow (adds workflow as an inactive copy of the global template that can be edited by the space administrator for the space)

Choose Apply to add the workflow to the space.

Create a new workflow

In the Document Management Dashboard create a new workflow by

  • choosing the Add Workflow button

  • choose Create Workflow in the workflow picker

Workflow builder is opened in the space with a simple two state workflow.

  • edit and name this workflow to create a new space scope workflow

  • choose Exit in workflow flow builder to add the new workflow to the space dashboard

A new workflow can also be created by the space admin by copying an existing workflow in the space workflows dashboard.

  • choose Copy from the ellipsis option of an existing workflow in the workflow table

The copy is saved as a disabled space scope workflow template that can be edited in the space.

Workflows dashboard listing



Name of a space scope workflow 

Click on the name to open the workflow inspector to view the description and the workflow visual flowchart.

Choose the tick slider icon to disable the workflow in the space.


Workflow with content label filter

This workflow specifies a label – it will only apply to content with that label.



Global scope workflow

You can use a workflow defined at the global level.

As a space admin, if you want to edit a global scope workflow, you must make a copy of it and edit that.

You cannot disable a global scope workflow in the space. You can only Remove it from the space using the option in the ellipsis menu.


See all available workflows for adding to the space  by choosing Workflows - Global (← Global link only shown if you are a Confluence Admin

Space workflow options

Ellipsis/Actions menu

Ellipsis/Actions menu


What it does

As seen on...


Opens the workflow editor.

See: Workflow Authoring Guide

Initialize States

Transition content to a specific workflow state in the selected workflow. Option to

  • transition to selected state for unprocessed content (for example, newly created content with no workflow activity)

  • transition to selected state and override any existing state for processed content

See: Initialize States

Any active/enabled space scope or global scope workflow


Creates a disabled space scope copy of the workflow.

All workflows


Removes the workflow from the list

  • global scope workflow is removed from space

  • space scope workflow is deleted

All workflows

Remove Warning

If you add a workflow to this screen by copying an existing workflow, or creating a new workflow, then removing it will actually delete it (because it only exists on the Document Management Dashboard).

You'll get a warning like this.