> ## 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

> Alle, kontoen har set — besøgende og kunder identificeret ud fra pixelaktivitet, med deres kilde, forbrug og aktivitetstællere. Søg, filtrér efter kilde, event, geografi eller enhed, sortér enhver kolonne, og bladr igennem. Et klik på en række følger `links.person`, når handlet konfigurerer det, og kommer ellers tilbage til dig som `personOpened`.

> [!NOTE]
>
> Denne side dokumenterer `@whop/elements@1.10.0` og `@whop/elements-react@1.10.0`.

*Siden `v1.0.0`.*

Monteres inde i [`Tracking`](https://docs.whop.com/da/elements/latest/tracking/overview). `accountId` og `accessToken` kommer derfra. Angiv props og callbacks via create-indstillingerne eller som 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>
```

Eksempeldata. [Åbn Playground](https://docs.whop.com/da/elements/latest/tracking/overview#playground).

## Props

**source** `string`

Afgræns til personer, der er hentet ind af en trafikkilde, angivet som en kildesti — `whop:adcamp_…:*` for en af kontoens kampagner, `ext:*` for annoncer kørt andre steder, `referrer:*`, `direct`. Den samme værdi, som annoncetabellens klikantal linker med, så en side kan hydrere denne direkte fra sin egen URL. Standard er `""`.

**eventName** `string`

Afgræns til personer, der har udført en event, efter dens navn — `payment.completed`, `pixel.lead`, `pixel.page`. Standard er `""`.

**customEvent** `string`

Afgræns til personer, der har udført en brugerdefineret pixel-event, efter dens brugerdefinerede navn. Kombineres med en tom `eventName`. Standard er `""`.

**utmSource** `string`

Afgræns efter den `utm_source`, deres trafik bar. Adskil med kommaer for at matche en hvilken som helst af flere. Standard er `""`.

**country** `string`

Afgræns efter ISO 3166-1 alpha-2-landekode, f.eks. `US` eller `GB`. Standard er `""`.

**device** `string`

Afgræns efter enhedsklasse — `desktop`, `mobile`, `tablet`, `bot`. Standard er `""`.

**browser** `string`

Afgræns efter browsernavn. Standard er `""`.

**os** `string`

Afgræns efter styresystemets navn. Standard er `""`.

**hasPurchased** `string`

`true` kun for kunder, `false` for personer, der aldrig har købt, tom for alle. Standard er `""`.

**query** `string`

Hvad søgefeltet er filtreret på — et navn, en e-mail eller en identifikator. Standard er `""`.

**audienceId** `string`

Afgræns til en gemt målgruppe (`adaud_…`) bygget ud fra personfiltre. Målgruppefiltermenuen ændrer denne værdi. Standard er `""`.

**eventFrom** `string`

Fastlås event-vinduet for `source`/`eventName`-filtre til et præcist ISO 8601-tidspunkt i stedet for handlets `period`. Sæt både `eventFrom` og `eventTo` eller ingen af dem. Standard er `""`.

**eventTo** `string`

Slutningen af det fastlåste event-vindue som et ISO 8601-tidspunkt. Standard er `""`.

**sort** `string`

Den sorterede kolonne: `name`, `email`, `ltv`, `purchase_count`, `event_count`, `first_seen_at`, `last_seen_at`. Standard er `"last_seen_at"`.

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

Sorteringsretningen. Standard er `"desc"`.

## Events

Angiv callbacks i create-indstillingerne eller som React-props.

### `onPeriodChanged`

Seeren flyttede tidsvinduet via periodevælgeren. Alle flader under det samme handle har allerede fulgt med; gem det, og send det tilbage som `period`/`customRange` på handlet, ellers nulstilles tidsvinduet ved næste montering.

**payload** `object`

**egenskaber**

**period** `string` *required*

Én af `"today"`, `"yesterday"`, `"last_7_days"`, `"last_14_days"`, `"last_30_days"`, `"last_90_days"`, `"all_time"` eller `"custom"`.

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

**egenskaber**

**from** `string` *required*

**to** `string` *required*

### `onAttributionModelChanged`

Seeren ændrede, hvilket berøringspunkt der får krediteringen, via filterrækkens Attribution-menu. Alle flader under det samme handle har allerede krediteret på ny; gem det, og send det tilbage som `attributionModel` på handlet, ellers vender det tilbage ved næste montering.

**payload** `object`

**egenskaber**

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

### `onFiltersChanged`

Seeren ændrede et filter, søgefeltet eller målgruppevælgeren. Indeholder hele filtertilstanden, uanset hvad der blev ændret — spejl den i din egen URL, og send den tilbage som props for at gøre visningen reproducerbar.

**payload** `PeopleFilterBag`

**egenskaber**

**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`

Seeren sorterede en kolonne. Gem og send tilbage som `sort`/`dir`, ellers nulstilles sorteringen ved næste montering.

**payload** `object`

**egenskaber**

**sort** `string` *required*

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

### `onPersonOpened`

Seeren klikkede på en personrække, og handlet har intet `links.person` at følge. Vis `person`-elementet med den, f.eks. `createOverlay("person", { identifier: payload.personId })` (`personId` er den stabile nøgle pr. person; `identifier` er den mest menneskeligt meningsfulde, fladen har), eller angiv `links.person` på handlet for i stedet at gøre rækkerne til rigtige ankre.

**payload** `object`

**egenskaber**

**identifier** `string` *required*

**personId** `string` *required*

### `onLoaderStart`

Kører, efter at indlæsningsskelettet først er tegnet, og før `onReady`.

### `onReady`

Kører efter elementets første fuldstændige rendering.

### `onError`

Kører, når elementet ikke kan indlæses eller går ned. Fallback-visningen forbliver synlig. Brug `code` til programmatisk håndtering. `sourceKey` identificerer en host-state-kilde, der fejlede.

**e** `object`

**egenskaber**

**message** `string` *required*

**code** `string`

**sourceKey** `string`

## Metoder

Kald disse på det handle, som `create` returnerer, eller via en React-`ref`.

### `mount`

Monterer elementet i `target` og begynder indlæsningen. React-komponenter monterer sig selv.

**Parametre**

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

### `destroy`

Fjerner elementet og frigiver dets frame og abonnementer. Du kan kalde den mere end én gang. React fjerner elementet automatisk.

### `update`

Fletter nye props ind i det monterede element. I React ændrer du i stedet komponentens props.

**Parametre**

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

## Styling

Dette element eksponerer ikke klassenavne til styling. Brug `appearance` (tema, accentfarve, variabler) til at ændre udseendet.
