How to include a page in another page in Confluence
Embed a whole Confluence page in another using the Include content macro and selecting the source in Content to Include.
The destination shows the source content rather than creating an independent editable copy. Use this for a shared operating procedure; use an excerpt when only one section belongs on the destination.
Step-by-step guide
Choose a self-contained source
Identify the procedure page and check its permissions. Everyone reading the destination also needs View access to the source. For example, an internal escalation procedure will not become visible to a guest merely because it is embedded in their project page.
Insert Include content
Edit the destination, type / and find Include content. Set Content to Include by searching for the procedure title. For another space, a reference such as OPS:Escalation procedure identifies the source; space keys are case sensitive.
Publish a useful surrounding explanation
Explain why the procedure is present and who maintains it rather than adding another copy of its instructions outside the macro. Publish the destination and compare it with the source to check that the complete procedure is the one intended.
Test access and future changes
Ask a representative reader to open the destination and inspect the embedded procedure. If it is unavailable, check source and destination View permissions separately. Maintain the procedure on its original page so other destinations continue to use the same wording.
Common mistakes
Assuming embedding grants source access
Include content preserves the source’s permission requirement. Fix access intentionally rather than making the source public to hide an error.
Sources and verification
Based on product documentation checked on 2026-11-04. This is a documentation-based guide, not a hands-on benchmark. Features and availability can change.