User permissions for publishing

Confluence user permissions to configure publishing

To configure publishing from a source space to a target space a user must have

space administrator permission in the source space
space administrator permission in the target space

Source space set up

In a space settings publishing dashboard, a space administrator can

use the publishing wizard to Configure Publishing in a space (currently not used as a source or target space)
- adding the target space
- publishing the space

manage the publishing configuration settings for an existing source space
- enable or disable publishing
- add or change the target space
- enable or disable single page publishing
- enable or disable copying of page content properties when publishing

cpc_spacepublishingdashboard_extract_configuration_publishing_options.png

use the publishing dashboard ellipsis menu to Clear Publishing configuration

cpc_publishingdashbaord_ellipsismenu_clearpublishingconfiguration.png

Target space permissions

For a space administrator setting up a source space who does not have the necessary permissions in a selected target space

In the source space dashboard, on choosing the target space

dashboard displays a warning message confirming the user does not have enough permissions in the target space
Next option is disabled

cpc_spacepublishingdashboard_add_targetspace_no_requiredpermissions.png

If the space administrator is changing the target space in an existing source space linked for publishing and does not have the necessary permissions in the new target space

selected target space is greyed out
a warning message is displayed confirming the user does not have enough permissions in the target space

The other publishing configuration options are also disabled.

Refresh the dashboard to return the source space publishing configuration to the existing target space.

Confluence user permissions for publishing

A user publishing a page from the source space to a target space requires view and edit permission in both spaces.

The view and edit permission is needed

as a page editor publishing a single page using the publishing popup on a page

cpc_publishingpopup_outosync_sourcespace_publishbutton.png

whole space publishing using Publish space the space settings publishing dashboard

cpc_spacepublishingdashboard_sourcesapce_published_5pages.png

The Publish space option is also available in the publishing report.

The user cannot publish a page

if the user does not have edit permission for a source space page
if the user has view and edit permission in the source space but does not have these page permissions in the target space

User without edit permission in source space

If a user only has view permission for a page in the source space

the publishing status byline is not displayed
there is no access to the publishing popup
the user cannot publish the page using single-page publishing

Error - user with ONLY VIEW permission in target space

A user is unable to publish a new page in the source space if they have

view and edit permission in the source space
but only view permission in the configured target space

Error - user without view or edit permission in target space

A user is unable to publish a new page in the source space if they have

view and edit permission in the source space
but no page permissions in the configured target space

Error - user without permission on an existing target space page

If a page has already been published and synced to the target space, subsequent publishing actions are affected if the page-level permissions change.

If the user publishing the page has view and edit permission on the source space but

only view permission on the target space
- an error message is displayed when trying to publish a page

no permissions on the target space
- the page may be published as a new page in the target space without an error
- the published page title is appended with a number in brackets

cpc_projectteams_page_name_displayed_with_brackets_sidebar.png

The publishing user does not see the original published page in the target space - they do not have view permission.

For example, when publishing a source space page, Project Teams with an existing target space page with added page restrictions that affect the publishing user

a duplicate target space is created and synced Project Teams (2)

To see both pages in the target space, the user must have at least view permission for each page.

subsequent publishing actions sync to this new page

The previously published page in the target space

displays the last publishing status byline before creation of the publishing conflict and a View source link in the publishing popup
is no longer synced for publishing and the publishing status on this page does not change if the source space page is updated

Remove any publishing conflicts by deleting one of the linked target space pages.

For example:

delete the original target space page
publish and sync the source page again

The target space page name is updated and the appended (2) is removed.

If the publishing user has view and edit permission for the Project Teams page and the Project Teams (2) page, the source page cannot be published, and an unexpected error message is displayed.

Space administrator permissions for publishing

The space administrator requires permissions in the source space and the target space to publish and sync pages

space administrator permission
view and edit permission

Adding a page restriction to a page in the source space or a page in the target space affects the ability to publish a page.

Without edit permission for a page in the source space

If a space administrator does not have page edit permission for a page in the source space

when publishing all the space content the page is not published

The unpublished page is not reported

under the Pages that were not published list in the space publishing report
the publishing complete message
the source space settings Publishing dashboard

The view and edit permissions cause the page to be hidden from the Comala Publishing action for the user who is the space administrator.

For details view the space publishing page

In addition, the Publish option in the publishing popup is not displayed and the space administrator cannot publish the page using single-page publishing.

Without required permissions in the target space

Page-level permissions on the target space page

When publishing and syncing existing published pages, the space administrator must have view and edit permission on the target space pages.

A space administrator cannot publish and sync a source space page to a target space page with an edit or view restriction for the publishing user.

For example:

publishing to a target space page with an edit restriction for the publishing user
- the publishing action identifies the target page exists
- edit restriction prevents publishing
- displays an error message
publishing to a target space page with a view and edit restriction for the publishing user
- restrictions prevent publishing action syncing to the existing page
- creates a new page alternate target space page with same name but appended with a number in brackets
  - a user in the target space with view permission sees both the original published page <Pagename> and the newly published page <Pagename>(2)
- subsequent publishing syncs to the new page <Pagename>(2)
  - publishing by a user with no target space restrictions for the page causes a publishing error
  - removal of the page restrictions without removing the alternate page causes a publishing conflict
- one of the target space pages must be removed to prevent publishing conflicts
  - if the original <Pagename> is removed, a subsequent publishing action removes the appended number brackets on the alternate <Pagename>(2) page

See https://appfire.atlassian.net/wiki/spaces/CPCL/pages/edit-v2/614694991#Error---user-without-permission-on-an-existing-target-space-page for details and how to resolve the publishing conflict.