How to Auto-Fill Issue Pickers Based on Existing Links
Auto-fill your VIP.LEAN Issue Pickers from existing Jira links. Ideal after a migration from Advanced Links or another app: review the candidates, then fill up to 1,000 work items per run.
1. Why Auto-Fill?
Required Jira Role: Jira Administrator
Auto-fill puts linked work items into an empty Issue Picker field. It is useful when:
- you migrate from VIP.LEAN Advanced Links and want the new Issue Pickers to show the same state as before,
- you migrate from another app to VIP.LEAN Issue Picker, or
- you install the app in an existing Jira where work items are already linked.
2. Preconditions
Required Jira Role: Jira Administrator
- The Issue Picker exists and is configured, including its contexts.
- The Issue Picker has a link type. Without one, the Upload button is disabled, because auto-fill takes the linked work items.
- The field is on the edit screens of the spaces and work types you want to fill.
- The work items already have links of that link type, in the configured direction, to work items the picker offers.
3. Choose the Scope
Required Jira Role: Jira Administrator
In the list of Issue Pickers, click the Upload icon of the picker. The Auto-fill dialog opens with the step Scope:
- Projects: the spaces with an edit screen that contains the field. All are selected; clear the ones you want to leave out.
- Additional JQL: optional, narrows the candidates down further.
- Candidate query: shows the search the app runs, e.g.
(project = MS OR project = CHANGE) AND cf[10096] is EMPTY AND issueLinkType is NOT EMPTY. Only work items with an empty field are candidates.
If the field is on no edit screen, the dialog shows âThe Issue Picker is not yet mapped to any edit screen.â

Click Load work item candidates.
4. Select the Work Items
Required Jira Role: Jira Administrator
The app reviews up to 3,000 work items and lists the eligible ones in the step Work items, at most 1,000 at a time:
- Source work item: the work item whose field will be filled.
- Target field value: the keys of its linked work items that the field will get.
A single-select picker only takes work items with exactly one eligible link. Select the work items one by one or with Select all. To refine the list, go back to Scope, change the projects or the JQL, and load the candidates again.

5. Run the Auto-Fill
Required Jira Role: Jira Administrator
Click Start. The button shows the progress, e.g. Uploading (3/5). The app fills one work item after the other. Keep the dialog open: closing it stops the process.
When it is done, the dialog shows e.g. âAuto-fill completed successfully: 5 work items filled.â If some work items could not be filled, their keys are listed. Close the dialog with Close and check the work items.

Auto-fill only writes the field. The links already exist, so no new links are created.
6. Many Work Items
Required Jira Role: Jira Administrator
To process more than one batch, close the dialog, open it again with Upload and load the candidates again. Work items filled before are no longer candidates, because their field is not empty anymore. Repeat until the dialog shows âNo work item to fill was found.â
Like Atlassian's own bulk changes, the limit of 1,000 work items per run protects the performance and stability of your Jira.