Home container

The Jira home container in Jira Cloud implements the Home container pattern for Atlassian product navigation. It is a way for users to locate all of their work in Jira Cloud.

While adding links to the Jira home container is currently supported, we strongly encourage you to design for project-centric or user-centric experiences. This means the primary methods of navigation to your app's content should be via the project sidebar or user profile menu. Only add a link to the home container as a last resort.

The home container location is available for general pages and web items.

To have nested navigation in the home container:

Create a top-level web item in the system.top.navigation.bar location.
Create a web section with location that is the key of the top-level web item.
Create nested web-items, whose location is <key-of-top-level-web-item>/<key-of-section>.

Sample descriptor JSON

The example shows one general page and one web item with nested navigation.

1
2
{
  "modules": {
    "generalPages": [
      {
        "key": "activity",
        "url": "/my-general-page",
        "name": {
          "value": "Example general page"
        }
      }
    ],
    "webSections": [
      {
        "key": "nested-section",
        "location": "top-level-web-item",
        "name": {
          "value": "Example section"
        }
      }
    ],
    "webItems": [
      {
        "key": "top-level-web-item",
        "location": "system.top.navigation.bar",
        "name": {
          "value": "Example web item"
        },
        "url": "https://www.example.com"
      },
      {
        "key": "nested-item",
        "location": "top-level-web-item/nested-section",
        "name": {
          "value": "Nested item"
        },
        "url": "https://www.example.com"
      }
    ]
  }
}