How to change the issue key counter to a desired number
Platform Notice: Cloud - This article applies to Atlassian products on the cloud platform.
Purpose
Whenever a new project is created ideally the issue key starts from 1 (ie. ABC-1). Sometimes, you want to start the issue key/number to start with a different number (ie. ABC-11).
Environment
Jira Service Management Cloud, Jira Cloud
Solution
- This action can not be reverted, please key in the correct issue key/number in the CSV file. Always use 1 number below your expected issue key.
- If the destination project has already some existing issues (ie. ABC-100), you should not set the issue key/number in the CSV file below that. You can however use the issue key/number after 100 (ie. ABC-101 or more)
You can achieve this by using the CSV import feature in Jira to map the issue key to your desired number. If you wish to have the issue starting with issue key = 11 (ie. ABC-11), you need to import an issue with an issue counter below the expected issue key, in this case, it would be 10 (ie. ABC-10).
- First of all, you would have to create a CSV file with the following information (you can create the same with the help of any text editor)
Below is an example of the most basic fields you need to fill while creating a new issue. Please note, if you have the required field/custom field in the "Issue Create" field, be sure to add them to the CSV file.
- Be sure to use
Save the file with any name with a CSV extension file locally to your system.
Issue type, Summary, Priority, issue key Task, Testing, Major, Project_key-xx
Choose > System.
In the Import and Export section, click External System Import and then click CSV. Choose your CSV source file.
Leave the Use an existing configuration file option unchecked if you do not have a configuration file or if you want to create a new one. Configuration files specify a mapping between column names in your CSV file's header row and fields in your Jira site. At the end of the CSV import process, Jira will create a configuration file that you can use for subsequent CSV imports.
Expand the Advanced section to change the file encoding (UTF-8 by default) and CSV delimiter. If your CSV file uses a separator character other than a comma, specify that character in the CSV Delimiter field.
Click Next.
- On clicking Next you will be taken to the next page wherein you would have to select the project you want to make this change to.
- After selecting the project and hitting the Next button, please map all the fields accordingly, especially for the Issue key.
- Once the filed mapping is done, you would see the page like the below screenshot.
- You would then be re-directed to the Begin Import page. Please hit the Begin Import option.
- Once this step is over, you will get to see the result as
- Going back to the project you selected, you would be able to see a ticket imported referencing the same number you have added in the CSV file. You can delete the ticket if you wish (optional), and the next newly created issue would start with your desired issue key/number (ie. ABC-11).
To learn more about CSV import, please visit Import data from a CSV file.