It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

How can I change a Project Key?

John Simonson Feb 15, 2012

I realize that the Project Key is being used practically everywhere in JIRA as a form of foreign key (the database is not exactly in normal form, is it?).

But maybe someone has a means of changing a key (e.g. from JIRA2011 to JIRA2012), so that all the Issues and Histories and whatever stay with the project.

Or is this another example of "backup to XML, search and replace in XML, restore from XML"?

We are currently running JIRA 4.4.0.

3 answers

1 accepted

8 votes
Answer accepted
Vicky Kharisma Atlassian Team Sep 22, 2013

Hi All,

Just a quick update, it is now possible to rename the project key via UI in JIRA 6.1


5 votes
Alex Suslin Feb 15, 2012

It is not currently possible to change the project key through JIRA's interface. The best way to do this is to:

  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'.


There is a ticket in JIRA for that:

However you can create another project and move all the issues to it, than delete the old one.

Alex Suslin Feb 15, 2012

Yes and you will find in issue history that previously the issue was in other project with different project key.

John Simonson Feb 15, 2012

Thanks Thomas and Alex - that is what I was afraid of (detour through XML).

Alex, will creating a new project, moving issues, then deleting the old project leave the histories intact?

Does moving the issues from one project to another keep their numbers? It's easy to create a redirection on nginx frontend for fixing old links but the real question is the numbers kept? Remember that you can have spaces between ticket numbers due issues that were removed.

1 vote
Thomas Schlegel Community Leader Feb 15, 2012

Suggest an answer

Log in or Sign up to answer
This widget could not be displayed.
This widget could not be displayed.
Community showcase
Published in Next-gen

Introducing subtasks for breaking down work in next-gen projects

Teams break work down in order to help simplify complex tasks. This is often done iteratively, with tasks being broken down into smaller tasks and so on until the work is accurately captured in well-...

1,099 views 13 15
Read article

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