Error shown when using the page include macro in Confluence: "Unable to render {include} The included page could not be found."
Platform Notice: Data Center Only - This article only applies to Atlassian apps on the Data Center platform.
Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Summary
Problem
When a page contains the Include Page Macro
When the Include Page Macro includes a page from another space
Diagnosis
Try to login with an Administrator account (member of confluence-administrators group), make sure that you have the permission to view both the page that has the Include Page Macro, as well as the page that is being included.
Make sure the Page to Include parameter is correct, with this convention: spaceKey:PageName
If you checked both of these, and still the problem persists, proceed to the resolution.
Cause
This error is typically caused by permissions.
Versions prior to Confluence 6.14 may be caused by this bug: CONFSERVER-36851 'Unable to render include The included page could not be found.' message displayed for include-page macros after upgrading Confluence
If the error message is no longer displayed when you are logged in with the Administrator account, it is likely that the error is shown as a result of permissions. That is, the user seeing the error does not have permission to see the included page content. From that user's POV, the content does not exist, so the message is correct.
Currently there is no way to suppress the error message. There is a feature request for this ability: CONFSERVER-5436 Add capability to turn off include error message and make note of this in Conf user guide/admin guide docs
Solution
Resolution
Update page permissions to ensure the user has permissions to the page that is included.
If affected by CONFSERVER-36851 'Unable to render include The included page could not be found.' message displayed for include-page macros after upgrading Confluence, follow the workaround from the bug, or upgrade Confluence.
Was this helpful?