Group by Formula Generator

The Group by Formula generator allows you to group issues based on the results of a structure formula.

Placement matters. Generators only affect issues beneath them, so if you want to group the entire structure, place the generator at the very top. If you place it anywhere else, it will only group the items beneath it.

Adding a Group by Formula generator

To add a Group by Formula generator, open the Add menu and select Group.

This will display the Group generator options. Select Formula.

Configuring the Generator

Each Group by Formula generator can be customized to create exactly the hierarchy you need.

Formula

Enter the formula for grouping. To learn more about working with Structure formulas, see Formulas.

Variables

Structure will suggest variables and attempt to map your variables to well-known Jira fields or Structure values. If Structure is unable to map a variable, it will be marked with a red warning icon, and you will need to map the variable manually.

Learn more: Variables, Mapping Variables

Consider other Groups

By default, Group generators ignore data added to your structure by other Group generators because, in most cases, the added data doesn't group well.

Imagine you add both Group by Sprint and Group by Formula to a structure (see Grouping Order below). Here's a breakdown of how that would work:

1. Structure starts with your top level issues (or adds them with an Insert generator).

2. Next, it applies the first Group generator in our list, the Group by Sprint. This creates a new level in your hierarchy.

3. Then Structure applies the Group by Formulas generator. At this point, the true "current" level is a list of sprints, which are not issues and likely won’t be affected by the formula. So Structure ignores these items, and creates the new group of issue links based on the original issues. On the other hand, if you want to apply a grouping to your sprints, select Consider other groups to make this possible!

Group on level

Allows you to specify which level within the hierarchy the grouping should be applied to:

• Levels are based on the placement of the generator, where "Level 1" is the level the generator is located on, "Level 2" is the level beneath that, and so on.

"No Value" Groups

When items in the structure do not have values for the group, they are placed in a special flex item at the bottom of the grouping level, such as "No epics" (when grouping by epics) or "Unassigned" (when grouping by assignee). 

This can be very useful when trying to identify items that don't have a value for a particular field or formula.