> For the complete documentation index, see [llms.txt](https://docs.chord.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chord.co/collect-data/tracking-plan.md).

# Tracking plan

The tracking plan is Chord's recommended set of tracking events for commerce sites, with the properties each event expects. Use it when you set up browser and server events, on [Shopify](/collect-data/shopify.md) or [any other platform](/collect-data/everyone-else.md).

Each event has its own page, linked from the tables below and listed under **Tracking plan** in the navigation.

{% hint style="info" %}
Set `debug: true` in your `@chordcommerce/analytics` configuration during development to validate events against the tracking plan. It logs warnings for missing or incorrect properties.
{% endhint %}

## Core Chord events

These events are required for Chord to model behavioral data from your website front-end. These are the minimum set of events that should be implemented.

| **Event name**                                                          | **Description**                                              | **Suggested source** | **Relevant CDP destinations**                                                                                                  |
| ----------------------------------------------------------------------- | ------------------------------------------------------------ | -------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| [**Cart Viewed**](/collect-data/tracking-plan/cart-viewed.md)           | User viewed their shopping cart.                             | Website front-end    | *GA4*                                                                                                                          |
| [**Checkout Started**](/collect-data/tracking-plan/checkout-started.md) | User initiated the order process (a transaction is created). | Website front-end    | *GA4, Pinterest, Snap, TikTok, Triple Whale, Twitter Ads*                                                                      |
| [**Order Completed**](/collect-data/tracking-plan/order-completed.md)   | User completed the order.                                    | Website front-end    | *Algolia, Attentive, Braze, Facebook, GA4, Google Ads, Klaviyo, Northbeam, Pinterest, Snap, TikTok, Triple Whale, Twitter Ads* |
| [**Product Added**](/collect-data/tracking-plan/product-added.md)       | User added a product to their shopping cart.                 | Website front-end    | *Algolia, Attentive, Facebook, GA4, Klaviyo, Pinterest, Snap, TikTok, Triple Whale, Twitter Ads*                               |

## Basic conversion journey

These events enable Chord to model behavioral data from your website front-end, and provide core events for the user conversion journey you can use in connected integrations.

| **Event name**                                                                    | **Description**                                                                                                                     | **Suggested source**         | **Relevant CDP destinations**                                                                                                      |
| --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| [**Cart Viewed**](/collect-data/tracking-plan/cart-viewed.md)                     | User viewed their shopping cart.                                                                                                    | Website front-end            | *GA4*                                                                                                                              |
| [**Checkout Started**](/collect-data/tracking-plan/checkout-started.md)           | User initiated the order process (a transaction is created).                                                                        | Website front-end            | *GA4, Pinterest, Snap, TikTok, Triple Whale, Twitter Ads*                                                                          |
| Consent Preferences Updated                                                       | User updates their data privacy consent options. This event runs under the hood from within the `@chordcommerce/analytics` package. | Website front-end            | *All*                                                                                                                              |
| [**Coupon Applied**](/collect-data/tracking-plan/coupon-applied.md)               | Coupon was applied to a user's shopping cart.                                                                                       | Website front-end            | *GA4*                                                                                                                              |
| [**Coupon Denied**](/collect-data/tracking-plan/coupon-denied.md)                 | Coupon was not applied to a user's shopping cart.                                                                                   | Website front-end            | *Amplitude, Attentive, Axon, Bing Ads, Braze, Delighted, GTM, Iterable, Klaviyo, Ninetailed, PostHog*                              |
| [**Coupon Entered**](/collect-data/tracking-plan/coupon-entered.md)               | User entered a coupon on their shopping cart.                                                                                       | Website front-end            | *Amplitude, Attentive, Axon, Bing Ads, Braze, Delighted, GTM, Iterable, Klaviyo, Ninetailed, PostHog*                              |
| [**Coupon Removed**](/collect-data/tracking-plan/coupon-removed.md)               | User removed a coupon from their shopping cart.                                                                                     | Website front-end            | *Amplitude, Attentive, Axon, Bing Ads, Braze, Delighted, GTM, Iterable, Klaviyo, Ninetailed, PostHog*                              |
| [**Email Captured**](/collect-data/tracking-plan/email-captured.md)               | User entered an email address in a form on the website.                                                                             | Website front-end            | *Amplitude, Attentive, Axon, Bing Ads, Braze, Delighted, GTM, Iterable, Klaviyo, Ninetailed, Pinterest Tag, PostHog, TikTok Pixel* |
| [**Order Completed**](/collect-data/tracking-plan/order-completed.md)             | User completed the order.                                                                                                           | Website front-end and server | *Algolia, Attentive, Braze, Facebook, GA4, Google Ads, Klaviyo, Northbeam, Pinterest, Snap, TikTok, Triple Whale, Twitter Ads*     |
| [**Order Refunded**](/collect-data/tracking-plan/order-refunded.md)               | Order was refunded.                                                                                                                 | Server                       | *Braze (Cloud), GA4, Northbeam*                                                                                                    |
| [**Product Added**](/collect-data/tracking-plan/product-added.md)                 | User added a product to their shopping cart.                                                                                        | Website front-end            | *Algolia, Attentive, Facebook, GA4, Klaviyo, Pinterest, Snap, TikTok, Triple Whale, Twitter Ads*                                   |
| [**Product Clicked**](/collect-data/tracking-plan/product-clicked.md)             | User clicked on a product.                                                                                                          | Website front-end            | *Amplitude, Attentive, Axon, Bing Ads, Braze, Delighted, GTM, Iterable, Klaviyo, Ninetailed, Pinterest Tag, PostHog, TikTok Pixel* |
| [**Product List Filtered**](/collect-data/tracking-plan/product-list-filtered.md) | User filtered a product list or category.                                                                                           | Website front-end            | *Amplitude, Attentive, Axon, Bing Ads, Braze, Delighted, GTM, Iterable, Klaviyo, Ninetailed, PostHog*                              |
| [**Product List Viewed**](/collect-data/tracking-plan/product-list-viewed.md)     | User viewed a product list or category.                                                                                             | Website front-end            | *GA4, Snap CAPI*                                                                                                                   |
| [**Product Removed**](/collect-data/tracking-plan/product-removed.md)             | User removed a product from their shopping cart.                                                                                    | Website front-end            | *GA4*                                                                                                                              |
| [**Product Viewed**](/collect-data/tracking-plan/product-viewed.md)               | User viewed a product.                                                                                                              | Website front-end            | *Facebook, GA4, Pinterest, Snap, TikTok, Triple Whale*                                                                             |
| [**Products Searched**](/collect-data/tracking-plan/products-searched.md)         | User searched for products.                                                                                                         | Website front-end            | *GA4, Pinterest CAPI, Snap, TikTok*                                                                                                |
| [**Signed In**](/collect-data/tracking-plan/signed-in.md)                         | User signed into their account.                                                                                                     | Website front-end            | *Amplitude, Attentive, Axon, Bing Ads, Braze, Delighted, GTM, Iterable, Klaviyo, Ninetailed, PostHog*                              |
| [**Signed Out**](/collect-data/tracking-plan/signed-out.md)                       | User signed out from their account.                                                                                                 | Website front-end            | *Amplitude, Attentive, Axon, Bing Ads, Braze, Delighted, GTM, Iterable, Klaviyo, Ninetailed, PostHog*                              |
| [**Signed Up**](/collect-data/tracking-plan/signed-up.md)                         | User signed up for an account.                                                                                                      | Website front-end            | *Facebook, GA4, Pinterest CAPI, Snap, TikTok*                                                                                      |

## Expanded conversion journey

These events, combined with the basic conversion journey above, provide additional details about the conversion journey you can use in connected integrations.

| **Event name**                                                                                      | **Description**                            | **Suggested source** | **Relevant CDP destinations**                                                                         |
| --------------------------------------------------------------------------------------------------- | ------------------------------------------ | -------------------- | ----------------------------------------------------------------------------------------------------- |
| [**Cart Shared**](/collect-data/tracking-plan/cart-shared.md)                                       | Shared the cart with one or more friends.  | Website front-end    | *Amplitude, Attentive, Axon, Bing Ads, Braze, Delighted, GTM, Iterable, Klaviyo, Ninetailed, PostHog* |
| [**Product Added to Wishlist**](/collect-data/tracking-plan/product-added-to-wishlist.md)           | User added a product to the wish list.     | Website front-end    | *Facebook, GA4, Pinterest CAPI, Snap, TikTok*                                                         |
| [**Product Removed from Wishlist**](/collect-data/tracking-plan/product-removed-from-wishlist.md)   | User removed a product from the wish list. | Website front-end    | *Amplitude, Attentive, Axon, Bing Ads, Braze, Delighted, GTM, Iterable, Klaviyo, Ninetailed, PostHog* |
| [**Product Reviewed**](/collect-data/tracking-plan/product-reviewed.md)                             | User reviewed a product.                   | Website front-end    | *Amplitude, Attentive, Axon, Bing Ads, Braze, Delighted, GTM, Iterable, Klaviyo, Ninetailed, PostHog* |
| [**Product Shared**](/collect-data/tracking-plan/product-shared.md)                                 | Shared a product with one or more friends. | Website front-end    | *Amplitude, Attentive, Axon, Bing Ads, Braze, Delighted, GTM, Iterable, Klaviyo, Ninetailed, PostHog* |
| [**Promotion Clicked**](/collect-data/tracking-plan/promotion-clicked.md)                           | User clicked on promotion.                 | Website front-end    | *GA4, Snap CAPI, TikTok*                                                                              |
| [**Promotion Viewed**](/collect-data/tracking-plan/promotion-viewed.md)                             | User viewed promotion.                     | Website front-end    | *GA4, Snap CAPI*                                                                                      |
| [**Wishlist Product Added to Cart**](/collect-data/tracking-plan/wishlist-product-added-to-cart.md) | User added a wishlist product to the cart. | Website front-end    | *Amplitude, Attentive, Axon, Bing Ads, Braze, Delighted, GTM, Iterable, Klaviyo, Ninetailed, PostHog* |

## Other events

| **Event name**                                                                                  | **Description**                                                                                                                                                             | **Suggested source**      |
| ----------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
| [**Cart Abandoned**](/collect-data/tracking-plan/cart-abandoned.md)                             | User viewed their shopping cart without completing an order.                                                                                                                | Website front-end         |
| [**Checkout Abandoned**](/collect-data/tracking-plan/checkout-abandoned.md)                     | User abandoned the checkout process.                                                                                                                                        | Server                    |
| [**Checkout Step Completed**](/collect-data/tracking-plan/checkout-step-completed.md)           | User completed a checkout step.                                                                                                                                             | Website front-end         |
| [**Checkout Step Viewed**](/collect-data/tracking-plan/checkout-step-viewed.md)                 | User viewed a checkout step.                                                                                                                                                | Website front-end         |
| [**Collection Clicked**](/collect-data/tracking-plan/collection-clicked.md)                     | User clicked on a collection.                                                                                                                                               | Website front-end         |
| [**Gift Card Applied**](/collect-data/tracking-plan/gift-card-applied.md)                       | Gift card was applied on a user's shopping cart or order.                                                                                                                   | Website front-end         |
| [**Gift Card Denied**](/collect-data/tracking-plan/gift-card-denied.md)                         | Gift card was denied from a user's shopping cart or order.                                                                                                                  | Website front-end         |
| [**Gift Card Entered**](/collect-data/tracking-plan/gift-card-entered.md)                       | User entered a gift card on a cart or order.                                                                                                                                | Website front-end         |
| [**Gift Card Removed**](/collect-data/tracking-plan/gift-card-removed.md)                       | User removed a gift card from a cart or order.                                                                                                                              | Website front-end         |
| [**Item Restocked**](/collect-data/tracking-plan/item-restocked.md)                             | Notify waitlist that product variant is back in stock.                                                                                                                      | Server                    |
| [**Login Started**](/collect-data/tracking-plan/login-started.md)                               | User submits the login form.                                                                                                                                                | Website front-end         |
| [**Navigation Clicked**](/collect-data/tracking-plan/navigation-clicked.md)                     | User clicked on a navigation link.                                                                                                                                          | Website front-end         |
| [**Order Cancelled**](/collect-data/tracking-plan/order-cancelled.md)                           | User cancelled the order.                                                                                                                                                   | Server                    |
| [**Password Reset Completed**](/collect-data/tracking-plan/password-reset-completed.md)         | User completed the password reset process.                                                                                                                                  | Website front-end         |
| [**Password Reset Started**](/collect-data/tracking-plan/password-reset-started.md)             | User initiated the password reset process.                                                                                                                                  | Website front-end         |
| [**Payment Info Entered**](/collect-data/tracking-plan/payment-info-entered.md)                 | User added payment information.                                                                                                                                             | Server, website front-end |
| [**Product Details Clicked**](/collect-data/tracking-plan/product-details-clicked.md)           | User clicked on a product details component or menu.                                                                                                                        | Website front-end         |
| [**Products Abandoned**](/collect-data/tracking-plan/products-abandoned.md)                     | User viewed products without completing an order.                                                                                                                           | Website front-end         |
| [**Shipment Delivered**](/collect-data/tracking-plan/shipment-delivered.md)                     | Order shipment has been delivered.                                                                                                                                          | Server                    |
| [**Shipment Shipped**](/collect-data/tracking-plan/shipment-shipped.md)                         | Order shipment has been shipped.                                                                                                                                            | Server                    |
| [**Stock Request Created**](/collect-data/tracking-plan/stock-request-created.md)               | A new stock request has been created.                                                                                                                                       | Website front-end         |
| [**Subscription Address Updated**](/collect-data/tracking-plan/subscription-address-updated.md) | Address associated with subscription is updated.                                                                                                                            | Website front-end         |
| [**Subscription Auto Renewed**](/collect-data/tracking-plan/subscription-auto-renewed.md)       | Subscription automatic renewal payment has failed.                                                                                                                          | Server                    |
| [**Subscription Cancelled**](/collect-data/tracking-plan/subscription-cancelled.md)             | Subscription cancelled by the user, or failure to auto-renew.                                                                                                               | Website front-end         |
| [**Subscription Created**](/collect-data/tracking-plan/subscription-created.md)                 | Subscription has been purchased.                                                                                                                                            | Server                    |
| [**Subscription Expired**](/collect-data/tracking-plan/subscription-expired.md)                 | Subscription has expired.                                                                                                                                                   | Server                    |
| [**Subscription Order Skipped**](/collect-data/tracking-plan/subscription-order-skipped.md)     | The upcoming order in a subscription is skipped, making the next order.                                                                                                     | Website front-end         |
| [**Subscription Paused**](/collect-data/tracking-plan/subscription-paused.md)                   | The subscription is paused and the date of processing is indicated on the `actionable_date` property. A `null` date indicates that the subscription is paused indefinitely. | Website front-end         |
| [**Subscription Payment Failed**](/collect-data/tracking-plan/subscription-payment-failed.md)   | Subscription automatic renewal payment has failed.                                                                                                                          | Server                    |
| [**Subscription Reminder Sent**](/collect-data/tracking-plan/subscription-reminder-sent.md)     | Subscription reminder email of upcoming renewal has been sent.                                                                                                              | Server                    |
| [**Subscription Resumed**](/collect-data/tracking-plan/subscription-resumed.md)                 | The paused subscription is resumed and the date of processing is indicated on the `actionable_date` property.                                                               | Website front-end         |
| [**User Address Added**](/collect-data/tracking-plan/user-address-added.md)                     | User added an address to their profile.                                                                                                                                     | Website front-end         |
| [**User Address Removed**](/collect-data/tracking-plan/user-address-removed.md)                 | User removed an address from their profile.                                                                                                                                 | Website front-end         |
| [**User Address Updated**](/collect-data/tracking-plan/user-address-updated.md)                 | User updated an address in their profile.                                                                                                                                   | Website front-end         |
| [**User Created**](/collect-data/tracking-plan/user-created.md)                                 | User account has been created.                                                                                                                                              | Server                    |
| [**User Updated**](/collect-data/tracking-plan/user-updated.md)                                 | User account has been updated.                                                                                                                                              | Server                    |
| [**Variant Clicked**](/collect-data/tracking-plan/variant-clicked.md)                           | User clicked on a product variation.                                                                                                                                        | Website front-end         |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.chord.co/collect-data/tracking-plan.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.