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 votes

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 Join to answer
Community showcase
Sarah Schuster
Posted Jan 29, 2018 in Jira

What are common themes you've seen across successful & failed Jira Software implementations?

Hey everyone! My name is Sarah Schuster, and I'm a Customer Success Manager in Atlassian specializing in Jira Software Cloud. Over the next few weeks I will be posting discussion topics (8 total) to ...

3,043 views 13 18
Join discussion

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
Atlassian Team Tour

Join us on the Team Tour

We're bringing product updates and pro tips on teamwork to ten cities around the world.

Save your spot