Heirloom for Confluence

Heirloom: Inherit Edit Restrictions

Confluence Cloud passes view restrictions down the page tree, but not edit restrictions. Heirloom does: set who can edit a parent page, and every page below it follows.

Get started

  1. Install Heirloom from the Atlassian Marketplace.
  2. Open the parent page whose editors you want to pass down. Set who can edit it in Confluence as usual (in the page's Share or Restrictions dialog).
  3. Choose ••• (More actions) > Apps > Inherit edit restrictions.
  4. Pick a mode (see below) and, if you want, tick the branches to leave unchanged.
  5. Click Preview to see what would change. Then click Turn on inheritance.

Keep the dialog open until it says Done. Large page trees are processed in steps while the dialog is open. If you close it early, nothing breaks: open it again and click Save and re-sync.

Modes

Add only (recommended)

Every page below gets at least the editors of the parent page. Editors that were added directly on a child page are kept. Heirloom never removes access in this mode.

Mirror

Every page below gets exactly the editors of the parent page. Editors that exist only on a child page are removed. Run a preview first.

What happens after you turn it on

Why the Heirloom app is listed as an editor

Confluence only lets an app change edit restrictions that include the app itself. So when Heirloom restricts a page, it also adds itself to the editors of that page. This is what allows new pages to be updated automatically. Removing Heirloom from a page's editors stops Heirloom from updating that page.

Pause or remove a rule

Open the dialog on the parent page and click Pause or Remove rule. Pausing or removing never changes existing restrictions: pages keep the editors they have.

For site admins

Go to Settings (Confluence administration) > Apps > Heirloom edit inheritance to see every rule on the site, with its mode, status, last sync and pages that need attention. Admins can pause or remove any rule there.

Who can use it

Anyone who can edit a page can set up inheritance on that page. Heirloom checks that the person can edit the page before a rule is turned on, changed, paused or removed. After that, new and moved pages are updated by the app itself.

Limits

Uninstalling

Restrictions that Heirloom set stay on the pages. The rules are deleted together with the app's data by Atlassian.

Questions? See Support.