# type CustomField (v202508)

**Service** **CustomFieldService** **Dependencies** [CustomFieldPage](https://developers.google.com/ad-manager/api/reference/v202508/CustomFieldService.CustomFieldPage) [createCustomFields()](https://developers.google.com/ad-manager/api/reference/v202508/CustomFieldService#createCustomFields) [updateCustomFields()](https://developers.google.com/ad-manager/api/reference/v202508/CustomFieldService#updateCustomFields) ▼ **CustomField** **Inheritance** **CustomField** ▼ [DropDownCustomField](https://developers.google.com/ad-manager/api/reference/v202508/CustomFieldService.DropDownCustomField)

An additional, user-created field on an entity.

*** ** * ** ***

Namespace
:
    `https://www.google.com/apis/ads/publisher/v202508`

| ## Field ||
|---|---|
| ### `id` | ` xsd:long` Unique ID of the `CustomField`. This value is readonly and is assigned by Google. |
| ### `name` | ` xsd:string` Name of the `CustomField`. This is value is required to create a custom field. The max length is 127 characters. |
| ### `description` | ` xsd:string` A description of the custom field. This value is optional. The maximum length is 511 characters |
| ### `isActive` | ` xsd:boolean` Specifies whether or not the custom fields is active. This attribute is read-only. |
| ### `entityType` | ` https://developers.google.com/ad-manager/api/reference/v202508/CustomFieldService.CustomFieldEntityType ` The type of entity that this custom field is associated with. This attribute is read-only if there exists a [CustomFieldValue](https://developers.google.com/ad-manager/api/reference/v202508/CreativeService.CustomFieldValue) for this field. *** ** * ** *** **Enumerations** `LINE_ITEM` :   Represents the [LineItem](https://developers.google.com/ad-manager/api/reference/v202508/ForecastService.LineItem) type. `ORDER` :   Represents the [Order](https://developers.google.com/ad-manager/api/reference/v202508/OrderService.Order) type. `CREATIVE` :   Represents the [Creative](https://developers.google.com/ad-manager/api/reference/v202508/CreativeService.Creative) type. `PROPOSAL` :   Represents the [Proposal](https://developers.google.com/ad-manager/api/reference/v202508/ProposalService.Proposal) type. `PROPOSAL_LINE_ITEM` :   Represents the [ProposalLineItem](https://developers.google.com/ad-manager/api/reference/v202508/ForecastService.ProposalLineItem) type. `UNKNOWN` :   The value returned if the actual value is not exposed by the requested API version. <br /> |
| ### `dataType` | ` https://developers.google.com/ad-manager/api/reference/v202508/CustomFieldService.CustomFieldDataType ` The type of data this custom field contains. This attribute is read-only if there exists a [CustomFieldValue](https://developers.google.com/ad-manager/api/reference/v202508/CreativeService.CustomFieldValue) for this field. *** ** * ** *** **Enumerations** `STRING` :   A string field. The max length is 255 characters. `NUMBER` :   A number field. `TOGGLE` :   A boolean field. Values may be "true", "false", or empty. `DROP_DOWN` :   A drop-down field. Values may only be the ids of [CustomFieldOption](https://developers.google.com/ad-manager/api/reference/v202508/CustomFieldService.CustomFieldOption) objects. `UNKNOWN` :   The value returned if the actual value is not exposed by the requested API version. <br /> |
| ### `visibility` | ` https://developers.google.com/ad-manager/api/reference/v202508/CustomFieldService.CustomFieldVisibility ` How visible/accessible this field is in the UI. *** ** * ** *** **Enumerations** `UNKNOWN` :   The value returned if the actual value is not exposed by the requested API version. `API_ONLY` :   Only visible through the API. `READ_ONLY` :   Visible in the UI, but only editable through the API `FULL` :   Visible and editable both in the API and the UI. <br /> |