📘

Note

All events include Session Properties, Device Properties, App Properties, and Shopify Properties that are present on the Event Object. For more information, refer to the Common Event Object & Metadata document.

Event Properties, however, are unique to every event and are outlined in this page.

The Cart Updated event fires when a customer makes an update to the quantity or variant of items already in the cart, adds a new item to their cart, or completely removes an item from their cart.

The Event Properties unique to the Cart Updated event include:

"event_properties": {
    "event_id": "55DC2222-2B74-4673-B089-F4CFD9A1CC86",
    "quantity_updated": "1",
    "variant_options_updated": "{\"Color\":\"Black\",\"Size\":\"One Size\"}",
    "product_id": "6642229670984",
    "variant_name": "Black / One Size",
    "variant_id": "39715228301896",
    "cart_id": null,
    "product_title": "Towel - Black",
    "product_type": "Misc Accessories",
    "variant_price": "20.0",
    "collection_id": null,
    "collection_title": null,
    "multi_currency_code": "AUD",
    "product_tags_list": ["activity-explore"],
    "cart_total_price": "60.0",
    "cart_total_items": "3",
    "cart_total_items_list": ["Towel - Black", "Watch", "Swimsuit"],
    "cart_total_product_id_list": ["6643429670984", "44343429670984", "9983429670984"],
    "product_badge_titles_list": [""],
    "product_badge_ids_list": [""],
    "product_badge_positioning_list": [],
    "update_type": "quantity_added",
    "cart_update_source": "cart_increase_quantity"
  }

event_id String : The unique identifier of the session associated with the event. This event will also exist on the Event object level as well


quantity_updated Integer : The quantity of the product that was added or removed from the cart


variant_options_updated String : The type of update the user made to the product variants stored as a JSON string indicating the variant type and selection made. The format would follow something similar to {“color”:”red”,”size”:”small”}


product_id String : A unique identifier for the product. Each id is unique across the Shopify system. No two products will have the same id


variant_name String : The text title of the variant selected on the product added to cart


variant_id String : The unique identifier for the variant selected on the product updated in the cart. Each id is unique across the Shopify system. No two variants will have the same id


cart_id String : The Shopify identifier for the current cart state. This identifier changes when a certain cart state expires


variant_title String : The text title of the variant selected on the product updated in the cart


product_title String : The text title of the product provided from Shopify


product_type String : The type of product designated in Shopify


variant_price Float : The price of the variant selected of the product updated in the cart


collection_id String : A unique identifier for the collection. Each id is unique across the Shopify system. No two collections will have the same id. The id is only represented if a collection is applicable to the product that is viewed


collection_title String : The title of the associated collection for the product. The collection is only available if applicable


multi_currency_code String : The current currency the user has selected in the app


cart_total_price Float : The total amount of the cart after cart update in the merchant’s currency


cart_total_items Integer : The total count of current items in the cart after the cart i[dated


cart_total_items_list List : A list of all of the product titles (represented as strings) in the cart after the cart updated


cart_total_product_ids_list List : A list of all of the product id's (represented as strings) in the cart after the cart updated


product_badge_titles_list List : A list of the titles of all product badges applied to the viewed product. These will only be applicable if the Tapcart Merchant has product badges enabled


product_badge_ids_list List : A list of the unique identifiers of product badges applied to the viewed product. These will only be applicable if the Tapcart Merchant has product badges enabled


product_badge_positioning_list List : A list of the relevant positioning and order of the product badges applied to the viewed product. These will only be applicable if the Tapcart Merchant has product badges enabled


update_type String : The type of action a user takes within the cart to update it. The various actions represent updates to the cart by adding or removing products or variants

Note: The various types can be referenced in the Note: Event Sources and types page


cart_update_source String : The source in which a product gets added to or removed from cart. This can mean a product being added came directly from the product page, from the wishlist, a collection, the cart itself, or even by removing an item and reducing the quantity or pressing the trash can.

Note: The various types can be referenced in the Note: Event Sources and types page