Get started - Publishing settings and permissions

Publishing dashboard

After installing Comala Publishing, the space administrator can use the space publishing dashboard to configure a space to publish pages in another space on the same Confluence Cloud site.

You can review and change the configuration in the setup wizard before first publishing a space. The publishing configuration is changed in the source space publishing dashboard. You must have added a target space to change any other publishing setting for the space.

When a target space is selected and saved in the publishing dashboard, publishing is enabled by default. A user can use the app to publish pages from the current space to the target (public) space.

cpc_publishingdashboard_5pagespublished.png

Publishing permissions

Publishing configuration

To set up or change the publishing configuration, you must be a space administrator in the source space and the target space.

Publishing pages

To publish all the pages in a space, you need permissions in the source space and the target space.

In the source space:

  • a space administrator requires view and edit permission for all the pages

  • a page editor publishing an individual page needs view and edit permission

You also need view and edit space permissions in the target space to publish a page.

In the default publishing configuration, pages are published and synced using the Comala Publishing app add-on user permissions in the target space.

cpc_confluencespace_user_publishinguser_permissions_highlighed_min.png

Using the add-on user permissions in the target space to publish pages lets you remove user edit permissions in the published target space, which can support compliance needs.

You can configure publishing to use the target space permissions for the publishing user instead of the app add-on user permissions.

The publishing user then needs at least the following space permissions in the target space to publish a page:

  • View All

  • Add and Delete Pages

  • Add and Delete Attachments

Do not change the permissions for the app add-on user!

Page-level restrictions on a page in the target space prevent a space administrator from publishing and syncing the source space page. As a space administrator, if you publish all the pages, a restricted page in the source space is not included in the list of 'Pages not published' in the whole space publishing report.

Publishing configuration

In the publishing dashboard, you must add a destination space for your published pages - the Target space - to change any other publishing setting in the dashboard. You can also use this option to change the target space and publish and sync pages to a different space.

When a target space is configured, Enable publishing is active by default.

The default publishing configuration lets you publish and sync pages from this source space to the target space using

The publishing actions use the Comala Publishing app add-on user permissions in the target space to publish pages. Although publishing users must have view and edit permission in the source space, there is no need for a Confluence user who publishes content (a page editor or a space administrator) to have edit permissions in the target space

The space administrator can configure publishing to:

  • prevent any publishing from the space, for example, during a period of audit, by making Enable publishing inactive

  • change the Select user performing publishing action to choose the user who is responsible for the publishing action and use this user’s view and edit permissions in the target space for single-page publishing and space publishing

By default, the Comala Publishing for Confluence Cloud app add-on user is selected. On installing the app, the app add-on user is added to all the spaces in your Confluence Cloud site with view and edit permissions.

  • prevent the copying of page content properties. This is useful if there is a 3rd party app in the target space

In Space publishing, a space administrator can use the Publish space button to publish and sync all the space pages in the space to the target space.

If all the pages have been previously by a space administrator, for example, if you used the setup tool and published the space, details of the last space publish action are displayed.

The See details link displays a report for the last publishing of all the pages in the space.

Next: Publishing pages

After a space is configured for publishing, you can publish and sync pages using single-page publishing as pages are updated and space publishing to publish and sync all the pages in a space.