CartRecommendationsList

This is for:

Developer

The CartRecommendationsList controller recommends other products that were frequently purchased together in previous similar carts.

Deprecated. The product-recommendation sub-package is deprecated. Use the commerce sub-package instead.

Methods

refresh

Gets new recommendations based on the current SKUs.

setSkus

Sets the SKUs in the cart.

Parameters

  • skus: string[]

    The SKUs of the products in the cart.

subscribe

Adds a callback that’s invoked on state change.

Parameters

  • listener: () => void

    A callback that’s invoked on state change.

Returns Unsubscribe: A function to remove the listener.

Attributes

state

The state of the CartRecommendationsList controller.

Properties

  • error: ErrorPayload | null

    An error returned by the Coveo platform when executing a cart recommendation request, or null if none is present.

  • isLoading: boolean

    Whether a cart recommendation request is currently being executed against the Coveo platform.

  • maxNumberOfRecommendations: number

    The maximum number of recommendations.

  • recommendations: ProductRecommendation[]

    The products recommended by the Coveo platform.

  • skus: string[]

    The SKUs of the products in the cart.

Initialize

buildCartRecommendationsList

Creates a CartRecommendationsList controller instance.

Deprecated. The product-recommendation sub-package is deprecated. Use the commerce sub-package instead.

Parameters

  • engine: ProductRecommendationEngine

    The headless engine.

  • props: CartRecommendationsListProps

    The configurable CartRecommendationsList properties.

Returns CartRecommendationsList

CartRecommendationsListProps

The configurable CartRecommendationsList properties.

Properties

CartRecommendationsListOptions

Properties

  • additionalFields?: string[]

    Additional fields to fetch in the results.

  • maxNumberOfRecommendations?: number

    The maximum number of recommendations, from 1 to 50.

    Default: 5

  • skus?: string[]

    The SKUs of the products in the cart.

ProductRecommendation

Properties

  • additionalFields: Record<string, unknown>

    An object containing the requested additional fields for the product.

  • childResults: ProductRecommendation[]

    A list of child product recommendations in a product grouping context.

  • clickUri: string

    A direct link to the product in URL format.

  • documentUri: string

    This parameter is no longer used by the Coveo Usage Analytics service.

  • documentUriHash: string

    Document UriHash in the index.

    Note: This parameter is deprecated. Use the permanentid to identify items in the index.

  • permanentid: string

    The SKU of the product.

  • totalNumberOfChildResults: number

    The total number of items in the group.

  • ec_brand?: string

    The brand of the product.

    From the ec_brand field.

  • ec_category?: string

    The category of the product (e.g., "Electronics", "Electronics|Televisions", or "Electronics|Televisions|4K Televisions").

    From the ec_category field.

  • ec_images?: string[]

    Additional product images in URL format.

    From the ec_images field.

  • ec_in_stock?: boolean

    The availability of the product (i.e., whether it’s in stock).

    From the ec_in_stock field.

  • ec_item_group_id?: string

    The id used for Product Grouping.

    From the ec_item_group_id field.

  • ec_name?: string

    The name of the product.

    From the ec_name field.

  • ec_price?: number

    The base price of the product or variant.

    From the ec_price field.

  • ec_promo_price?: number

    The promotional price of the product or variant.

    From the ec_promo_price field.

  • ec_rating?: number

    A rating system. Ratings range from 0-10.

    From the ec_rating field.

  • ec_shortdesc?: string

    A short description of the product.

    From the ec_shortdesc field.

  • ec_thumbnails?: string[]

    Product images in URL format.

    From the ec_thumbnails field.

Unsubscribe

Call signatures

  • (): void;