Interface AttributeDefinition

Describes a Product Attribute and allows you to define meta-information associated with the Attribute (like whether it should be searchable, or its constraints).

interface AttributeDefinition {
    attributeConstraint: string;
    inputHint: string;
    inputTip?: LocalizedString;
    isRequired: boolean;
    isSearchable: boolean;
    label: LocalizedString;
    name: string;
    type: AttributeType;
}

Properties

attributeConstraint inputHint inputTip? isRequired isSearchable label name type

Properties

ReadonlyattributeConstraint

attributeConstraint: string

Specifies how Attributes are validated across all variants of a Product.

ReadonlyinputHint

inputHint: string

Provides a visual representation directive for values of this Attribute (only relevant for AttributeTextType and AttributeLocalizableTextType).

Optional ReadonlyinputTip

inputTip?: LocalizedString

Provides additional Attribute information to aid content managers configure Product details.

ReadonlyisRequired

isRequired: boolean

If true, the Attribute must have a value on a ProductVariant.

ReadonlyisSearchable

isSearchable: boolean

If true, the Attribute's values are available in the Product Projection Search or the Product Search API for use in full-text search queries, filters, and facets.

Which exact features are available with this flag depends on the specific [AttributeType](ctp:api:type:AttributeType).
The maximum size of a searchable field is **restricted** by the [Field content size limit](/../api/limits#field-content-size).
This constraint is enforced at both [Product creation](ctp:api:endpoint:/{projectKey}/products:POST) and [Product update](/../api/projects/products#update-product).
If the length of the input exceeds the maximum size, an [InvalidField](ctp:api:type:InvalidFieldError) error is returned.

Readonlylabel

label: LocalizedString

Human-readable label for the Attribute.

Readonlyname

name: string

User-defined name of the Attribute that is unique within the Project.

Readonlytype

type: AttributeType

Describes the Type of the Attribute.

Settings

Member Visibility

On This Page

Properties