Troubleshooting

Troubleshooting

Frequently asked questions

The app may not be installed, or the install may be on a different Jira instance. Confirm the app appears under Jira Settings > Apps > Manage apps. If not installed, get it from the Atlassian Marketplace. Also check that you are on Jira Cloud. This app does not support Data Center.
You need the Link Issues permission in the project. Ask your project admin to check Project Settings > Permissions > Link Issues and ensure your role or user is included.
Archive Issues is a project-level permission. A project admin (not a Jira admin) can grant it via Project Settings > Permissions > Archive Issues. Add your role or group and save changes. Note: "Project admin" means someone with the Administer Projects permission for that project. They do not need to be a Jira site admin.
Certain values in JQL are reserved words. If you are trying to search for archived issues using isArchived = true, note that true is a reserved word in Jira JQL and this filter does not work. There is no standard JQL way to search for archived issues from within the app. For other JQL errors, check your query syntax in the native Jira issue navigator first. Jira will highlight which part of the query is invalid.
Each JQL-mode run processes the first 1000 matched issues. If your query matches more, a warning shows the approximate total and how many are left out. Refine your JQL (add a project, status, or date filter) so the result set fits, then run again for the rest.
Bulk operations process in batches. If you closed the dialog before all batches completed, some issues may not have been processed. Re-open the dialog and run the operation again on the remaining issues. All bulk link, unlink, and archive operations are safe to re-run. Re-linking an already-linked pair is handled gracefully by Jira.
The results summary groups issues by success and by failure reason. Common failure reasons: Issue not found. The key does not exist in this Jira instance or you do not have permission to view it. Permission denied. The Link Issues or Archive Issues permission is missing on that specific project. Rate limit. Very rarely, Jira's API rate limit is reached. The dialog retries automatically, but if items still fail, wait a moment and use the Retry N failed button on the done screen.
The Link Summary Panel is always present for any user who can view the issue. There is no admin toggle to hide it. If you cannot see the panel: Confirm the app is installed via Jira Settings > Apps > Manage apps. Confirm you have the Browse Projects permission on the project. Reload the issue view in your browser. The panel can lag on a tab open from before the install.
Archiving hides issues from boards, backlogs, and standard JQL searches. However, some saved filters may continue to return them depending on how Jira evaluates archived status in your instance. Direct URL access to an archived issue still works. To restore an issue, open it via its direct URL and use the Unarchive option on the issue view.
The 30-day free trial has ended and a paid subscription is needed. A Jira administrator can manage the subscription at Jira Settings > Apps > Manage apps > Bulk Link & Archive for Jira. Licensing is handled entirely by Atlassian Marketplace.

Common errors

Error

Cause

Fix

Error

Cause

Fix

403 Forbidden on Archive

Missing Archive Issues project permission

Project Settings > Permissions > Archive Issues

403 Forbidden on Link/Unlink

Missing Link Issues project permission

Project Settings > Permissions > Link Issues

"true is a reserved word" in JQL

Using isArchived = true JQL filter

Not supported. Use paste-keys mode instead.

URL validation error on Add Web Link

URL missing protocol prefix

Add https:// at the start of the URL

"Couldn't find project X" message

Project key is wrong or misspelled, or you lack access to it

Check the key (for example VNDR, not NDR) and confirm you can browse that project

Operation stops mid-run

Dialog closed before completion

Re-run with remaining keys

Still need help?

Raise a support request at opstech-apps.atlassian.net.