Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
maxLevel2
minLevel2
absoluteUrltrue
excludeRelated Links
typeflat
separatorpipe

User permissions

...

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

...

  • use the publishing dashboard ellipsis menu to Clear Publishing configuration

...

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

...

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.

Info

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 the draft (source) space and the target space.A page cannot be published by a userspaces.

The view and edit permission is needed

...

...

Info

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 user has permissions 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.

Excerpt
namepublishing_permissions_example_noeditintarget

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

...

User without edit permission in source space

If a user does not have view and edit permission for a page in the source space

...

cpc_error_message_couldnotcopypage.pngImage Added
  • 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.pngImage Added

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)

Screenshot 2024-07-26 at 17.55.21.pngImage Added

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

Excerpt
nameuserpermissiontargetspace_solution_duplicatepages

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.

Note

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 view and edit permission for a page in the source space

...

  • the page

...

  • is not

...

  • published

...

The unpublished page is also not reported

  • under the Pages that were not published list in the space publishing report

  • the

Space
  • publishing

job completed message that is added to after all the content in the space is published.

...

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

For details please view the space publishing page in the documentation.

...

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

A space administrator user in the source space who does not have the required permissions in the target space has the source space dashboard options disabled and a message is displayed confirming that they do not have enough permissions in the target space.

Info

If the space administrator is attempting to change from an existing target space, refreshing the dashboard page returns the dashboard display to the existing target space configuration.

The following options are disabled in the source space publishing dashboard

  • change target space option

    Image Removed
    • enable/disable Publishing

      Image Removed
    • clear configuration option

User with ONLY VIEW permission in target space

A user with view and edit permission in the draft space but only view permission in the configured target space will not be able to publish the content and will see the following message.

...

User without permission in target space

A user with view and edit permission in the draft space but without page permissions in the configured target space will not be able to publish the content and will see the following message.

...

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 Errors publishing to a target space page with page restrictions for details on how to resolve the publishing conflict.