Publish and syncing a page with in-page links
- Robert Alexander Marshall
- Comala Publishing for Confluence Cloud
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 a source page includes an in-page link to another page in the source space, on publishing and syncing the page
the in-page link in the published target space page points to the page in the target space
The in-page link is automatically updated each time the page is published to prevent broken links. Different Confluence link macro formats on the source space page can affect how Confluence displays the link on the published target space page.
The following in-page links are not updated when a page is published and synced:
an in-page link to a heading or an anchor on another page in the source space
a link to a heading on another page in the source space
Publishing in-page links
URL | Source space in-page link | Target space published 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 replaces the URL displayed in the source space 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. |
The URL in the source space to another page in the source space CPCD is: https://appfire.atlassian.net/wiki/spaces/CPCD/pages/614696400/User+Guide | The link URL in the published and synced target space CPCL is updated to point to a page in the target space: https://appfire.atlassian.net/wiki/spaces/CPCL/pages/646807689/User+Guide
Both the published page and the published link URL use the same page name as the source space page and link. | |
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 and synced target space in-page link URL is updated with the space key for the target space and the target space page contentID.
|
The URL in source space with space key CPCD configured to Display text is: https://appfire.atlassian.net/wiki/spaces/CPCD/pages/614696400/User+Guide | The published URL in the target space CPCL for the displayed link is
The published link URL uses the same page name as the source space page. | |
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 | Target space published 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: | The published inline link URL in the target space CPCL is:
| |
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 | Target space published in-page link |
|---|---|---|
Page in the source space | ||
The card link URL in source space with space key PMCD is: | The published card link URL in the target space PMCL is:
| |
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 | Target space published in-page link |
|---|---|---|
Short link to another space or location | ||
The card link URL in source space with space key PMCD is: | The card link URL in the target space PMCL is:
| |
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 headings and anchors
Links to and from page headings and anchors are treated differently from page links added to the Confluence link macro types. When these link to another page in the source space, the link is not updated to the target space when the page is published.
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 destination target space pages when a page is published.
Example
In a source space page, Product Lifecycle, a link to a page heading, User interface in the source space page Product MVP is added as an in-page link.
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.