Creating a review add event

There are many types of events you can send using the Sitecore Search Events API. You might want to track instances of visitors reviewing content. You can do this using a review add event. If reviewing content counts as a conversion for your business, you can mark this event as a conversion by setting the action_sub_type key to conversion.


In addition to the default attributes that are required for all events, the entities attribute is required for review add. The entities array must contain an object representing the entity the user added a review for, with at least the id and entity_type attributes included.

The following is an example of a review add event:


For the event object data model, see the Events API reference.

  "name": "review",
  "action": "add",
  "action_sub_type": "conversion",
  "uuid": "<uuid>",
  "client_time_ms": 1234,
  "value": {
    "context":  <context object>,
    "entities": [
        "id": "123",
        "entity_type": "content",
        "entity_subtype": "article",
        "attributes": {
           "author": "ABC"
    "review": {
         "id": "review_id",
         "rating": 4,
         "comment": "Helpful article!"

Do you have some feedback for us?

If you have suggestions for improving this article,