Project key with numbers

Is there any known issues for project keys with numbers?

We thinking about changing 'jira.projectkey.patter' parameter to allow numbers, but afraid that something can go wrong with these keys (as within JIRA itself, as well and with Confluence / Fisheye links).

2 answers

1 accepted

2 votes
Accepted answer

They can break some addons (notably Agile), and changes to the key are not supported by Atlassian.

However, the break of addons only seems to happen when you use a number as the first letter of a key, and Jira 6.1 does improve support for changes of key. Although it's not an explicit recommendation by Atlassian, the general advice is to keep the first character of the key as A-Z, then you can use A-Z, 0-9 and underscores for the rest of it (minimum length 2 characters as well)

I'm sorry, but what exactly doesn't supported by Atlassian? Bugs related to project keys with numbers?

Changing the project key to something outside an Atlassian recommended format is not supported.

They'll code on the assumption that you don't go outside a recommended format, so there's a small chance that they might even add new problems inadvertently.

In other words, if you do it, and you have a problem which needs support, then Atlassian are entitled to say that they aren't going to try to help you, at least until you go back to a supported format. (In real life, they'll really do their best to help you without demanding changes like that)

@Nic: I would not recommend having an underscore as my project key. It is a known issue on jira 5.0-jira5.2.5 that activity stream does not work if project key has underscore. Fixed in 5.2.5 though.


I know, I was assuming version 6.1 - we all had a lot of "fun" when the discussions around 6.0 and moving to A-Z only came up...

Hi Aliaksei,

It's not a problem to use numbers on key format.

I just recommend that you use the supported format. Here is what the official documentation says:

Ensure that you choose a supported project key format. Only formats that meet all of the following rules are supported:

- The first character must be a letter,

- All letters used in the project key must be from the Modern Roman Alphabet and upper case, and

- Only letters, numbers or the underscore character can be used.


Examples of supported keys: PRODUCT_2013, R2D2, MY_EXAMPLE_PROJECT.

Examples of unsupported keys: 2013PROJECT (first character is not a letter), PRODUCT-2012 (hyphens are not supported).

If you want to see the complete documentation, here is the link:


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,817 views 18 22
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