Getting started with Assets in Jira
Before you start in Jira
Assets works the same way in Jira as it does in Jira Service Management - the setup steps are identical once you open the app. You need a paid Jira plan, and to create a schema you need Assets admin access. If you only need to view or use existing objects, you do not need admin access.
Open Assets
Open the sidebar and select Assets. On a paid Jira plan it appears as an app you can open directly. You land on the For You page, which is your starting point for working with schemas and objects.
Create a first schema and object
From the navigation menu, select Schemas, then Create schema (you need admin access for this). Give the schema a name, then create the object types you need before you add or import objects. Once your object types exist, you can add objects one at a time or import them in bulk.
The full walkthrough - creating a schema, object types, attributes, and your first objects - is the same for everyone, so we keep it in one place. Follow Get started with Assets for the step-by-step detail.
Link an object to a work item
To connect an object to a Jira work item, you use the Assets objects custom field. An admin creates and configures that field, then anyone editing a work item can attach objects to it. See Create an Assets object custom field.
Next steps
Once your first objects exist, you can link them to work items, search them with AQL, and manage who can see and edit them. See Get started with Assets for the shared setup detail.
Feature availability
Compare the availability of core Assets and data management capabilities across Jira Service Management and Jira Cloud plans.
Capability | Available to Jira Service Management / Service Collection customers | Available to Jira / Teamwork Collection customers | Support documentation |
|---|---|---|---|
Core Assets data model Creates and organises schemas, object types, objects, attributes, references, and statuses. | X | X | Recommended data structure for an Assets schema | Assets | Atlassian Support |
Object attributes, statuses, and icons Defines object properties, validation, status values, and visual identification. | X | X | Manage attributes in Assets | Assets | Atlassian Support |
Object references and schema relationships Connects related objects and enables cross-schema relationships. | X | X | |
Object lifecycle management Creates, edits, clones, bulk-edits, deletes, comments on, views history for, searches, and exports objects. | X | X | |
Assets search and AQL Finds objects and object types using structured Assets Query Language criteria. | X | X | How to use Assets Query Language (AQL) | Assets | Atlassian Support |
JQL with Assets AQL Uses Jira Query Language with Assets AQL to find work items through related Assets data. | X | X | Use Jira Query Language (JQL) with Assets' AQL | Assets | Atlassian Support |
Assets object custom field and Jira-work linkage Links Assets objects to Jira work items and configures field scope using AQL. | X | X | View Assets objects directly on work items and in Confluence | Assets | Atlassian Support |
Display Assets data in Confluence Views Assets object data on Confluence pages and live docs. | X | X | Display your Assets data on a Confluence page or live doc | Assets | Atlassian Support |
Roles and access control Manages schema and object-type roles, user/group/app access, and object-field permissions. | X | X | |
Import, export, and bulk edit Imports and maps data, edits objects in bulk, and exports Assets data. | X | X | |
Data Manager Connects, cleanses, normalises, reconciles, and imports asset data from multiple sources before it is loaded into Assets schemas. | X | Â | Set up your instance of Data Manager | Assets | Atlassian Support |
Assets automation Automates Assets object changes, including the Attribute Value Changed trigger. | X | X | Automate your objects in Assets | Assets | Atlassian Support 📣 Introducing Attribute Value Changed automation trigger for Assets |
Assets Dashboards Visualises Assets data and trends for service, object, and data-quality insight. | X | Â | |
Assets Discovery Scans network-connected infrastructure and imports discovered data into Assets. | X | Â |
Was this helpful?