The Include macro cannot render the included page

Summary

When accessing pages, all of its content or some parts display the following message:

Diagnosis

• When accessing the page where this is happening, tap the ellipsis button at the top-right > Advanced details > View storage format. There, check to see if a macro called "Include" is displayed where the error is happening. For example:

  ac:structured-macro ac:name="include"

• If you are a user who is not facing the issue, use the same storage-format instructions to find ri:page and the included page name in ri:content-title. Access that included page, then check whether the user reproducing the issue has access to it.

  ri:page ri:content-title="<name of the page>"

Cause

There is a restricted page being retrieved via the Include page macro. In this case, the macro states that "the included page could not be found" because the restrictions are avoiding it to be fetched. This can be tied to restrictions applied to the page or a parent page, causing it to be inherited by the child one(s).

Solution

Apply the access change to the included page identified in Diagnosis, or to its parent page when the restriction is inherited by the included page.

1. Type a user's name or a group into the search bar. (You can add multiple people and groups to the search bar.)

2. Select Can edit or Can view.

3. Select Add to add them to the list with the selected view or edit permission.

4. Select Apply to save the changes.

After selecting Apply, have the affected user access the page that contains the Include macro and confirm that the included page can render.