# IssueCustomField

Represents a custom field along with its value in the particular issue.

The `IssueCustomField` is an abstract ancestor for all types of custom fields in issues. The actual type of the custom field depends on field settings in the particular project.

Each `IssueCustomField` entity, regardless of its type, has the following attributes:

* `$type` — the unique type of the issue custom field. You must provide this attribute when you update the custom field in an issue.

* `id` — the entity ID of the issue custom field.

* `name` — the string name of the custom field.

* `projectCustomField` — the reference to the settings of the custom field in the project.

* `value` — the value assigned to the custom field in the issue. Depending on the type of the field, this attribute can store a single value or an array of values.

## Related Resources

Below you can find the list of resources that let you work with this entity.

* [Issue Custom Fields](resource-api-issues-issueID-customFields.html)

Extended by:

* [PeriodIssueCustomField](api-entity-PeriodIssueCustomField.html)

* [SimpleIssueCustomField](api-entity-SimpleIssueCustomField.html)

* [SingleValueIssueCustomField](api-entity-SingleValueIssueCustomField.html)

* [MultiValueIssueCustomField](api-entity-MultiValueIssueCustomField.html)

* [TextIssueCustomField](api-entity-TextIssueCustomField.html)

## Attributes

This table describes attributes of the `IssueCustomField` entity.

* To receive an attribute in the response from the server, specify it explicitly in the `fields` request parameter.

* To update an attribute, provide it in the body of a POST request.

|  Field  |  Type  |  Description  |
| --- | --- | --- |
|  id  |  String  |  The ID of the custom field in the issue. `Read-only`.  |
|  name  |  String  |  The name of the custom field. `Read-only`.  |
|  projectCustomField  |  [ProjectCustomField](api-entity-ProjectCustomField.html)  |  Reference to the custom field settings for the particular project. `Read-only`.  |
|  value  |  Possible value types depend on the custom field type. This property can contain a primitive value, a single entity value, or an array of entity values.     * String    * Integer    * Float    * Date and Time    * Date    * [StateBundleElement](api-entity-StateBundleElement.html)    * [BuildBundleElement](api-entity-BuildBundleElement.html)    * [VersionBundleElement](api-entity-VersionBundleElement.html)    * [OwnedBundleElement](api-entity-OwnedBundleElement.html)    * [EnumBundleElement](api-entity-EnumBundleElement.html)    * [UserGroup](api-entity-UserGroup.html)    * [User](api-entity-User.html)    |     The value assigned to the custom field in the issue.       Depending on the type of the field, this attribute can store a single value or an array of values.    `Read-only`. `Can be null`.  |