Skip to main content
Skip table of contents

Synchronization

Dark Feature - Synchronizers are hidden by default

If there are no synchronizers installed on your system, this feature will now be hidden from users. To enable synchronizers, set structure.feature.synchronizers.enabled system property to true. See Advanced Configuration and Dark Features for more information.

If you currently have synchronizers installed, the feature will remain visible.

Synchronization lets you keep a structure issue hierarchy in sync with some other issue properties. For example, you can enforce the rule that Jira sub-tasks should always be placed under their parent in the structure, or that there should be an issue link from parent issue to each sub-issue.

Synchronization can also be run once to perform a one-time update of the structure (Import) or one-time update of the issues based on the structure (Export).

Synchronization is an extendable system that allows Jira add-ons to provide their own synchronizers. The following synchronizers are supplied with Structure:

  • Sub-Tasks Synchronizer places Jira sub-tasks under their parent issues in the structure.
  • Links Synchronizer makes sure sub-issues are linked to their parent issues with a specific link type. It can also be used to reconstruct structure from links.
  • Filter Synchronizer populates structure with issues that pass a saved filter. It can also be used to remove issues from a structure when they no longer pass the filter.
  • Agile Synchronizer works to sync the Agile ranking of issues with their position in the structure and to make it easier to assign stories to epics using Structure.
  • Status Rollup Synchronizer propagates issue status upwards. For example, it can make parent issue Resolved if all sub-issue are resolved.

One-time synchronization works when you run Export or Import, or when you run a Resync. Automatic synchronization runs in the background and listens for updates in the structure and beyond.

Please be careful: synchronization may cause massive changes to issues. For example, if you install the Agile synchronizer and then add issues to the structure in some random order, those issues' ranks will be changed according to that order almost immediately! We highly recommend that you maintain daily backups and carefully review how a synchronizer works before installing it.

In order to install a synchronizer, you need to have Control permissions for a structure and have necessary permissions for the Jira issues.

Note that you also need to have special permission to Control Synchronizers. If there is a warning message above the feature description, please contact your Jira Administrator for assistance.

Anonymous users cannot install synchronizers or use Export/Import, even if they are granted Control permissions.

JavaScript errors detected

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

If this problem persists, please contact our support.