Adding widgets

Customizing the object view layout

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

Widgets are flexible components that you can insert in different places, such as object type layout page or dashboard. They can help you and your team quickly access information about your objects.

Attributes widget

Displays the selected attributes of your object in a customized order. It's useful to show specific information to your team without displaying all attributes at once, overwhelming them with data.

  • Add: Select attributes from the drop-down list and add them to your widget.
  • Delete: Hover over an attribute, and delete it.
  • Reorder: Drag and drop attributes to change their order in the widget.

Settings

Settings for the Attribute widget:

SettingDescription
Display content in a collapsible panel
  • If ON, displays the attributes in a collapsible panel.
  • If OFF, displays the attributes inline with other page text. Automatically turns "load content only when visible" OFF, since the attributes always displayed.

This setting available in the side panel of the object page layout screen ONLY.

Load content only when visible (Lazy loading)
  • If ON, loads the data in the widget only when the widget is displayed. Default setting.
  • If OFF, loads the data in the widget with the page.

Connected tickets widget

Displays all Jira issues that are connected to an object.

Settings

Settings for the Connected tickets widget:

SettingDescription
Number of items per pageSet the number of connected tickets displayed on each page.
Load content only when visible (Lazy loading)
  • If ON, loads the data in the widget only when the widget is displayed. Default setting.
  • If OFF, loads the data in the widget with the page.

Comments widget

You can use this widget to view, edit, and add comments to an object.

Settings

Settings for the Comments widget:

SettingDescription
Number of items per pageSet the number of comments displayed on each page.
Display the editor
  • If ON, display the editor for comments at the top of the widget.
  • If OFF, does not display the widget editor.
Load content only when visible (Lazy loading)
  • If ON, loads the data in the widget only when the widget is displayed. Default setting.
  • If OFF, loads the data in the widget with the page.

Attachments widget

You can use this widget to view, add, and delete attachments from an object.

Settings

Settings for the Attachments widget:

SettingDescription
Number of items per pageSet the number of attachments displayed on each page.
Display the dropbox
  • If ON, display the dropbox for adding attachments at the top of the widget.
  • If OFF, does not display the dropbox.
Load content only when visible (Lazy loading)
  • If ON, loads the data in the widget only when the widget is displayed. Default setting.
  • If OFF, loads the data in the widget with the page.

Inbound references widget

You can use this widget to view inbound references to an object.

Settings

Settings for the Inbound references widget:

SettingDescription
Display content in a collapsible panel
  • If ON, displays the inbound references in a collapsible panel.
  • If OFF, displays the inbound references inline with other page text. Automatically turns "load content only when visible" OFF, since the inbound references are always displayed.

This setting is available in the side panel of the object page layout screen ONLY.

Load content only when visible (Lazy loading)
  • If ON, loads the data in the widget only when the widget is displayed. Default setting.
  • If OFF, loads the data in the widget with the page.

History widget

You can use this widget to view the history of changes to an object, or the history of changes to all connected Jira issues.

Settings

Settings for the History widget:

SettingDescription
History of
  • If OBJECT is selected, displays the entire history of the object.
  • If CONNECTED TICKETS is selected, displays the history and changes to Jira tickets connected to the object.
Number of items per pageSet the number of history items displayed on each page.
Load content only when visible (Lazy loading)
  • If ON, loads the data in the widget only when the widget is displayed. Default setting.
  • If OFF, loads the data in the widget with the page.

IQL query widget

You can use this widget to display objects, and their attributes, returned by an IQL query.

Settings

Settings for the IQL query widget:

SettingDescription
Number of items per pageSet the number of objects returned by the IQL query.
Load content only when visible (Lazy loading)
  • If ON, loads the data in the widget only when the widget is displayed. Default setting.
  • If OFF, loads the data in the widget with the page.
DescriptionEnter a description of this query and the information returned.
IQL queryEnter an IQL query to run in the widget. For more information about IQL, see IQL - Insight Query Language.

Placeholders

Placeholders are very handy when used in the IQL query widget, because they can return information that is filtered by the current object. For example, the IQL query on the screenshot below returns all objects that meet the following criteria:

  • Have outbound references to the current object
  • Are Network interfaces

This is a great way of finding more detailed information about objects within an object type.

  • For more info about Insight Query Language (IQL), see Advanced search: IQL.
  • For more info about placeholders, see Using placeholders.


Last modified on Jan 30, 2021

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.