Overview
When using Comala Publishing to manage and publish pages from a source space in Confluence Cloud, internal and external links are handled carefully to ensure they work correctly after publishing.
When the link destination is a URL and is to another page in the source space
the published page link points to the target space page version, updating any display text and URL accordingly
these links are automatically updated each time the page is published to prevent broken links
Links to pages in other spaces or external locations remain unchanged when publishing a page. Different Confluence link formats in the source space page may affect how Confluence displays the link on the published target space page.
In-page links to headers or anchors in another page in the source space added as the destination URL in a Confluence link type are not updated.
Publishing in-page links
URL | Source space in-page link | Published target space in-page link |
|---|---|---|
URL | Displayed link on the source space page to another page in the source space:  | Displayed link on published and synced page:  The displayed published in-page link is replaces the source space displayed URL with the title of the destination page in the target space. Published and synced target space in-page link URL is updated with the space key for the target space and the target space page contentID. |
URL in source space to another page in the source space (space key CPCD) is: https://appfire.atlassian.net/wiki/spaces/CPCD/pages/614696400/User+Guide | The link URL in the published and synced target space is updated to point to a page in the target space: https://appfire.atlassian.net/wiki/spaces/CPCL/pages/646807689/User+Guide
The published link URL uses the same page name as the source space page. | |
The published URL link URL is updated to a destination URL for a page the target space. | ||
Custom display text | Displayed link on the source space page to another page in the source space:   | Displayed link on published and synced page: The published in-page link is maintains the source page Display text link configuration. Published and synced target space in-page link URL is updated with the space key for target space and the target space page contentID. |
URL in source space with space key CPCD configured to Display text is: https://appfire.atlassian.net/wiki/spaces/CPCD/pages/614696400/User+Guide | URL in target space for the displayed link is https://appfire.atlassian.net/wiki/spaces/CPCL/pages/646807689/User+Guide
The published link URL uses the same page name as the source space page. | |
The published URL custom display text link URL is updated to a destination URL for a page the target space. | ||
The following URL type links in a source space page are not updated on publishing:
short page links (both URL and URL with custom display text links)
links to another page in the same Confluence site (both URL and URL with custom display text links)
inks to another page on an external site (both URL and URL with custom display text links)
Inline | Source space in-page link | Published target space in-page link |
|---|---|---|
URL | Displayed link on the source space page to another page in the source space:  | Displayed link on published and synced page:  |
Inline link URL in source space with space key CPCD is: https://appfire.atlassian.net/wiki/spaces/CPCD/pages/614696400/User+Guide | Inline link URL in target space is https://appfire.atlassian.net/wiki/spaces/CPCL/pages/646807689/User+Guide
| |
The published inline link URL is updated to a destination URL for a page in the target space. | ||
The following inline type links in a source space page are not updated on publishing:
short page links (both URL and URL with custom display text links)
links to another page in the same Confluence site (both URL and URL with custom display text links)
links to another page on an external site (both URL and URL with custom display text links)
Card | Source space in-page link | |
|---|---|---|
Page in the source space |  |  |
Card link URL in source space with space key PMCD is: https://appfire.atlassian.net/wiki/spaces/PMCD/pages/614696456/Product+Lifecycle | Card link URL in target space is: https://appfire.atlassian.net/wiki/spaces/PMCL/pages/616696410/Product+Lifecycle
| |
The published card link URL is updated to a destination URL for a page in the target space. | ||
The following card type links in a source space page are not updated when publishing the page:
short page links
links to another page in the same Confluence site
links to another page on an external site
Embedded | Source space in-page link | |
|---|---|---|
Short link to another space or location |  |  |
Card link URL in source space with space key PMCD is: https://appfire.atlassian.net/wiki/spaces/PMCD/pages/614696456/Product+Lifecycle | Card link URL in target space is: https://appfire.atlassian.net/wiki/spaces/PMCL/pages/616696410/Product+Lifecycle
| |
The published embedded link URL is updated to a destination URL for a page in the target space. | ||
The following embedded type links in a source space page are not updated when publishing the page:
short page links
links to another page in the same Confluence site
links to another page on an external site
Publishing in-page links to headers and anchors
Links to and from page headers and anchors are treated differently from page links added to the Confluence link macro types.
Links added to page headers
A link to another space page added to a page header is not updated on the published target space page. These links are treated as absolute links and are not updated when publishing the page.
In-page links to headings and anchors added to Confluence link types
In-page hyperlinks to headings or anchors in another source space page are not updated to the target space when a page is published.
Example
In a source space page, Product Lifecycle, a link to a page header, User interface in the Product MVP is added as an in-page link.
https://appfire.atlassian.net/wiki/spaces/PMCD/pages/614696410/Product+MVP#User+interface
If you click the in-page link in the published Product Lifecycle page in the target space, you are directed to the PMCD source space page. The link has not been updated to the target space Product MVP page.
In-page links created in macros
In-page links on a source space page created using macros such as the children or page tree macros are updated. When using Confluence page macros to add dynamic content to source space content, for example, the content by label macros, set a filter in the macro as the current space. When publishing the page, the macro displays content in the target space.
In-page links created in macros, such as the table of contents macro, are updated if the macro is configured for the current space.