Permissions

Permissions control who can open and use the HTML editor. This is separate from Confluence's own page permissions — it is specific to the HTML macro editor.

Permissions

How It Works

Editor Access Disabled (Default)

When Restrict editor access is toggled OFF:

  • ✅ Everyone with Confluence page edit permission can open and use the HTML editor
  • ✅ No additional configuration needed

Use this when:

  • Small, trusted teams
  • Internal wikis where all editors are trusted
  • Development or staging environments

Editor Access Enabled

When Restrict editor access is toggled ON:

  • ✅ Users on the allowed list can open and edit HTML macros
  • ✅ Confluence administrators always have access
  • ❌ All other users — even those with page edit permission — cannot open the editor

Users who do not have access will see an Access Denied message if they attempt to open the editor. They can still view the rendered macro output on the page.

Use this when:

  • Only certain team members should be able to write raw HTML/JS
  • You need to control the quality or security of embedded code
  • Enterprise environments with compliance requirements

Configuring the Allowed Users List

Adding Users

  1. Go to the Permissions tab in the settings panel
  2. Toggle Restrict editor access to ON
  3. Use the user search field to find users by name or email
  4. Select a user to add them to the list
  5. Click Save Changes

Removing Users

Click the × next to a user's name in the allowed list to remove them.

Tip: Confluence site administrators always retain full access to the editor, regardless of whether they are in the allowed list. This prevents admins from accidentally locking themselves out.

Viewing Permissions

Important: Restricting editor access does not affect who can view the rendered HTML macro on a Confluence page. All page visitors with view access will see the rendered output. Access control only restricts who can open the editor and modify the content.

Summary

User type Can view rendered output Can open editor
Page viewer ✅ Always ❌ No editor access
Page editor (access off) ✅ Always ✅ Yes
Page editor (access on, not listed) ✅ Always ❌ Blocked
Page editor (access on, listed) ✅ Always ✅ Yes
Confluence admin ✅ Always ✅ Always