Documentation
Quick Issue Import creates Jira issues from an Excel or CSV file, in
company-managed and team-managed projects, with your own Jira account and permissions.
Need help? Contact support
Getting started
Open the Jira project where the issues should go, then click the Quick Issue Import tab in the project navigation bar. If you don't see it, look under More. The screen has three steps, named File, Columns, and Check and create. Nothing is created in Jira until you click a Create button in the last step.
Step 1, the file
Pick an Excel (.xlsx) or CSV file of up to 10 MB and 5,000 rows. The file is read in your browser and is never uploaded.
CSV files saved by Excel in Europe work as they are. Semicolons, accents and day-first dates are understood. Rows hidden in Excel are left out, unless you tick Also import the rows hidden in Excel. If the column titles are not on the first row, choose the right row under Row with the column titles.
Step 2, the columns
The columns of the file are matched to Jira fields, and any column left out says why. The app fills the summary, description, issue type, priority, due date, labels and assignee. If the project has a required field that the app can't map yet, you can give it the same value for every row.
Assignees are matched to people who can be assigned in the project, and never guessed. When a name in the file matches nobody, you choose between Import without assignee and Skip them.
Step 3, check and create
Rows with a problem the app can spot are listed first, each with the reason, and they are skipped. The other rows are ready.
Click Create the first 5 to check. Five issues are created, and a link opens them in Jira so you can look at the result. Then click the Create the remaining button, which shows how many rows are left. The issues are sent in batches of 50, with counters at the top and a Stop button. When you press Stop, the batch already sent finishes and no other batch starts.
Issues are created with your own Jira account and permissions. For each issue created, Jira may send its usual email notifications and run its automation rules, as it does for any new issue.
Stopped or closed? Pick the same file
Each issue carries a hidden mark. If the tab closes, the connection drops or you press Stop, open Quick Issue Import again in the same project and choose the same file. The rows already created are found and skipped, and only the others are created.
A row you changed in the file since the last import counts as a new row and is created as a new issue. If two people, or two browser tabs, import the same file at the same time, some issues can be created twice.
Rows not created
Rows skipped by the app and rows refused by Jira are listed in a table, each with the reason. Click Download the rows to fix to get them in a CSV file, which uses semicolons and UTF-8. Fix the rows, then import that file. Its Reason column is ignored.
Finding the issues afterwards
At the end, Open the issues of this import shows them in a Jira search. A second link finds them by project, reporter and creation time, without the hidden mark. It keeps working even after Quick Issue Import is removed, and it can also show other issues created by the same people since the import.
Who can import
By default, everyone on the site can use the app. A Jira administrator can choose who imports in Settings, then System, then Global permissions, under Use Quick Issue Import. Everyone keeps their usual Jira permissions, and the app can only create issues where the person importing is allowed to create them.
Subscription
The app runs on the subscription held by your Jira site. If the subscription stops, the panel says so and no issue can be created. Issues already created stay in Jira.
Support
Use the support contact form, or write to contact@webelisys.fr. Include your Jira site address and, if you can, the project where the problem happened.