Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

JIRA change project key

Hi is there anyway to change a project key and all the issue key associated to the project?
This is one way to do it, but is there any easier way? This involves too many steps and time consuming if the JIRA is big.

  1. Export your JIRA data to XML.
  2. Go through the file and replace the instances of the project's key:
    • in the 'key' attribute of the Project entity
    • in the 'key' attribute of all Issue entities.
  3. Search for the project key in the whole XML file. You should not find too many references. Change any that you find.
  4. Rename all attachment folders, as the folder name depends on the project key. This includes one folder for each issue with an attachment, plus one top-level folder for the project.
  5. Reimport your data.
  6. Reindex the data by navigating to Administration -> System -> Indexing and selecting 'Re-Index'.

2 answers

1 accepted

This is the most effective solution. If you do it in DB, there may still be references hanging around and it won't fix attachments.

another workaround is to create a new project with the same configuration as the old project but edit the project key.

do a bulk move issues from old project to new project

0 votes

This feature was implemented on JIRA 6.1 (see release notes), and it is now possible to change project key via the JIRA UI. For the detailed instructions about this feature, you may refer to the links below:



Warning to future admins using this feature: editing the project key in JIRA does not migrate attachments nor does it create a new project key attachment directory (even for new issues after renaming).

This could be important if you have additional web services accessing files in the Jira attachment directory based off the project key (like I did).

Like # people like this

Thats well said

Like Asegid Debebe likes this

Hello, I have changed a Next Gen project name from IT to OLDIT. The Project Key shows as OLDIT now - hwever - when I try to create a Classic Project called IT and specify using IT as the Project Key, I'm told that "Old IT Support uses this Project Key". How do I accomplish creating my new Classic Project with the Project Key I love?

Suggest an answer

Log in or Sign up to answer

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you