Get started with the RudderStack Track API call.

The track call lets you record the user actions along with any properties associated with them.

Each user action is called an event. Every event has a name associated with it, for example, Product Reviewed. This event might also have some properties associated with it, like review_id and rating.
For ecommerce-specific events, refer to the Ecommerce events specification.

Sample payload

A sample payload for the track event after removing the common fields mentioned in the Common fields section is as shown:

  "type": "track",
  "event": "Product Reviewed",
  "properties": {
    "review_id": "12345",
    "product_id" : "123",
    "rating" : 3.0,
    "review_body" : "Good product."

The corresponding event that generates the above payload via the JavaScript SDK is as shown:

rudderanalytics.track("Product Reviewed", {
  review_id: "12345",
  product_id: "123",
  rating: 3.0,
  review_body: "Good product."

Track fields

Apart from the Common fields, the track call accepts the following fields:

eventStringRequiredName of the user action.
propertiesObjectOptionalIncludes the properties associated with the event. For more information, check the Properties section below.


Properties are additional contextual information that are associated with a track event, that give more clarity of your users’ actions.

RudderStack has reserved some standard properties listed in the following table and handles them in a special manner.


The revenue amount as a result of an event. For e.g., a product worth $20.00 would result in a revenue of 20.00.


The currency of the revenue as a result of the event, set in ISO 4127 format. If this is not set, RudderStack assumes the revenue is in USD.


An abstract value associated with an event, to be used by various teams.

Different destinations recognize some of the above traits differently. For example, Mixpanel has a track_charges method for tracking revenue. With RudderStack, you don’t have to worry about these inconsistencies. In this case, you can pass the revenue property and RudderStack will handle the conversion automatically.

Questions? Contact us by email or on Slack