---
title: "Switch between draft and published"
canonical: "https://support.appfire.com/space/CDML/649858126/Switch%20between%20draft%20and%20published"
format: markdown
---
> Macro (aura-html)


## Overview

A workflow with a **final state**<span style="color: #172b4d"> differentiates between content in a </span><span style="color: #172b4d">**draft state,**</span><span style="color: #172b4d"> content in the</span><span style="color: #172b4d">** final state**</span><span style="color: #172b4d">,</span><span style="color: #172b4d">** **</span><span style="color: #172b4d">and</span><span style="color: #172b4d">** **</span><span style="color: #172b4d">the </span>**final state version**<span style="color: #172b4d">.</span>

![image](media://54649224-60b1-4151-869c-c62534cc1acc)

> Macro (excerpt)
> 
> Adding a final state to your workflow supports [same-space publishing](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649794062) of content. The workflow treats the published version differently from the draft (unpublished) versions.
> 
> By default
> 
> - users with [view-only permission](#) will only see the most recently published version - **the final state version**. They also can't see draft content versions
> - users who have [edit or admin permission](#) can see all versions, and easily switch between the latest published and draft versions using link breadcrumbs added to the page

> ℹ️ In [same-space publishing](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649794062), the published version is the version created on a transition into the `final` state in the workflow.
> ℹ️ 
> ℹ️ Editing of content in the  `final` state will create a new version *but the ****final state version**** will remain as the version created on transition into this state*.
> ℹ️ 
> ℹ️ This is why it is good practice to transition out of the `final` state if the content is changed, for example by adding an **[updated](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650120593)**[ transition](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650120593) to the  `final` state.

## Byline links

The byline breadcrumbs on a page depend on whether the currently viewed version is in a **draft state**, the **final state,** or the **final state version**.

Visibility of these byline breadcrumbs and links is based on the Confluence user permission.

### Draft state

If both published (final state) and draft versions are available, you will see an additional link, in parentheses, on the [workflow status bar](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650117676).

![image](media://63455e11-027e-401b-af98-39e84e8732c9)

- the link with the state indicator circle( **Review **) - the version you are currently viewing
  - this is the content** draft state**
- the link in brackets, ( <span style="color: #97a0af">**view “**</span>**Published**<span style="color: #97a0af">**”**</span> ) takes you to the published version of the page
  - this is the version created on the last transition to the **final state** in the workflow - the **final state version**

### Final state

A **final state** will be, by default, displayed on the page subtitle with a green state indicator circle (or green lozenge in [workflow builder](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650151179))

![image](media://b18c018f-3059-410b-8fcd-d0648e9f6661)

The transition to the **final state** sets the workflow **final state version**. When the content is in any other state in the workflow the content will be treated as **draft content**.

> ℹ️ Editing of content in the **final state** will create a new version *but the ****final state version**** will remain as the version created on transition into this state. *No link will to the **final state version** is added to the byline on the content in the **final state**.

### Final state version

In the published **final state version**, the status bar displays an additional link if the content is being edited in a **draft state**.

![image](media://15573f98-ad18-4c61-913b-4e9da3c53f9b)

This is *a view* of the **final state version** and is **NOT** a view of the content in the **final state**.

- the name of the final state is displayed in the byline for information. This is ***not a link*** *and does not access the workflow popup*
- the current content is in the **draft state** shown in the link in brackets (view "**Review**")

In the default app configuration, only users with are space admins or page editors (Confluence 'edit and view' or 'admin' permission) will see these status bar links. 

## URL for published content

When switching between draft and published content, the URL may change.

For example, if the draft content was at the following URL:

```plaintext
https://confluence.yourcompany.com/display/SPACEKEY/Some+Page
```

The published content is found at:

```plaintext
https://confluence.yourcompany.com/display/public/SPACEKEY/Some+Page
```

> 📝 The published page includes  `/public` in the URL.

The two URLs are required to differentiate between which version of content they are looking at. This only applies to users with Confluence edit or admin permission.

Ordinary users, with view-only permission, always see the normal URL.

## App configuration

| Setting | Where | Notes |
| --- | --- | --- |
| **Workflow Activity and Drafts Visibility** | - [Configuration - Space Tools](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649956239)
- [Configuration - Global](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649889951) | Determines which users can see unpublished drafts. |
| **Default View** | - [Configuration - Space Tools](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649956239) | Determines whether published or draft content is seen by default. |
| **Published View Macro Transform** | - [Configuration - Space Tools](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649956239)
- [Configuration - Global](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649889951) | Determines whether the macros<br>- `{include}`
- `{excerpt-include}`<br>display most recently published version or, regardless of workflow state, the latest version of content. |

## Related pages

- [https://appfire.atlassian.net/wiki/spaces/CDML/pages/650117676](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650117676)
- [https://appfire.atlassian.net/wiki/spaces/CDML/pages/650152863](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650152863)
- [https://appfire.atlassian.net/wiki/spaces/CDML/pages/649923873](https://appfire.atlassian.net/wiki/spaces/CDML/pages/649923873)
- [https://appfire.atlassian.net/wiki/spaces/CDML/pages/650217543](https://appfire.atlassian.net/wiki/spaces/CDML/pages/650217543)