Developer
News and Updates
Get Support
Sign in
Get Support
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
Sign in
DOCUMENTATION
Cloud
Data Center
Resources
Sign in
Last updated Sep 1, 2026

ADF node: decisionList

Node

Description

The decisionList node is a container for decisionItem nodes. Decision lists provide lists that look much like a bulletList, but they cannot be nested and there are differences in their visual representation. The decision items also require identifier strings that can be used to associate them with information in other systems.

Example

Java

1
2
3
4
5
6
7
8
9
10
11
12
doc(
        p("Hello"),
        decisionList(
            "decision-list-id",
            decisionItem()
                    .localId("item-test-id")
                    .decided()
                    .content("Start using Document Format for apps")
        )
        p("World")
);

ADF

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
{
  "type": "doc",
  "version": 1,
  "content": [
    {
      "type": "paragraph",
      "content": [
        {
          "type": "text",
          "text": "Hello"
        }
      ]
    },
    {
      "type": "decisionList",
      "attrs": {
        "localId": "decision-list-id"
      },
      "content": [
        {
          "type": "decisionItem",
          "attrs": {
            "localId": "item-test-id",
            "state": "DECIDED"
          },
          "content": [
            {
              "type": "text",
              "text": "Start using Document Format for apps"
            }
          ]
        }
      ]
    },
    {
      "type": "paragraph",
      "content": [
        {
          "type": "text",
          "text": "World"
        }
      ]
    }
  ]
}

Result

Hello

Start using Document Format for apps

World

Note: This example output is not using AtlasKit to render the decision list, so while it gives a vague impression of what a “decision list” is, it does not faithfully reproduce the actual presentation in Atlassian products.

Compatibility

Products

ConfluenceJira

Usage

Marks

❌ N/A

Structure

  • type - decisionList
  • content - array(decisionItem…) – at least 1
  • attrs
    • localId - string - UUID1

  1. Documented, but not enforced by the schema↩︎

Rate this page: