Page tree

This documentation relates to an older version 2.10 of the Structure Plugin for JIRA. View the current documentation home.

Skip to end of metadata
Go to start of metadata
Structure 101

Installing Structure

  1. Install the Plugin - open Plugin Manager, search for Structure and click Install or Try Now.
  2. Get Evaluation License
    1. Check if you need a license by going to Administration | Structure | License Details.
    2. If needed, click Get Evaluation License and install the received license.
    3. See Setting Up Structure License for details.
  3. Configure Enabled Projects
    1. Open Administration | Structure | Configuration and enable at least one project.
    2. See Selecting Structure-Enabled Projects for details.

Structure Crash Course

  • Please watch the introductory video on the right.
  • During initial installation, Structure plugin has created an empty, default Global Structure. You can decide to use only that single structure, or you can create as many structures as needed. To create a new structure, use Structure | Create Structure menu.
  • A structure is a "container" for issues — it is initially empty, and someone needs to put issues into it and arrange them in a hierarchy. This can be done manually, issue by issue, or automatically with an Import function or a synchronizer.
    • To add an issue to a structure, open that issue, expand Structure section, and click Add to Structure button. Alternatively, use Search button on the Structure Board to find the issues you need to add, and place them at a specific position in Structure with drag-and-drop. (Click left-side dots to select multiple issues.)
    • To create a sub-issue, select the issue in a structure and click +Sub-Issue button.
    • To make structure always contain issues that satisfy a certain JQL filter, install a Filter Synchronizer — open Structure | Manage Structures page, locate your structure, click Settings in the Sync With column, and install a Filter synchronizer.
  • Structure is integrated with JIRA Agile (GreenHopper) — the issue details panel on the Agile board shows the position of that issue in structure. You can install JIRA Agile (GreenHopper) Synchronizer to maintain a structure with Theme-Epic-Story-Task hierarchy, or to synchronize backlog/sprint rank with the position of issues in a structure.

Getting Started - Walkthrough

  1. Open Structure | Manage Structure menu and click Create Structure. Create your own private structure to play with.
  2. On the Manage Structure page, click on your structure name to go to the Structure Board.
  3. On the Structure Board, click Search, then click JQL and type assignee=currentUser() order by updated. You can use any other query - see more about Searching and Filtering.
  4. When some issues are found by the search, click "More Issues in JIRA" button if it's not switched on, and then drag-and-drop several found issues into the Structure.
  5. When you have several issues added to the structure, try to rearrange them to create a hierarchy. Hold Shift and drag issues up and down or left and right to place them at a different position in the hierarchy. You can also drag by the drag handle at the left side. See Using Drag and Drop to learn more.
  6. Use keyboard arrows to navigate structure or Ctrl+Arrow to move issues up/down or indent/unindent.
  7. Use Structure Toolbar for other actions like Copy/Paste.
  8. Click on an issue's summary or hit "o" to open issue page - there's structure on that page too.
  9. Hit Ctrl+? to see a cheat sheet with Keyboard Shortcuts.
Structure Introduction and Overview:

Version 2.0 Highlights: