Hi! When custom fields are "re-used" with differing contexts, the name of the field can be confusing to end-users using agent screens.
(Note: we have tried using field descriptions per project, but most people don't use the info bubble when looking at the field.)
Thanks in advance for any ideas!
-Kim-Stacey
From my understanding this option is available only in JSM projects and not to regular Jira projects.
This remains a sore point in Jira Software world! Most of the time users don't agree on the field name and as a admin you end creating new field.
I was hoping this feature will make it's entry in Jira Cloud but yet to be seen.
@Susan Waldrip Thanks, Susan! Good suggestions - we're currently using all. I edited my post to address the agent screen.
Is there a reason you don't want to make a separate field? I have a couple like that, where reporting needs trump the display name.
I wish we could populate placeholder text a la the Confluence Macro, at least for text fields. it would help in situations like this and save me a lot of repetitive Slack messages.
I believe that as the number of custom fields increases, they can negatively impact system performance. Utilizing custom field contexts instead can help minimize the impact.
@Kim-Stacey Kidder Yes, excessive custom fields can impact system performance. However, in Cloud this limit is 6,000 (according to the site optimizer), so you should hopefully not hit this for a while!
We also encounter this issue of field naming in our sites. We're aiming to keep our config items as low as possible as we're opening up the permission for trusted users to edit their own screens. We've moved to keeping field names as generic (but clear) as possible to make this easier for users - but as @Anne Saunders mentioned sometimes reporting needs (or a pushy business owner) win!
Update (2025-06-19): @Kim-Stacey Kidder I learned something new! 🙂
My original answer is wrong as identified by @Long Le _Appfire_ . Your use case is possible through third-party scripting using something like Live Fields or ScriptRunner.
The way it works is that the field name stays the same inside Jira, but the scripting app can dynamically update the screen after it loads. So, you might see an approximately one-second lag between screen load and the field name changing.
Here's an example I just tested using Live Fields with JMWE.
My system contains a field called "Verification Summary" for user stories:
In a single project, I can have this field dynamically change to "Verification Notes" after the screen loads:
Using this Live Fields script:
Note 1: Limitation -- This solution only works on the Create and View screens. As far as I can tell, it won't update the List View, filter results, or anywhere else users may use the field. So it probably addresses the main scenarios, but not all scenarios.
Note 2: Again, this is probably possible through ScriptRunner and other apps, too. I tried Live Fields because it was suggested by @Long Le _Appfire_ , and because I am already a JMWE user.
Hi @Kim-Stacey Kidder -- This is probably a difficult use case to satisfy due to the way Jira handles custom fields. As far as I know, even third-party apps cannot dynamically change their own custom field names.
So, without understanding your use case, here are a few non-ideal workarounds:
Of course, these workarounds may not be usable for your use case. But I strongly suspect the ideal solution isn't possible based on what I know about custom fields.
@Aaron Morris Thank you!! Very helpful info! 😊
The Live Fields app looks awesome!
The hardest part is not changing the field names in screens but in the JQL searches and filters. It's also related to the problem of localizing field names in different languages. Tricky, tricky
I think localization is definitely need to be there. But at the most basic level if we have this solved without localization, it will be a big win!
@Raju Kadam - Localization is supported natively by Jira: https://support.atlassian.com/jira-cloud-administration/docs/translate-a-custom-field/
But of course, that is based on language settings rather than project key, user group, etc., as is the focus of this question.
Right ask here is Custom fields and having aliases available through out the Jira so that they can be used without any limitations. This will in turn help Admins to reduce the unnecessary new custom field creations and hence the big time improvements in Jira performance.
Hi! I'm Long, a senior developer at Appfire, and I just wanted to chime in here since this topic came up. We have an app called Live Fields that can help with this kind of customization.
It allows you to change the way fields behave on Jira screens (like Create, View, and soon Transition) based on specific conditions. One of the supported features is dynamically updating the field name or description, which sounds like what you're trying to do, for example, displaying a field as “Notes” for one user/group and “Release Comments” for the others
Beyond renaming, Live Fields can also:
- Show or hide fields based on issue type, status, or field values
- Make fields required or read-only for certain users or groups
- Pre-fill fields with default content
- Set field values automatically based on simple rules
There are example use cases and scripts available to help get started, and they can be tailored depending on the needs of your team or project setup.
Hope this helps. I'm happy to provide more details or examples if needed.
@Long Le _Appfire_ - thank you! This looks promising!
This looks like JMWE extension. I didn't know that we can change the field names too. Will take a look.
@Long Le _Appfire_ one question for you: Will this also make sure new name is reflected in JQL too? If that's also it can do, then it's a huge win for Admin community to set the rule - *one custom field covers all (similar cases)*
Thanks,
Raju
Extending JQL to use field aliases would indeed be very useful, but I don't think that Live Fields or ScriptRunner have that feature at the moment
Disclosure: my employer is Adaptavist, the ScriptRunner vendor
Yes @MattD that will be the one last thing we will need to reduce this custom fields clutter just because no one agrees on the name of the field :-(
I'm not sure how much is the effort required, but is this feature available on either Live Fields (Appfire) or ScriptRunner team. You will get many blessings from frustrated Jira Admins :-)
Yes, that would be a great feature! But unfortunately, I think it would require an enhancement from Atlassian more than Appfire, Adaptavist, or other vendors.
The challenge is that Jira doesn't support dynamic names for a custom field. So, without an enhancement from Atlassian, it seems it would be challenging to find a way to force the native JQL engine to recognize dynamic names.
Of course, vendors could add an Alias() function (for example) that would translate dynamic field names, but then users would need to be trained to use that function instead of referencing fields directly...which might defeat the purpose. ☹️
But I'm not one to discourage innovation, and I welcome the opportunity to be proven wrong again. 😆
Totally agree! This is something will need to be done at Jira platform level. Anyone has a idea if this feature is in request?
I looked into jira.atlassian.com and only one task found and that also without much love. https://jira.atlassian.com/browse/JRASERVER-66199 Maybe we should vote it and get some visibility.
Though this task is for Jira DC, I'm sure everyone from Jira cloud will also love the feature.
Hi everyone, this is a great conversation and I appreciate all the input.
@Raju Kadam That's a great question. To give you the straight answer: no, at the moment Live Fields can't change the field name in a JQL search. As @Aaron Morris and @MattD pretty much pointed out the reason why. The change we make is on the "display" level, i.e., what people see on the screen. The JQL engine is still looking at the "real" field name in Jira's issue.
Thanks for digging up that feature request for customfield alias. We've definitely thrown our votes on there. It's a change we'd all love to see Atlassian make at the platform level. It would make life easier for every admin out there.
The conversation about JQL aliasing has raised some important points. I will bring this feature request to our product team to evaluate. We have other apps in the Appfire ecosystem, particularly those that handle JQL Search, that could potentially accommodate this requirement. While I cannot make any promises regarding a timeline, please know that we recognize the clear need for this functionality.
@Long Le _Appfire_ Thanks for the follow up. If you have any publicly visible Jira tracking where this feature request your team will be tracking, please do share here, I would love to see where it goes and happens even in distant future, as it's definitely going to help everyone to avoid all the clutter that we don't want to add!
Our Enterprise Jira Admin is sending you all the best wishes to make it happen :-)
Cheers,
Raju
There now is a Jira Cloud feature request for this functionality, please go vote if you'd like to see it implemented some day: https://jira.atlassian.com/browse/JWMCLOUD-913
For this I use the Context and update the Description of the field so that the help text is relevant to the context of use (whichever projects need to know that 'Notes' is 'Any remarks, comments, or other details relevant to the release, aka Release Comments').
Due to this situation we try to avoid renaming. To conserve the fields in older tickets the way they are used formerly we put a "...(deprecated)" or something similar to the fields name and create a new custom field. That´s not the best way i know but it´s simple.
Besides that we store on a internal Confluence page the history & menaing of our custom fields for site-admins/project-admins as change-logs. (i know that there are audit logs available but you have to know for what you search to find it).
Regards, BeGu
Hi @Kim-Stacey Kidder ,
We have looked everywhere on this as well, but I do not think, there is a way as of right now.
So we have a few workarounds for a few scenarios, but in the end, "Notes" or "Release Comments" verbally really serve a different use-case and here we would create a field for each. It does not harm the System, if done strategically.
What are our Workarounds:
We just recently looked into altering Field-options with the options as well, based on roles / languages, but behaviors and properties are not capable of replacing text on the UI. Just hide / reveal etc.
I checked with multiple folks at Atlassian, and that's the current situation. Nothing better seems to be available yet, as Atlassian is the "Limiting" factor. Apps are simply not allowed to manipulate here as of right now.
Hope this helps.
Sascha
Recommended Learning For You
Level up your skills with Atlassian learning
Learning Path
Become an effective Jira admin
Manage global settings and shared configurations called schemes to achieve goals more quickly.
Streamline Jira administration with effective governance
Improve how you administer and maintain Jira and minimize clutter for users and administrators.
Learning Path
Become an effective Jira software project admin
Set up software projects and configure tools and agile boards to meet your team's needs.
Online forums and learning are now in one easy-to-use experience.
By continuing, you accept the updated Community Terms of Use and acknowledge the Privacy Policy. Your public name, photo, and achievements may be publicly visible and available in search engines.