Jira not accepting project key


I am on jira 5.0.2. While trying to create a new project with key XYZ13 the system is nt allowing me to do so with an error message.

You must specify a unique project key, at least 2 characters long, containing only uppercase letters.

I checked for this key XYZ13 and it does not appear in any of my projects.

What can be going wrong?

Note: I do have a project with key XYZ in my instance.


2 answers

1 accepted

1 vote
Accepted answer

There was a bit of a change here. Atlassian have never supported numeric keys but did allow us to change it. But in later versions, the key pattern moved from a config file into the admin screens, and, of course, that clobbers upgrades. Because you lose that setting - it reverts to [A-Z][A-Z]+

This doesn't affect existing projects, only creation of a new project. You can, of course, simply update the pattern to allow it. I would strongly recommend [A-Z][A-Z1-9]+ though - I ran into a bug in two different plugins where they choked on project keys starting with numbers (but worked fine with numbers after the initial letter)

You can't use numers:

[...] containing only uppercase letters.

On our Jira instance we have lots of projects with numbers in their keys.


You can change the pattern in System / Gerneral Configuration / Advanced: jira.projectkey.pattern

The default is ([A-Z][A-Z]+). What is your pattern?

My pattern is ([A-Z][A-Z]+) and I have recently upgraded to 5.0.2 which may be the reason why i have numbered keys....

Perhaps the settings regarding project key were altered at some point? Because the pattern you display as your current setting is alphas only; see documentation here.

Suggest an answer

Log in or Sign up to answer
Community showcase
Published Nov 27, 2018 in Portfolio for Jira

Introducing a new planning experience in Portfolio for Jira (Server/DC)

In the past, Portfolio for Jira required a high degree of detail–foresight that was unrealistic for many businesses to   have–in   order to produce a reliable long-term roadmap. We're tur...

2,409 views 15 19
Read article

Atlassian User Groups

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

Find a group

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

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you