diff --git a/api-specs/api/types/product-type/AttributeDefinition.raml b/api-specs/api/types/product-type/AttributeDefinition.raml index 51425ba70..0f0756c29 100644 --- a/api-specs/api/types/product-type/AttributeDefinition.raml +++ b/api-specs/api/types/product-type/AttributeDefinition.raml @@ -36,7 +36,7 @@ properties: isSearchable: type: boolean description: |- - If `true`, the Attribute's values are available for the [Product Projections Search API](/../api/projects/products-search) for use in full-text search queries, filters, and facets. + If `true`, the Attribute's values are available in the [Product Projection Search](/../api/projects/products-search) or the [Product Search](/../api/projects/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). diff --git a/api-specs/api/types/product-type/AttributeDefinitionDraft.raml b/api-specs/api/types/product-type/AttributeDefinitionDraft.raml index 075b41cee..df5c6df59 100644 --- a/api-specs/api/types/product-type/AttributeDefinitionDraft.raml +++ b/api-specs/api/types/product-type/AttributeDefinitionDraft.raml @@ -17,7 +17,7 @@ properties: minLength: 2 maxLength: 256 description: |- - User-defined name of the Attribute that is unique with the [Project](ctp:api:type:Project). + User-defined name of the Attribute that is unique to the [Project](ctp:api:type:Project). When using the same `name` for an Attribute in multiple ProductTypes, all fields of the AttributeDefinition of this Attribute must be the same across the ProductTypes, else an [AttributeDefinitionAlreadyExists](ctp:api:type:AttributeDefinitionAlreadyExistsError) error is returned. An exception to this are the values of an `enum` or `lenum` Type and sets thereof. @@ -45,7 +45,7 @@ properties: isSearchable?: type: boolean description: |- - Set to `true` if the Attribute's values should be available in the [Product Projections Search API](/../api/projects/products-search) and can be used in full-text search queries, filters, and facets. + Set to `true` if the Attribute's values should be available in the [Product Projection Search](/../api/projects/products-search) or the [Product Search](/../api/projects/product-search) API and can be used 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 and Product update. diff --git a/api-specs/api/types/product-type/updates/ProductTypeChangeAttributeNameAction.raml b/api-specs/api/types/product-type/updates/ProductTypeChangeAttributeNameAction.raml index 927de610c..694aa5c93 100644 --- a/api-specs/api/types/product-type/updates/ProductTypeChangeAttributeNameAction.raml +++ b/api-specs/api/types/product-type/updates/ProductTypeChangeAttributeNameAction.raml @@ -21,7 +21,7 @@ properties: minLength: 2 maxLength: 256 description: |- - New user-defined name of the Attribute that is unique with the [Project](ctp:api:type:Project). + New user-defined name of the Attribute that is unique to the [Project](ctp:api:type:Project). When using the same `name` for an Attribute in two or more ProductTypes, all fields of the AttributeDefinition of this Attribute must be the same across the ProductTypes. If not, an [AttributeDefinitionAlreadyExists](ctp:api:type:AttributeDefinitionAlreadyExistsError) error is returned. An exception to this are the values of an `enum` or `lenum` type and sets thereof.