Include Page Macro

Add the Include Page macro to a page to display the contents of another page or blog post in this page. 

This macro is great for:

  • single-sourcing instructions and procedures
  • sharing useful information in multiple spaces
  • all types of content reuse.

You can add multiple Include Page macros to your page, and combine them with text, images, tables and other macros.

Because you're simply including the content of the other page, rather than duplicating it, any changes to the original automatically flow through to wherever the page is used.  

The Include Page macro respects space permissions and page restrictions, so be sure to check who can view the page you're including.

On this page:

Screenshot: Meeting notes page with a reusable warning at the top. 

To learn how to create a reusable content library, check out Develop Technical Documentation in Confluence.

Add this macro to your page

To add the Include Page macro to a page:

  1. Unable to render {include} The included page could not be found.
  2. Choose Include Page from the Confluence content categories.
  3. Enter the title of the page you want to include. It can be in this space, or another space.
  4. Choose Insert

You can then publish your page to see the macro in action.  

Screenshot: The Include Page macro nested within a Note macro in the editor.  


Change the macro parameters

Error rendering macro 'excerpt-include'

User 'null' does not have permission to view the page.

Here's a list of the parameters available in this macro. 

Parameter

Default

Description

Page to Include

None

This is the name of the Confluence page or blog post that you want to include in the current page. Start typing a page title, and Confluence will suggest matching pages from the current space and other spaces.

Alternatively you can specify the page as follows:

  • If the page or blog post is located in another space, add the space key and a colon in front of the page name. For example, DOC:My page name. The space key is case sensitive.
  • To include a blog post, specify the date as well as the title of the blog post. For example: /2010/12/01/My blog post.
  • You can include pages from personal spaces using ~username as the space key, where 'username' is the person's username. For example, ~jsmith:My page name.

Error rendering macro 'excerpt-include'

User 'null' does not have permission to view the page.

Limitations

This macro has a few limitations you need to be aware of:

  • The macro respects space permissions and page restrictions. It won't display the contents of the included page to anyone who doesn't have adequate permissions to see the included page. 
  • The macro will include the entire page content. If you only want to display part of a page, use the Excerpt Include Macro instead. 
  • The macro can only display pages that exist in your current site. You can't use the Include Page macro to display the contents of pages in other Confluence sites.   

Other ways to add this macro

Add this macro as you type

Unable to render {include} The included page could not be found.

Add this macro using wiki markup

Unable to render {include} The included page could not be found.

Macro name: include

Macro body: None.

{include:DOC:My chocolate page}
Last modified on May 20, 2020

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.