Home > widget-integration > CartService > validateAddToCartItem

CartService.validateAddToCartItem() method

Validate cart item before adding to cart Override to implement shop-specific validation rules

Common customization scenarios: - Enforce minimum/maximum quantities - Check inventory availability - Validate custom properties - Apply business rules (subscription eligibility, etc.)

Signature:

protected validateAddToCartItem(item: AddToCartItem): Promise<boolean>;

Parameters

Returns:

Promise<boolean>

Promise resolving to true if item passes validation, false otherwise

Example

Minimum quantity validation

protected async validateAddToCartItem(item: AddToCartItem): Promise<boolean> {
  const baseValid = await super.validateAddToCartItem(item);
  if (!baseValid) return false;

  const minQty = this.appService.getConfig().minQuantity || 1;
  if (item.quantity && item.quantity < minQty) {
    this.showError(`Minimum quantity is ${minQty}`);
    return false;
  }

  return true;
}