Skip to main content

Common Issues and Limitations

These are common issues in HTML Macro for Confluence. Whenever possible, issues also have documented workaround to resolve them.

HTML from Page Attachment: 404 Not Found

When you use HTML from Page Attachment macro to render an HTML file, you might sometimes encounter 404 Attachment Not Found error.

HTML-Attachement-Not-Found.png

Page attachment not found

There are multiple causes behind this issue. The most likely cause is page permission. You can inspect the page permission with following steps:

  1. Go to page and click on Restrictions icon 🔓

HTML-Page-Permissions.png
  1. Click on Inspect permissions

Inspect-Permissions.png
  1. Select 'HTML & Iframe Macro for Confluence'. The result should look like below.

Inspect-Permissions-Detail.png

If there is page permission Denied (error) shown here, the app cannot access the page attachments as expected.

In order to resolve this issue, you can add app user to space from Space Settings → Space permissions → Users

Space-Permissions.png

Add HTML Macro to a space

The app needs only view permission to function, write permissions like add and delete are not needed.

This workaround is only needed if you have a customized permission system. By default, HTML Macro has read permissions and works out of the box.

If this still does not resolve, please contact us with a screenshot of Inspect permissions page (step 3).

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.