---
title: "Space publishing"
canonical: "https://support.appfire.com/space/CPCL/646578843/Space%20publishing"
format: markdown
---
> Macro (aura-html)


## Overview

A space administrator can publish all source space pages to a target space (space-publishing) in a single action using the **Publishing space** option in the app space settings.

![image](media://828e2ccb-7ba2-4d81-9276-bc1ce035bc8c)

The **Publish space** option is only displayed if a [target space has been configured](https://appfire.atlassian.net/wiki/spaces/CPCL/pages/646219345) and [publishing is enabled](https://appfire.atlassian.net/wiki/spaces/CPCL/pages/646251946) in the app space settings.

> ℹ️ [Publishing does not include](https://appfire.atlassian.net/wiki/spaces/CPCL/pages/646088074) the space home page, blog posts, and archived pages.

The first time the source space is published to a target space 

- all the source pages are published

> 📝 When you apply a Comala workflow in the source space, you can limit the space publishing action to pages in the workflow’s final state.

On a subsequent whole space publishing action, using the **Publish space** button

- pages with a publishing status of **New** or **Out of sync** are published
- pages with a **Synced **publishing status are *not republished*

This filtering of the synced pages reduces the time required to complete the whole publishing action.

The space administrator can also publish pages using the **Publish pages** option in the [publishing report](https://appfire.atlassian.net/wiki/spaces/CPCL/pages/1072562207).

Publishing from the report can be filtered to publish

- all the pages, irrespective of the publishing status
- the pages that are not synced

> ⚠️ Comala Publishing is designed to publish pages to an “**empty**” target space (except for the space homepage). Although a space with existing pages can be configured as a target space, setting a target space containing existing page titles that are the same as in the source space can cause publishing issues.

## Publish a space

In the app space settings in the source space

- scroll down to the **Space publishing** option
- choose the **Publish space** button

![cpc_publishingdashboard_selectuserpermissionsforpublishingoption_targetspace human resources_addonuser_selected.png](media://c64713c5-fef4-4925-9b41-1555c14a8821)

> ℹ️ You must add a target space using the **Target space **dropdown menu for space publishing to be active.

By default, the app add-on user permissions in the target space are used for the space publishing action as the user who performs the publishing action.

![cpc_selectuserforpublishing_appuser_selected_dropdownoptions.png](media://15284276-1f0b-4bde-b2d5-1ce9a9e97fa6)

Changing the **Select user performing publishing action** requires the space administrator to have** view** and **edit** permissions in the target space.

The space administrator can

- enable or prevent [single-page publishing](https://appfire.atlassian.net/wiki/spaces/CPCL/pages/646578988) in a space to prevent page editors from publishing pages page-by-page
- configure if the publishing action includes [copying the content properties](https://appfire.atlassian.net/wiki/spaces/CPCL/pages/646775243) for each page

 In the dialog box, choose Publish to confirm the publishing of all pages in the current space to the target space.

![image](media://3dbeaf15-2c5d-46ea-b2bf-86397c750c54)

> 📝 While space publishing occurs, all other user publishing (page and other space publishing actions) are inactive until the publishing is complete. However, a publishing action using a Comala Document Management workflow can still take place.

If the source space does not include any **NEW** pages to publish, **OUT OF SYNC** pages, or is empty

- a **No pages to publish** warning message is displayed

![image](media://bd4d43a9-7aea-43bd-9816-e44529849d55)

> 📝 The message can be shown on the initial space publishing of a space with a newly created single page due to the time required to update the space publishing information on the newly created page.

If the source space includes pages that are already published, any pages with a **SYNCED** status are not published

- only unpublished pages (**NEW** publishing status) and pages that are **OUT OF SYNC** are published
- the number of pages to publish is displayed in the dialog box

![cp_spacepublish_warning_number of pages to publish.png](media://220611bb-f677-4af2-9e2c-756059cb2fae)

- choose **Publish** to confirm the publishing of the pages

## Copying content properties

By default, [copying content properties](https://appfire.atlassian.net/wiki/spaces/CPCL/pages/646775243) when publishing a page is enabled for the space. A space administrator can choose to prevent copying of content properties for source space pages in the [source space app settings](https://appfire.atlassian.net/wiki/spaces/CPCL/pages/646644089).

![image](media://86e29517-1a7e-41b7-a9a5-cff8f7c97cfb)

## Space publishing progress bar

A progress bar displays the progress of the space publishing process.

![image](media://12bd6055-5102-4b82-8e96-a8e2eb4ddce0)

Once the space publishing process finishes, the progress bar will display confirmation that publishing is complete.

![image](media://d119e378-94f1-4a89-bc5b-254dc7f5a552)

A summary report of the completed publishing for the space is displayed.

![image](media://f8687f0f-54ad-499f-b6ae-7118a6f6a5d7)

Choose **Back** to return to the app space settings.

The last publication details are added underneath the Publish Space button in **Space publishing.**

![image](media://de0f40e7-40ce-4f17-bb4c-17a373474276)

Choose <span style="color: #4c9aff">**See details**</span> to display the [space publishing report](https://appfire.atlassian.net/wiki/pages/createpage.action?spaceKey=cpcd&title=Space%20publishing%20report&linkCreation=true&fromPageId=614695886).

![image](media://8fcae9f7-4f33-4634-89a1-ec32c42be7a2)

## Limiting space publishing to pages in the final state of an applied workflow

When a Comala workflow is active in the space, this option excludes pages not in the final state of the applied workflow from being published during a space publish action.

![cpc_publishingsettings_exteract_publish_wf_final_state.png](media://a29803d3-0d58-4ed8-9f56-33c7b17069e4)

When active, pages in the final workflow state that are already synced are not published.

> 📝 This setting does not affect the automatic publishing of a page when a page editor uses an applied workflow to transition to the final state.

## Partially completed space publishing

A warning message is displayed in the progress bar if one or more source space pages are not successfully published during a whole space publish.

![image](media://e39412c7-01a6-4cf7-bc87-fd5a9cd96269)

The last publication details are added to the space publishing dashboard, along with a **Partially completed** publishing warning and a summary of the number of pages published.

![image](media://e2068a0d-1d94-48af-88df-847cbdb0d281)

Choose the <span style="color: #4c9aff">**See details**</span> option to view the [space publishing report](https://appfire.atlassian.net/wiki/pages/createpage.action?spaceKey=cpcd&title=Space%20publishing%20report&linkCreation=true&fromPageId=614695886) that displays a list of the pages that failed to be published.

> ⚠️ If the space administrator does not have **view** and **edit** permissions over a page in the source space, the page is not published to the target space.

The unpublished page with restrictions page is also not reported under the **Pages that were not published listing** in the space publishing job completed report because the view and edit permissions cause the page to be hidden from any publishing action for this space administrator.

## Space publish error

If there is a problem completing the space publishing action, the following error message is displayed.

![image](media://4c253664-749a-4ee2-97da-bd4e6e28fe04)

Simply retry the publishing action at a later time.

> ℹ️ For repeated problems with publishing your space that you cannot solve, open a ticket with our [support team](http://appf.re/support).

## Space publish after initial whole space publish

After an initial whole space publish, only new and previously published pages that are currently out of sync are published using the **Publish space** option. The number of pages that are set to be published is displayed in the dialog box.

![cp_spacepublish_warning_number of pages to publish_onetopublish.png](media://91366d93-8fe9-48df-a18a-ac35f9f79093)

After space publishing is complete, the **Space publishing** details in the dashboard are updated with the **Publish space **action.

![cp_spacepublishing_onepagepublished.png](media://1e8ccd98-bf2f-41d9-9fe3-ae3cd26bc366)

> 📝 The details displayed are only for the most recent **Publish space** action. They do not display the total number of pages published in the space, as some pages may have been published in one or more previous **Publish space** actions or by the [single-page publishing](https://appfire.atlassian.net/wiki/spaces/CPCL/pages/646578988) option.

## Publishing pages from the publishing report

A space administrator can publish the source space pages displayed in the [publishing report](https://appfire.atlassian.net/wiki/spaces/CPCL/pages/1072562207).

![cpc_publishingreport_statenotsynced_publish_2_pages_.png](media://6b64a317-9f4d-4ead-9fed-57069296ea38)

The report can be filtered to display

- all the pages in the source space with any publishing status
  - **ANY STATE** report filter
- any state not synced (New; Out of Sync publishing status)
  - **state NOT SYNCED **report filter
- all the pages in an applied workflow final state and not synced
  - **Final workflow state + Not Synced** report filter

The filtered list is published in a single publishing action using the **Publish pages** option in the report.

### Publishing using the report

Open the publishing report using the Confluence sidebar options

- choose **Apps>Comala Publishing**

> Macro (excerpt-include)



## Related pages

> Macro (contentbylabel)