Generators

Generators are powerful tools that let you create dynamic structures. These structures update themselves automatically when Jira changes.

You can use generators to build entire structures or add generators to a manually created structure – for example, add a generator to automatically place issues that match a query under a Flex item.

How Generators Work

Generators are special rules that tell Structure what issues to include from Jira and where to place them within the structure.

When you first build the structure, they add, organize, and filter issues based on your rules.
Each time a structure is opened, they run again and rebuild the structure, based on the current information available in Jira.
While you view the structure, they run in the background, checking for changes in Jira so your data stays up to date.

If multiple people are using a structure simultaneously, it is only generated when the first person opens the structure; however, it will continue to update in real time.

Adding a Generator

To add a generator to your structure, open the Add menu and select the type of generator you want to add.

The following types of generators are available:

Preset - Automatically add and configure generators to accomplish a specific use case.
Insert - Automatically add issues to the structure based on Jira fields, Jira boards, or a JQL query.
Extend - Add additional issues based on the Parent field or issue links.
Filter - Remove issues based on a JQL query.
Group - Group issues by fields or issue links.
Sort - Order the structure based on Jira fields.

Generator Scope

Generators are placed in the structure, just like other items, and their scope is defined by their position within the structure:

Place the generator at the top of the structure, and it will impact the entire structure.
Place it under a Flex item, and it will only affect items within that Flex item.

Generators can only be added under static items (Flex items, manually added issues).

Generators cannot be added under dynamic items (items added by another generator).