---
title: "event"
slug: "cloud-sdk-events-browser-event"
abstract: "The event function sends a custom event with custom data from the browser side."
---
# event

|     |     |
| --- | --- |
| Type | Function |
| Import path | `@sitecore-cloudsdk/events/browser` |

Sends a [custom](https://doc.sitecore.com/sdk/en/developers/005/cloud-sdk/cloud-sdk-concepts/concepts-tracking/events/custom-events.html "Custom events") event with custom data.

> [!note]
> The `event` function can also send a standard event, such as `IDENTITY`, `ORDER_CHECKOUT` or `SC_SEARCH` events if the correct payload is provided.

## Signature

```typescript
export async function event(
  eventData: EventData
): Promise<EPResponse | null>
```

## Parameters

| Name | Type | Description |
| --- | --- | --- |
| `eventData` | [`EventData`](https://doc.sitecore.com/sdk/en/developers/005/cloud-sdk/cloud-sdk-reference/cloud-sdk-events/cloud-sdk-events-browser/interfaces/cloud-sdk-events-eventdata.html "EventData") | Required.<br><br>Data for [custom](https://doc.sitecore.com/sdk/en/developers/005/cloud-sdk/cloud-sdk-concepts/concepts-tracking/events/custom-events.html "Custom events") events. |

## Return value

Returns a promise or null.

## Examples

:::tab{title="Next.js"}

Example 35. Running the event function

:::tab{title="Next.js"}
> [!note]
> To run this function, you have to first [initialize](https://doc.sitecore.com/sdk/en/developers/005/cloud-sdk/cloud-sdk-reference/cloud-sdk-events/cloud-sdk-events-browser/functions/cloud-sdk-core-browser-cloudsdk.html "CloudSDK") the Cloud SDK.
>
> See [more examples](https://doc.sitecore.com/sdk/en/developers/005/cloud-sdk/cloud-sdk-reference/cloud-sdk-events/cloud-sdk-events-browser/functions/custom-events.html "Custom events") and [other data](https://doc.sitecore.com/sdk/en/developers/005/cloud-sdk/cloud-sdk-reference/cloud-sdk-events/cloud-sdk-events-browser/functions/cloud-sdk-events-eventdata.html "EventData") you can include in the event.

Here's an example of how to use the `event` function to send a custom event named `"myretailsite:CLICKED_PROMO"`:

```typescript
"use client"; // Used only in Next.js App Router
import { event } from "@sitecore-cloudsdk/events/browser";

export default function Component(){
  const sendCustomEvent = async () => {
    const eventData: any = {
      type: "myretailsite:CLICKED_PROMO"
    };

    await event(eventData);

    console.log("Sent custom event.");
  };

  return (
    <div>
      <button onClick={sendCustomEvent}>send custom event</button>
    </div>
  );
};
```

:::

:::