> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# PeopleElement

> Iedereen die het account heeft gezien — bezoekers en klanten die uit pixelactiviteit zijn herleid, met hun bron, uitgaven en activiteitstellers. Zoek, filter op bron, event, geografie of apparaat, sorteer elke kolom en blader door de pagina's. Een klik op een rij volgt `links.person` wanneer de handle dat configureert, en komt anders bij jou terug als `personOpened`.

> [!NOTE]
>
> Deze pagina documenteert `@whop/elements@1.10.0` en `@whop/elements-react@1.10.0`.

*Sinds `v1.0.0`.*

Wordt gemount binnen [`Tracking`](https://docs.whop.com/nl/elements/latest/tracking/overview). `accountId` en `accessToken` komen daarvandaan. Geef props en callbacks mee via de create-opties of als React-props.

```tsx React theme={null}
import { WhopElements, Tracking, PeopleElement } from "@whop/elements-react";
import { loadWhop } from "@whop/elements";

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Tracking /* options */>
        <PeopleElement onPeriodChanged={(e) => console.log(e)} onAttributionModelChanged={(e) => console.log(e)} onFiltersChanged={(e) => console.log(e)} onSortChanged={(e) => console.log(e)} onPersonOpened={(e) => console.log(e)} />
      </Tracking>
    </WhopElements>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const tracking = window.WhopElements().tracking.create({ /* options */ });
  tracking.create('people', {
    onPeriodChanged: (e) => console.log(e),
    onAttributionModelChanged: (e) => console.log(e),
    onFiltersChanged: (e) => console.log(e),
    onSortChanged: (e) => console.log(e),
    onPersonOpened: (e) => console.log(e)
  }).mount('#tracking-people');
</script>
```

Voorbeeldgegevens. [Open de Playground](https://docs.whop.com/nl/elements/latest/tracking/overview#playground).

## Props

**source** `string`

Beperk tot personen die via een verkeersbron zijn binnengekomen, als bronpad — `whop:adcamp_…:*` voor een van de campagnes van het account, `ext:*` voor advertenties die elders lopen, `referrer:*`, `direct`. Dezelfde waarde waarmee de klikaantallen in de advertentietabel linken, zodat een pagina dit rechtstreeks vanuit de eigen URL kan hydrateren. Standaard `""`.

**eventName** `string`

Beperk tot personen die een event hebben uitgevoerd, op basis van de naam — `payment.completed`, `pixel.lead`, `pixel.page`. Standaard `""`.

**customEvent** `string`

Beperk tot personen die een aangepast pixel-event hebben uitgevoerd, op basis van de aangepaste naam. Combineer met een lege `eventName`. Standaard `""`.

**utmSource** `string`

Beperk op de `utm_source` die hun verkeer meedroeg. Scheid met komma's om op een van meerdere waarden te matchen. Standaard `""`.

**country** `string`

Beperk op ISO 3166-1 alpha-2-landcode, zoals `US` of `GB`. Standaard `""`.

**device** `string`

Beperk op apparaatklasse — `desktop`, `mobile`, `tablet`, `bot`. Standaard `""`.

**browser** `string`

Beperk op browsernaam. Standaard `""`.

**os** `string`

Beperk op naam van het besturingssysteem. Standaard `""`.

**hasPurchased** `string`

`true` voor alleen klanten, `false` voor personen die nooit iets hebben gekocht, leeg voor iedereen. Standaard `""`.

**query** `string`

Waarop het zoekvak is gefilterd — een naam, een e-mailadres of een identifier. Standaard `""`.

**audienceId** `string`

Beperk tot een opgeslagen doelgroep (`adaud_…`) die is opgebouwd uit persoonsfilters. Het doelgroepfiltermenu past dit aan. Standaard `""`.

**eventFrom** `string`

Zet het eventvenster voor `source`/`eventName`-filters vast op een exact ISO 8601-tijdstip in plaats van de `period` van de handle. Stel zowel `eventFrom` als `eventTo` in, of geen van beide. Standaard `""`.

**eventTo** `string`

Het einde van het vastgezette eventvenster, als ISO 8601-tijdstip. Standaard `""`.

**sort** `string`

De gesorteerde kolom: `name`, `email`, `ltv`, `purchase_count`, `event_count`, `first_seen_at`, `last_seen_at`. Standaard `"last_seen_at"`.

**dir** `"asc" | "desc"`

De sorteerrichting. Standaard `"desc"`.

## Events

Geef callbacks mee in de create-opties of als React-props.

### `onPeriodChanged`

De kijker heeft het venster verplaatst via de periodekiezer. Elk oppervlak onder dezelfde handle is al meegegaan; sla het op en geef het terug als `period`/`customRange` op de handle, anders wordt het venster bij de volgende mount gereset.

**payload** `object`

**eigenschappen**

**period** `string` *required*

Een van `"today"`, `"yesterday"`, `"last_7_days"`, `"last_14_days"`, `"last_30_days"`, `"last_90_days"`, `"all_time"` of `"custom"`.

**customRange** `object | null` *required*

**eigenschappen**

**from** `string` *required*

**to** `string` *required*

### `onAttributionModelChanged`

De kijker heeft via het menu Attribution in de filterrij gewijzigd welk contactmoment de toeschrijving krijgt. Elk oppervlak onder dezelfde handle heeft de toeschrijving al opnieuw berekend; sla het op en geef het terug als `attributionModel` op de handle, anders wordt het bij de volgende mount teruggezet.

**payload** `object`

**eigenschappen**

**attributionModel** `"last_touch" | "first_touch"` *required*

### `onFiltersChanged`

De kijker heeft een filter, het zoekvak of de doelgroepkiezer gewijzigd. Bevat de volledige filterstatus, ongeacht wat er veranderde — spiegel deze in je eigen URL en geef hem terug als props om de weergave reproduceerbaar te maken.

**payload** `PeopleFilterBag`

**eigenschappen**

**source** `string` *required*

**eventName** `string` *required*

**customEvent** `string` *required*

**utmSource** `string` *required*

**country** `string` *required*

**device** `string` *required*

**browser** `string` *required*

**os** `string` *required*

**hasPurchased** `string` *required*

**query** `string` *required*

**audienceId** `string` *required*

**eventFrom** `string` *required*

**eventTo** `string` *required*

### `onSortChanged`

De kijker heeft een kolom gesorteerd. Sla dit op en geef het terug als `sort`/`dir`, anders wordt de sortering bij de volgende mount gereset.

**payload** `object`

**eigenschappen**

**sort** `string` *required*

**dir** `"asc" | "desc"` *required*

### `onPersonOpened`

De kijker heeft op een persoonsrij geklikt en de handle heeft geen `links.person` om te volgen. Toon er het `person`-element mee, bijvoorbeeld `createOverlay("person", { identifier: payload.personId })` (`personId` is de stabiele sleutel per persoon; `identifier` is de meest betekenisvolle voor mensen die het oppervlak heeft), of geef `links.person` mee op de handle om de rijen in plaats daarvan echte links te maken.

**payload** `object`

**eigenschappen**

**identifier** `string` *required*

**personId** `string` *required*

### `onLoaderStart`

Wordt uitgevoerd nadat het laadskelet voor het eerst is weergegeven en vóór `onReady`.

### `onReady`

Wordt uitgevoerd na de eerste volledige weergave van het element.

### `onError`

Wordt uitgevoerd wanneer het element niet kan laden of crasht. De fallback blijft zichtbaar. Gebruik `code` voor programmatische afhandeling. `sourceKey` identificeert een mislukte host-state-bron.

**e** `object`

**eigenschappen**

**message** `string` *required*

**code** `string`

**sourceKey** `string`

## Methoden

Roep deze aan op de handle die `create` retourneert, of via een React-`ref`.

### `mount`

Mount het element in `target` en begint met laden. React-componenten mounten zichzelf.

**Parameters**

**target** `string | HTMLElement` *required*

### `destroy`

Verwijdert het element en geeft het frame en de abonnementen vrij. Je kunt het meerdere keren aanroepen. React verwijdert het element automatisch.

### `update`

Voegt nieuwe props samen in het gemounte element. Wijzig in React in plaats daarvan de componentprops.

**Parameters**

**options** `Partial\<PeopleElementProps\>` *required*

## Styling

Dit element biedt geen klassenamen voor styling. Gebruik `appearance` (thema, accentkleur, variabelen) om het een andere stijl te geven.


## Related topics

- [Tracking](https://docs.whop.com/nl/elements/latest/tracking/overview.md)
- [PersonElement](https://docs.whop.com/nl/elements/latest/tracking/person.md)
- [Chat-element](https://docs.whop.com/nl/developer/guides/chat/chat-element.md)
