# Quick one about issue fields (apps)

**URL:** <https://community.developer.atlassian.com/t/quick-one-about-issue-fields-apps/53058>\
**Category:** Jira Cloud\
**Tags:** issue-field, rest-api, atlassian-connect\
**Created:** [October 21, 2021, 8:30am UTC](https://community.developer.atlassian.com/t/quick-one-about-issue-fields-apps/53058 "2021-10-21T08:30:55Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![david.pinn](https://sea1.discourse-cdn.com/atlassiandeveloper/user_avatar/community.developer.atlassian.com/david.pinn/32/36134_2.png) [@david.pinn](https://community.developer.atlassian.com/u/david.pinn)\
**Post date:** [October 21, 2021, 8:30am UTC](https://community.developer.atlassian.com/t/quick-one-about-issue-fields-apps/53058/1 "2021-10-21T08:30:55Z")

</div>

Can a Connect app programmatically change the name of an issue field that it specified [in the descriptor](https://developer.atlassian.com/cloud/jira/platform/modules/issue-field/)?

Is [`PUT /rest/api/3/field/{fieldId}`](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-fields/#api-rest-api-3-field-fieldid-put) the way to do that? The documentation doesn’t say.

---

<div class="post-metadata">

**Author:** ![anon96974232](https://avatars.discourse-cdn.com/v4/letter/a/7ba0ec/32.png) [@anon96974232](https://community.developer.atlassian.com/u/anon96974232)\
**Post date:** [October 21, 2021, 6:21pm UTC](https://community.developer.atlassian.com/t/quick-one-about-issue-fields-apps/53058/2 "2021-10-21T18:21:58Z")

</div>

Hello @david.pinn

Yes, sending a PUT request to the _[Update custom field](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-fields/#api-rest-api-3-field-fieldid-put)_ endpoint is how you change the name, description or searcherKey of a custom field.

You cannot change built-in fields, only custom fields.

---

<div class="post-metadata">

**Author:** ![david.pinn](https://sea1.discourse-cdn.com/atlassiandeveloper/user_avatar/community.developer.atlassian.com/david.pinn/32/36134_2.png) [@david.pinn](https://community.developer.atlassian.com/u/david.pinn)\
**Post date:** [October 22, 2021, 1:49am UTC](https://community.developer.atlassian.com/t/quick-one-about-issue-fields-apps/53058/3 "2021-10-22T01:49:50Z")

</div>

I went ahead and coded this up. Unfortunately, it appears that an app cannot rename its own fields if those fields were created via a `jiraIssueFields` module.

```
HTTP 400: The custom field is locked.

```

At the very least, there’s a documentation inadequacy here.

Is there any mechanism for programmatically renaming fields created via `jiraIssueFields` modules?

---

<div class="post-metadata">

**Author:** ![anon96974232](https://avatars.discourse-cdn.com/v4/letter/a/7ba0ec/32.png) [@anon96974232](https://community.developer.atlassian.com/u/anon96974232)\
**Post date:** [October 22, 2021, 2:26am UTC](https://community.developer.atlassian.com/t/quick-one-about-issue-fields-apps/53058/4 "2021-10-22T02:26:24Z")

</div>

Are you positive it is a custom field that you created via your Connect app, and not some other app / plugin / part of Jira itself?

It seems that custom issue field created by your Connect app has been [set with a locked state](https://support.atlassian.com/jira-cloud-administration/docs/what-are-locked-custom-fields/) to prevent other apps / REST API sessions from changing it.

You may have to delete your custom issue field, then create a new one with the desired name / description, then modify your Connect app to allow for the change.

The REST API documentation says that:

_[Connect app scope](https://developer.atlassian.com/cloud/jira/platform/scopes) required_\* : `ADMIN`

… so it could be you’re not executing the PUT with sufficiently high enough privs?

If you search this forum or Google “jira cloud issue field locked” you will see lots of threads on the nature of [locked custom fields](https://support.atlassian.com/jira-cloud-administration/docs/what-are-locked-custom-fields/) that might get you closer to the answer.

---

<div class="post-metadata">

**Author:** ![david.pinn](https://sea1.discourse-cdn.com/atlassiandeveloper/user_avatar/community.developer.atlassian.com/david.pinn/32/36134_2.png) [@david.pinn](https://community.developer.atlassian.com/u/david.pinn)\
**Post date:** [October 22, 2021, 2:41am UTC](https://community.developer.atlassian.com/t/quick-one-about-issue-fields-apps/53058/5 "2021-10-22T02:41:35Z")

</div>

> [@anon96974232](#):
>
> Are you positive it is a custom field that you created via your Connect app, and not some other app / plugin / part of Jira itself?

Yes.

> [@anon96974232](#):
>
> It seems that custom issue field created by your Connect app has been [set with a locked state](https://support.atlassian.com/jira-cloud-administration/docs/what-are-locked-custom-fields/) to prevent other apps / REST API sessions from changing it.

It appears that all fields created by `jiraIssueFields` modules are locked.

> [@anon96974232](#):
>
> You may have to delete your custom issue field, then create a new one with the desired name / description, then modify your Connect app to allow for the change.

What I want is for my custom field to have a different name on each tenant’s Jira instance. Thus the need to rename it.

> [@anon96974232](#):
>
> … so it could be you’re not executing the PUT with sufficiently high enough privs?

No. My app has ADMIN and ACT\_AS\_USER scope. I’m executing the PUT operation under the identity of my app.

---

<div class="post-metadata">

**Author:** ![anon96974232](https://avatars.discourse-cdn.com/v4/letter/a/7ba0ec/32.png) [@anon96974232](https://community.developer.atlassian.com/u/anon96974232)\
**Post date:** [October 22, 2021, 2:56am UTC](https://community.developer.atlassian.com/t/quick-one-about-issue-fields-apps/53058/6 "2021-10-22T02:56:26Z")

</div>

OK, I get the full context now. I think you’re going to need to liaise with Atlassian how to go about changing that field’s name / description in Jira Cloud, for each single client instance. I remember reading articles on how to do it for Jira SERVER that required altering it at the database level, which isn’t allowed in Jira Cloud.
