Error shown when using the page include macro in Confluence: "Unable to render {include} The included page could not be found."
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
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.
Last modified on Jan 21, 2025
Powered by Confluence and Scroll Viewport.