Assets integration
Integrating Jira Assets with the customer self service portal means less back-and-forth and more accurate data for everyone. It is a simple way to make the Jira portal more capable by letting users manage the equipment linked to their requests directly.
System requirements & App editions
The Assets feature is available within Jira Service Management Premium and Enterprise plans. To use this specific integration, the Advanced edition of Feature Bundle is required. Additionaly, only company-managed projects are compatible.
Learn more about Feature Bundle Advanced here.
Jira admin permissions required
For the integration to work correctly, Jira Administrators must grant the necessary Global permissions This allows the app to fetch and update asset data securely across the site.
How do Jira Assets work on Portal?
Reporters can edit Jira Assets object custom fields directly through the portal interface. The app respects most settings configured within these custom fields, ensuring a consistent experience. Currently, this functionality specifically supports the Asset custom field type.
The integration uses Asset Query Language (AQL) to define which objects are visible. There are two distinct scopes available for configuration:
- Filter scope
- Filter issue scope
To ensure the filters function correctly, the AQL values from the Asset custom field must be copied into the Customer actions form, within the selected Asset field.


Filtering examples
Below, we provide couple of examples of the AQL filters in use:
Manufacturer selection: A Manufacturer custom field can be set to provide only objects categorized under Manufacturer.
Dependent objects: A Printers field can then provide objects sorted by the group selected in the previous step. As a result, the user only sees Models that are assigned to that specific manufacturer.


Native Jira restrictions
If native Jira restrictions are in place, then Asset fields must be added to the Jira edit screen within the project settings.
If these fields are missing from the edit screen, the API cannot return the data.