# CustomAttributeSchema

Object

Definition of a custom attribute field. Use options (when present) to map IDs to display names.

## Fields

| Name | Type | Description |
| --- | --- | --- |
| `aiGenerated` | `Boolean!` | True when this attribute's value is produced by an AI Filter. For AI-generated attributes, an item's `aiFilterReasons` entry with the matching `key` carries the model's explanation for the value. |
| `key` | `String!` | Key used in the customAttributes object. |
| `name` | `String!` | Human-readable display name. |
| `options` | [`[CustomAttributeOption!]`](/api/v2/docs/types/custom-attribute-option) | Available options for select-type attributes. When present, customAttributes values are option IDs that map to these options. When null, values are stored directly (text, numbers, dates, etc.). |
| `type` | [`CustomAttributeType!`](/api/v2/docs/types/custom-attribute-type) | Custom attribute field type. |