Content Byline Item

Content Byline Item modules allow your Connect add-on to add dynamic content to the Confluence Content Byline - the part of the content under the title that includes metadata about the latest version of the content.

 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
{
  "modules": {
    "contentBylineItems": [
      {
        "url": "/my-byline-item",
        "context": "addon",
        "target": {
          "type": "inlinedialog"
        },
        "tooltip": {
          "value": "Item Tooltip"
        },
        "icon": {
          "width": 16,
          "height": 16,
          "url": "/my-icon.png"
        },
        "name": {
          "value": "Item Text"
        },
        "key": "byline-item"
      }
    ]
  }
}

Properties

key

Type
string
Max length
100
Required
Yes
Pattern
^[a-zA-Z0-9-]+$

name

Type
object
Required
Yes

cacheable

Type
boolean
Defaults to
false

conditions

Type
[compositeConditionBean,singleConditionBean, ... ]

contentPropertyKey

Type
string
Max length
100
Pattern
^[a-zA-Z0-9-]+$
Description

An optional Content Property key that this Byline Item will be bound to.

The key must only contain alphanumeric characters and dashes.

When a key is supplied, the:

for this Byline item will be overwritten with the property's corresponding value (if present), and the rendered item will be updated as the value changes in the browser.

This requires the stored Content Property to have the following format:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
{
  "name": {
    "value": "Item Text"
  },
  "icon": {
    "width": 16,
    "height": 16,
    "url": "/my-icon.png"
  },
  "tooltip": {
    "value": "Item Tooltip"
  }
}

Note that only fields present in the original bean will be respected when substituting values from a Content Property later. This means that to show a Content-Property-based tooltip, this Content Byline Item module must specify a tooltip. Likewise for a Content-Property-based icon, this module must specify an icon.

context

Type
string
Defaults to
addon
Allowed values
  • page
  • PAGE
  • addon
  • ADDON
  • product
  • PRODUCT

    • icon

    Type
    object

    params

    Type
    object

    target

    Type
    object

    tooltip

    Type
    object

    url

    Type
    string
    Format
    uri-template