Add to Wishlist

Event Serialization

always

Business Use Case

["1️⃣ The Merchandising Manager reviews wishlist additions by item_category and item_id every Monday against add_to_cart for the same SKUs, and reprices or repositions products that are saved heavily but rarely carted before the next promotional calendar is locked.","2️⃣ The CRM and Lifecycle Marketing team triggers back-in-stock and price-drop emails for signed-in shoppers whose saved SKU changes availability or falls below the saved price, and suppresses the message once a purchase of that item_id is recorded.","3️⃣ The Inventory Planning team adds wishlist volume for out-of-stock and pre-launch SKUs to the weekly demand review and raises reorder quantities for items whose saved count exceeds the forecast before a restock is committed.","4️⃣ The Product team compares wishlist additions by add_source and item_list_name after any change to the heart icon, quick view or recommendation carousel, and rolls back a release when saves from the affected surface drop against the prior four weeks."]

Business Criticality

Medium

Journey / Navigation Area

Discovery

Owning Function

Merchandising

Calculation Notes

["1️⃣ Fires only after the wishlist service confirms the item was persisted (HTTP 2xx or the equivalent success callback), never on the heart or save click alone. When a guest is sent to sign in first, the event fires once the login completes and the pending item is written to the list; the abandoned sign-in prompt produces no event, and the login event carries that friction separately.","2️⃣ Serialization is always: one event per confirmed save, deduplicated on event_id so that retries, double taps and optimistic-UI replays do not count twice. Un-toggling the heart icon must not fire add_to_wishlist again, and saving a SKU that is already on the same list is a no-op that emits nothing.","3️⃣ Required parameters are currency, value and items; items holds exactly one element with item_id, item_name, item_brand, item_category, item_variant, price and quantity (normally 1). value equals price × quantity at the current selling price after item-level discounts, in the same currency as the purchase event, so that saved value can later be compared with purchased value.","4️⃣ Optional context parameters are item_list_id and item_list_name, which carry through the list that led to the save (search results, category grid, recommendation carousel) using the same identifiers as product-list-view and product-list-click, plus page_type and add_source (plp, pdp, quick_view, cart). Keep the vocabulary identical to add_to_cart so wishlist and cart intent can be read side by side by list and by page.","5️⃣ Save for later from the cart is the same unified event with add_source = cart, paired with the remove_from_cart event for the same SKU; it must not be modelled as a separate custom event. Moving an item from the wishlist into the cart fires add_to_cart with add_source = wishlist and does not remove the original add_to_wishlist from history.","6️⃣ Consent and PII: the event is collected under analytics_storage and is suppressed or sent cookieless when that consent is denied. Wishlist names typed by the shopper (for example gift lists naming a recipient), email addresses and shipping details are never passed as parameters; user identity travels only as the pseudonymous user_id already set on the login event.","7️⃣ Common instrumentation mistakes: firing on the click before the server response, sending an empty or multi-item items array, omitting currency so value is dropped from monetary reports, sending the parent product id instead of the variant SKU the shopper selected, and double counting because both the heart component and the page template push the event."]

Data Mappings

{
  "event": [
    {
      "eventInfo": {
        "eventName": "add_to_wishlist",
        "eventAction": "Add to Wishlist",
        "eventID": "evt_wishlist_20260921173045"
      },
      "category": {
        "primaryCategory": "Product Discovery & Merchandising"
      },
      "attributes": {
        "currency": "USD",
        "value": 89,
        "item_list_id": "search_results",
        "item_list_name": "search_results",
        "add_source": "plp",
        "page_type": "category"
      }
    }
  ],
  "product": [
    {
      "productInfo": {
        "productID": "SKU-48213",
        "productName": "Classic Leather Tote - Tan",
        "manufacturer": "Aurelia"
      },
      "category": {
        "primaryCategory": "Handbags",
        "productVariant": "Tan"
      },
      "price": {
        "basePrice": 89
      },
      "quantity": 1
    }
  ]
}

{
  "event": "add_to_wishlist",
  "event_id": "evt_wishlist_20260921173045",
  "currency": "USD",
  "value": 89,
  "items": [
    {
      "item_id": "SKU-48213",
      "item_name": "Classic Leather Tote - Tan",
      "item_brand": "Aurelia",
      "item_category": "Handbags",
      "item_variant": "Tan",
      "price": 89,
      "quantity": 1
    }
  ],
  "item_list_id": "search_results",
  "item_list_name": "search_results",
  "add_source": "plp",
  "page_type": "category"
}

{
  "event": "addToWishlist",
  "eventInfo": {
    "eventId": "evt_wishlist_20260921173045"
  },
  "productListItems": [
    {
      "SKU": "SKU-48213",
      "name": "Classic Leather Tote - Tan",
      "brand": "Aurelia",
      "category": "Handbags",
      "variant": "Tan",
      "priceTotal": 89,
      "quantity": 1,
      "currencyCode": "USD"
    }
  ],
  "listMetadata": {
    "listId": "search_results",
    "listName": "search_results",
    "addSource": "plp",
    "pageType": "category"
  }
}

{
  "eventType": "commerce.saveForLaters",
  "commerce": {
    "saveForLaters": {
      "value": 1
    }
  },
  "productListItems": [
    {
      "SKU": "SKU-48213",
      "name": "Classic Leather Tote - Tan",
      "brand": "Aurelia",
      "category": "Handbags",
      "variant": "Tan",
      "priceTotal": 89,
      "quantity": 1,
      "currencyCode": "USD"
    }
  ],
  "_experience": {
    "analytics": {
      "customDimensions": {
        "eVars": {
          "eVar1": "search_results",
          "eVar2": "search_results",
          "eVar3": "plp",
          "eVar4": "category"
        }
      }
    }
  },
  "eventMergeId": "evt_wishlist_20260921173045"
}

Source Data

Dependencies

Prerequisite: List the dependencies required for this Event

Report Attributes

Segment Eligibility

Governance

Dimensions

Derived Entities

GitHub

Community Discussion