---
title: "widgetFacetClick"
slug: "cloud-sdk-search-server-widgetfacetclick"
abstract: "The widgetFacetClick function sends a widget facet click event from the server side."
---
# widgetFacetClick

|     |     |
| --- | --- |
| Type | Function |
| Import path | `@sitecore-cloudsdk/search/server` |

Sends a [facet click event](https://doc.sitecore.com/sdk/en/developers/005/cloud-sdk/cloud-sdk-concepts/concepts-tracking/events/sitecore-search-events.html "Sitecore Search events").

## Signature

```typescript
export async function widgetFacetClick(
  widgetFacetClickEventParams: WidgetFacetClickEventParams
): Promise<EPResponse | null>
```

## Parameters

| Name | Type | Description |
| --- | --- | --- |
| `widgetFacetClickEventParams` | [`WidgetFacetClickEventParams`](https://doc.sitecore.com/sdk/en/developers/005/cloud-sdk/cloud-sdk-reference/cloud-sdk-search/cloud-sdk-search-browser/interfaces/cloud-sdk-search-widgetfacetclickeventparams.html "WidgetFacetClickEventParams") | Data for [facet click events](https://doc.sitecore.com/sdk/en/developers/005/cloud-sdk/cloud-sdk-concepts/concepts-tracking/events/sitecore-search-events.html "Sitecore Search events"). |

## Return value

Returns a promise.

## Examples

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

Example 77. Running the widgetFacetClick 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-search/cloud-sdk-search-server/functions/cloud-sdk-core-server-cloudsdk.html "CloudSDK") the Cloud SDK.
>
> See [more examples](https://doc.sitecore.com/sdk/en/developers/005/cloud-sdk/cloud-sdk-reference/cloud-sdk-search/cloud-sdk-search-server/functions/sitecore-search-events.html "Sitecore Search events") and [other data](https://doc.sitecore.com/sdk/en/developers/005/cloud-sdk/cloud-sdk-reference/cloud-sdk-search/cloud-sdk-search-server/functions/cloud-sdk-search-widgetfacetclickeventparams.html "WidgetFacetClickEventParams") you can include in the event.

Here's an example of how to use the `widgetFacetClick` function:

```typescript
import type { NextRequest } from "next/server";
import { NextResponse } from "next/server";
import { CloudSDK } from "@sitecore-cloudsdk/core/server";
import { widgetFacetClick } from "@sitecore-cloudsdk/search/server";
import type { WidgetFacetClickEventParams } from "@sitecore-cloudsdk/search/server";

export default async function middleware(request: NextRequest) {
  const response = NextResponse.next();

  // Initialize the SDK and the package...

  // Send event:
  const eventData: WidgetFacetClickEventParams = {
    filters: [
      {
        displayName: "Color",
        facetPosition: 1,
        name: "color",
        title: "Color",
        value: "Blue",
        valuePosition: 5
      }
    ],
    request: {
      keyword: "green",
      numResults: 3,
      totalResults: 3,
      numRequested: 10
    },
    pathname: "/search",
    widgetId: "rfkid_7"
  };

  const widgetFacetClickResponse = await widgetFacetClick(request, eventData);
  console.log("Sent widget facet click event.", widgetFacetClickResponse);

  return response;
}
```

:::

:::