--- title: "Get custom field contexts default values" method: GET path: "/rest/api/2/field/{fieldId}/context/defaultValue" tags: ["Issue custom field contexts"] deprecated: true --- # Get custom field contexts default values `GET /rest/api/2/field/{fieldId}/context/defaultValue` > **Deprecated.** Returns a [paginated](#pagination) list of defaults for a custom field. The results can be filtered by `contextId`, otherwise all values are returned. If no defaults are set for a context, nothing is returned. The returned object depends on type of the custom field: * `CustomFieldContextDefaultValueDate` (type `datepicker`) for date fields. * `CustomFieldContextDefaultValueDateTime` (type `datetimepicker`) for date-time fields. * `CustomFieldContextDefaultValueSingleOption` (type `option.single`) for single choice select lists and radio buttons. * `CustomFieldContextDefaultValueMultipleOption` (type `option.multiple`) for multiple choice select lists and checkboxes. * `CustomFieldContextDefaultValueCascadingOption` (type `option.cascading`) for cascading select lists. * `CustomFieldContextSingleUserPickerDefaults` (type `single.user.select`) for single users. * `CustomFieldContextDefaultValueMultiUserPicker` (type `multi.user.select`) for user lists. * `CustomFieldContextDefaultValueSingleGroupPicker` (type `grouppicker.single`) for single choice group pickers. * `CustomFieldContextDefaultValueMultipleGroupPicker` (type `grouppicker.multiple`) for multiple choice group pickers. * `CustomFieldContextDefaultValueURL` (type `url`) for URLs. * `CustomFieldContextDefaultValueProject` (type `project`) for project pickers. * `CustomFieldContextDefaultValueFloat` (type `float`) for floats (floating-point numbers). * `CustomFieldContextDefaultValueLabels` (type `labels`) for labels. * `CustomFieldContextDefaultValueTextField` (type `textfield`) for text fields. * `CustomFieldContextDefaultValueTextArea` (type `textarea`) for text area fields. * `CustomFieldContextDefaultValueReadOnly` (type `readonly`) for read only (text) fields. * `CustomFieldContextDefaultValueMultipleVersion` (type `version.multiple`) for single choice version pickers. * `CustomFieldContextDefaultValueSingleVersion` (type `version.single`) for multiple choice version pickers. Forge custom fields [types](https://developer.atlassian.com/platform/forge/manifest-reference/modules/jira-custom-field-type/#data-types) are also supported, returning: * `CustomFieldContextDefaultValueForgeStringFieldBean` (type `forge.string`) for Forge string fields. * `CustomFieldContextDefaultValueForgeMultiStringFieldBean` (type `forge.string.list`) for Forge string collection fields. * `CustomFieldContextDefaultValueForgeObjectFieldBean` (type `forge.object`) for Forge object fields. * `CustomFieldContextDefaultValueForgeDateTimeFieldBean` (type `forge.datetime`) for Forge date-time fields. * `CustomFieldContextDefaultValueForgeGroupFieldBean` (type `forge.group`) for Forge group fields. * `CustomFieldContextDefaultValueForgeMultiGroupFieldBean` (type `forge.group.list`) for Forge group collection fields. * `CustomFieldContextDefaultValueForgeNumberFieldBean` (type `forge.number`) for Forge number fields. * `CustomFieldContextDefaultValueForgeUserFieldBean` (type `forge.user`) for Forge user fields. * `CustomFieldContextDefaultValueForgeMultiUserFieldBean` (type `forge.user.list`) for Forge user collection fields. **Deprecated:** This API is deprecated and will be removed in October 2026. A replacement API that supports multiple default values per issue type within a context is coming soon. See the deprecation notice [CHANGE-3082](https://developer.atlassian.com/cloud/jira/platform/changelog/#CHANGE-3082) for more details. **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg). ## Path parameters - `fieldId` string, required ## Query parameters - `contextId` integer[] - `startAt` integer - `maxResults` integer ## Response `200` Returned if the request is successful. - PageBeanCustomFieldContextDefaultValue — A page of items. - `isLast` boolean — Whether this is the last page. - `maxResults` integer — The maximum number of items that could be returned. - `nextPage` string, uri — If there is another page of results, the URL of the next page. - `self` string, uri — The URL of the page. - `startAt` integer — The index of the first item returned. - `total` integer — The number of items returned. - `values` CustomFieldContextDefaultValue[] — The list of items. - union - object — The default value for a cascading select custom field. - `cascadingOptionId` string — The ID of the default cascading option. - `contextId` string, required — The ID of the context. - `optionId` string, required — The ID of the default option. - `type` string, required - object — The default value for a multi-select custom field. - `contextId` string, required — The ID of the context. - `optionIds` string[], required — The list of IDs of the default options. - `type` string, required - object — The default value for a single select custom field. - `contextId` string, required — The ID of the context. - `optionId` string, required — The ID of the default option. - `type` string, required - object — Defaults for a User Picker (single) custom field. - `accountId` string, required — The ID of the default user. - `contextId` string, required — The ID of the context. - `type` string, required - `userFilter` UserFilter, required — Filter for a User Picker (single) custom field. - `enabled` boolean, required — Whether the filter is enabled. - `groups` string[] — User groups autocomplete suggestion users must belong to. If not provided, the default values are used. A maximum of 10 groups can be provided. - `roleIds` integer[] — Roles that autocomplete suggestion users must belong to. If not provided, the default values are used. A maximum of 10 roles can be provided. - object — The default value for a User Picker (multiple) custom field. - `accountIds` string[], required — The IDs of the default users. - `contextId` string, required — The ID of the context. - `type` string, required - object — The default value for a group picker custom field. - `contextId` string, required — The ID of the context. - `groupId` string, required — The ID of the the default group. - `type` string, required - object — The default value for a multiple group picker custom field. - `contextId` string, required — The ID of the context. - `groupIds` string[], required — The IDs of the default groups. - `type` string, required - object — The default value for a Date custom field. - `contextId` string, required — The ID of the context. - `date` string — The default date in ISO format. Ignored if `useCurrent` is true. - `type` string, required - `useCurrent` boolean — Whether to use the current date. - object — The default value for a date time custom field. - `contextId` string, required — The ID of the context. - `dateTime` string — The default date-time in ISO format. Ignored if `useCurrent` is true. - `type` string, required - `useCurrent` boolean — Whether to use the current date. - object — The default value for a URL custom field. - `contextId` string, required — The ID of the context. - `type` string, required - `url` string, required — The default URL. - object — The default value for a project custom field. - `contextId` string, required — The ID of the context. - `projectId` string, required — The ID of the default project. - `type` string, required - object — Default value for a float (number) custom field. - `contextId` string, required — The ID of the context. - `number` number, double, required — The default floating-point number. - `type` string, required - object — Default value for a labels custom field. - `contextId` string, required — The ID of the context. - `labels` string[], required — The default labels value. - `type` string, required - object — The default text for a text custom field. - `contextId` string, required — The ID of the context. - `text` string — The default text. The maximum length is 254 characters. - `type` string, required - object — The default text for a text area custom field. - `contextId` string, required — The ID of the context. - `text` string — The default text. The maximum length is 32767 characters. - `type` string, required - object — The default text for a read only custom field. - `contextId` string, required — The ID of the context. - `text` string — The default text. The maximum length is 255 characters. - `type` string, required - object — The default value for a version picker custom field. - `contextId` string, required — The ID of the context. - `type` string, required - `versionId` string, required — The ID of the default version. - `versionOrder` string — The order the pickable versions are displayed in. If not provided, the released-first order is used. Available version orders are `"releasedFirst"` and `"unreleasedFirst"`. - object — The default value for a multiple version picker custom field. - `contextId` string, required — The ID of the context. - `type` string, required - `versionIds` string[], required — The IDs of the default versions. - `versionOrder` string — The order the pickable versions are displayed in. If not provided, the released-first order is used. Available version orders are `"releasedFirst"` and `"unreleasedFirst"`. - object — The default text for a Forge string custom field. - `contextId` string, required — The ID of the context. - `text` string — The default text. The maximum length is 254 characters. - `type` string, required - object — The default text for a Forge collection of strings custom field. - `contextId` string, required — The ID of the context. - `type` string, required - `values` string[] — List of string values. The maximum length for a value is 254 characters. - object — The default value for a Forge object custom field. - `contextId` string, required — The ID of the context. - `object` object — The default JSON object. - `type` string, required - object — The default value for a Forge date time custom field. - `contextId` string, required — The ID of the context. - `dateTime` string — The default date-time in ISO format. Ignored if `useCurrent` is true. - `type` string, required - `useCurrent` boolean — Whether to use the current date. - object — The default value for a Forge group custom field. - `contextId` string, required — The ID of the context. - `groupId` string, required — The ID of the the default group. - `type` string, required - object — The default value for a Forge collection of groups custom field. - `contextId` string, required — The ID of the context. - `groupIds` string[], required — The IDs of the default groups. - `type` string, required - object — Default value for a Forge number custom field. - `contextId` string, required — The ID of the context. - `number` number, double, required — The default floating-point number. - `type` string, required - object — Defaults for a Forge user custom field. - `accountId` string, required — The ID of the default user. - `contextId` string, required — The ID of the context. - `type` string, required - `userFilter` UserFilter, required — Filter for a User Picker (single) custom field. - `enabled` boolean, required — Whether the filter is enabled. - `groups` string[] — User groups autocomplete suggestion users must belong to. If not provided, the default values are used. A maximum of 10 groups can be provided. - `roleIds` integer[] — Roles that autocomplete suggestion users must belong to. If not provided, the default values are used. A maximum of 10 roles can be provided. - object — Defaults for a Forge collection of users custom field. - `accountIds` string[], required — The IDs of the default users. - `contextId` string, required — The ID of the context. - `type` string, required ## Other responses - `400` — Returned if one or more of the field's contexts have different default values per issue type, which this endpoint cannot represent. Use `GET /rest/api/3/field/{fieldId}/context/defaultvalues` instead. - `401` — Returned if the authentication credentials are incorrect or missing. - `403` — Returned if the user does not have the required permissions. - `404` — Returned if the custom field is not found. --- [API](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api.md) · [All operations](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api/versions/a26541c2f8bd/schema)