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.

To add new widgets, or edit the settings for existing ones, go to your object schema, go to Object type > Configure > Configure page layout.

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.

AQL query widget

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

Settings

Settings for the AQL query widget:

SettingDescription
Number of items per pageSet the number of objects returned by the AQL 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.
AQL queryEnter an AQL query to run in the widget. For more information about AQL, see Advanced search: AQL.

Placeholders

Placeholders are very handy when used in the AQL query widget, because they can return information that is filtered by the current object. For example, the AQL 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.

Last modified on Jul 26, 2023

Was this helpful?

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