Connected fields configuration
Elements Connect lets you bring external data inside Jira through two different types of fields: connected custom fields and connected items.
In this page, you will learn how they differ and how your specific business needs will let you know when ones should be used over the others.
Connected fields types
Connected custom fields
Connected custom fields are fully integrated Jira custom fields which can be connected to external data sources. From a technical standpoint, these are Forge custom fields made possible by our free companion app.
Learn more: Connected custom fields settings
Connected items
Connected items are the only way to bring external data directly on the customer portal in Jira Service Management, to satisfy all your ITSM needs. It should be noted that from a technical standpoint, connected items are not exactly Jira custom fields, which can lead to some limitations.
Learn more: Connected items settings
Differences in capabilities
Here is a comparison table for Connected Custom Fields and Connected Items that will help you decide when to use one of the other:
Feature/Capability | Connected Custom Fields | Connected Items |
|---|---|---|
Visibility in Jira Service Management |
|
|
Usage in Jira projects |
|
|
Integration with workflow validators |
|
|
Integration with advanced reports created with native JQL |
|
|
Integration with Automation and 3rd-party apps |
|
|
Data import from Jira Data Center |
|
|
Advanced customization of display |
|
|
Not available 
Available on request creation forms in the customer portal 
Usable in view screens of any project type, but not on issue creation screens How do connected fields work?
The diagram below summarizes how Elements Connect works through an example. Here we retrieve data from an external database, but the same concept is used for REST APIs.
Let's say we have access to a database where our printers are stored in a "Printers" table.
The first step is to execute a Query to get the printer list from the database.
This query execution returns a “result set”: the printer list.The second step is to apply a Template on each row of this “result set”.
Each row is thus converted into a text which is used as an option in the connected field.
Known limitations
For now, it is only possible to create up to 250 connected fields in total (custom fields + connected items). If you need to create more, please contact us and tell us why.