Publish and syncing a page with in-page links
- Robert Alexander Marshall
- Comala Publishing
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
in-page links in the published target space page point 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.
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 in-page link maintains the source page Display text link configuration. 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 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 | 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: https://appfire.atlassian.net/wiki/spaces/CPCD/pages/614696400/User+Guide | The published inline link URL in the target space CPCL 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 | Target space published in-page link |
|---|---|---|
Page in the source space |  |  |
The card link URL in source space with space key PMCD is: https://appfire.atlassian.net/wiki/spaces/PMCD/pages/614696456/Product+Lifecycle | The published card link URL in the target space PMCL 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 | 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: https://appfire.atlassian.net/wiki/spaces/PMCD/pages/614696456/Product+Lifecycle | The card link URL in the target space PMCL 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
In-page links to headings and anchors
In-page hyperlinks to headings or anchors in the current page or to another source space page are updated to the destination target space page when the page is published.
For the following link on a page to a heading on another page in the source space
In the source space page in the NTSD space:
https://companysite.atlassian.net/wiki/spaces/NTSD/pages/2719744005/Staff+handbook+-+Americas#USA-specific-appendicesIn the published target space page in the NTS space:
https://companysite.atlassian.net/wiki/spaces/NTSD/pages/2719744005/Staff+handbook+-+Americas#USA-specific-appendicesHowever, if the destination page is not published, the links to the headings on these pages are not updated but are directed to the source space page. Subsequently, publishing the destination page automatically updates these links to this newly published page in the target space.
In-page links created in Confluence 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 third-party macros
Links within third-party macros to other pages in the source space depend on the app. When using these macros, you should check that these links are updated to the target space when publishing a page.
Confluence space links
When a page is published, links to Confluence space elements, such as the Confluence Calendar, are updated to the target space.
The source space page link in the NTSD space:
https://companysite.atlassian.net/wiki/spaces/NTSD/calendarsThe published target space page updated link in the NTS space:
https://companysite.atlassian.net/wiki/spaces/NTS/calendars
Need support? Create a request with our support team.