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

# Websites

> De websites van een account: elke site die op whop.site is gebouwd plus elk domein dat de Whop Pixel meldt, met verkeer en toegeschreven omzet per domein. Mount `websites` en het toont ze met bezoekers, paginaweergaven, verkopen, omzet, trend en meest bekeken pagina's. Mount `pixel-setup` ernaast en een site waarvan de wizard net heeft bewezen dat de pixel live is, krijgt automatisch een wachtrij, omdat de eerste events een paar minuten nodig hebben om de stats-API te bereiken en de site anders verdwenen lijkt — je hoeft daarvoor niets te koppelen, en de rij blijft op je pagina bewaard, zodat die er nog staat als de merchant de pagina herlaadt. Het lezen van statistieken is geprivilegieerd, dus er is een `accessToken` nodig — behalve binnen de eigen app van Whop, waar de sessie van de kijker het lezen afhandelt.

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

*Sinds `v1.0.0`.*

## Playground

Stel de elementen samen met voorbeeldgegevens. Bedien de besturingselementen, voeg elementen toe en schik ze, en zie events live worden geactiveerd:

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Websites /* options */>
        {/* mount elements here */}
      </Websites>
    </WhopElements>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const websites = window.WhopElements().websites.create({ /* options */ });
</script>
```

## Opties

Geef deze mee aan `whop.websites.create({ … })`, of als props op `<Websites>` in React.

**windowDays** `number`

Hoeveel dagen verkeer de tabel beslaat, van 1 tot 90. @default 30 Standaard `30`.

**includeApps** `boolean`

Toon websites die op whop.site zijn gebouwd vanaf het moment dat ze bestaan, met nullen totdat er verkeer binnenkomt. Schakel dit uit om alleen domeinen te tonen die de pixel meldt. @default true Standaard `true`.

**pendingWebsites** `PendingWebsite[]`

Websites die je net hebt toegevoegd en die nog niet live zijn — `{ domain, kind }`, waarbij `kind` gelijk is aan `deploy` voor een site op whop.site die wacht op de eerste deploy, of `events` voor een site die wacht op de eerste pixelevents. Ze worden weergegeven als wachtrijen, zodat een site direct na de installatie nooit verdwenen lijkt, en de tabel pollt zolang er nog een openstaat. Sites waarvan de gemounte `pixel-setup`-wizard bewijst dat ze live zijn, worden voor je toegevoegd, blijven bewaard na herladen en zijn NIET jouw taak — dit is voor de wachttijden die de handle zelf niet kan zien, vooral een site op whop.site die je net hebt aangemaakt en die geen enkel element hier meldt. Items die je toevoegt, moet je zelf verwijderen: een rij wordt niet meer getekend zodra het domein in de tabel staat, maar de lijst zelf verandert alleen wanneer jij die wijzigt, dus verwijder een item wanneer `websitesLoaded` het domein noemt en geef de rest een eigen time-out. Standaard `[]`.

**eigenschappen**

**domain** `string` *required*

**kind** `"events" | "deploy"` *required*

**showVerify** `boolean`

Voeg aan elke rij een knop toe om de pixel te controleren. Het element meldt de klik alleen via `onVerifyRequested` — het openen van de site en het bepalen van de uitkomst is aan jou, omdat browsers een pop-up vertrouwen die door je eigen pagina is geopend. Standaard `false`.

**showSettings** `boolean`

Voeg een instellingenknop toe aan whop.site-rijen. Het element meldt de klik alleen via `onSettingsRequested` — het bewerkingsoppervlak is aan jou. Standaard `false`.

**showEdit** `boolean`

Voeg een bewerkknop toe aan whop.site-rijen, gestyled als de primaire actie van de rij. Het element meldt de klik alleen via `onEditRequested` — het bewerkingsoppervlak is aan jou. Standaard `false`.

**verifyTarget** `string`

Bij welke rij de lopende controle hoort — de `target` uit het `verifyRequested`-event dat je afhandelt. Standaard `""`.

**verifyStatus** `string`

Hoe de lopende controle verloopt, getoond op de knop van die rij: `waiting`, `connected`, `not-detected`, of `blocked` wanneer de pop-up is geblokkeerd. Standaard `"idle"`.

Een van `"idle"`, `"waiting"`, `"connected"`, `"not-detected"` of `"blocked"`.

**accessToken** `string`

Een scoped token voor het lezen — statistieken vereisen `stats:read`, en de lijst met whop.site-websites leest apps (rijen vallen terug op alleen verkeer als het token dat niet kan). Maak het aan op je server met `POST /api/v1/access_tokens` en stel een nieuw token in voordat het verloopt. `pixel-setup` is het enige onderdeel waaraan dit niet wordt doorgegeven — het authenticeert zijn eigen scans met zijn eigen `accessToken` — dus maak één token aan met beide sets scopes en geef diezelfde string aan beide mee, in plaats van één token per element. Wordt het weggelaten, dan gebruiken de leesacties de eigen sessie van de kijker, die alleen same-origin antwoordt.

**accountId** `string` *required*

Account-ID, met het voorvoegsel `biz_`, waarvan deze oppervlakken de websites lezen.

**appearance** `Appearance`

Visuele aanpassing voor de elementen in deze groep. Overschrijft de globale `WhopElements({ appearance })`. Wijzig het live met `update({ appearance })`.

**locale** `WhopElementsLocale`

Locale voor de UI-tekst van de elementen in deze groep. Stel deze in op een van de ingebouwde locales van de app om de globale configuratie te overschrijven. Elke andere waarde valt terug op de standaardlocale.

## Events

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

### `onLoadingChange`

Wordt uitgevoerd wanneer de gegroepeerde laadstatus verandert. De waarde is `true` zolang een gemount element nog laadt.

**loading** `boolean`

## Methoden

Roep deze aan op de Websites-handle van `whop.websites.create({ … })` of `useWebsites()`.

### `update`

Voegt nieuwe handle-opties samen in elk gemount element. Wijzig in React in plaats daarvan de namespace-props.

**Parameters**

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

### `destroy`

Vernietigt elk element en elke sub-controller die deze handle heeft aangemaakt, verwijdert het controllerframe en geeft de abonnementen vrij. Je kunt het meerdere keren aanroepen, maar een vernietigde handle weigert elke andere aanroep — maak een nieuwe handle aan om opnieuw te beginnen. React verwijdert de groep automatisch wanneer de provider wordt ontkoppeld.

## Elementen

De elementen die deze groep mount. Elk element heeft een eigen pagina:

> [card] [WebsitesElement](https://docs.whop.com/nl/elements/latest/websites/websites.md)
>
> De websites van een account in één tabel: elke site die op whop.site is gebouwd — getoond vanaf het moment dat die bestaat, met nullen totdat er verkeer binnenkomt — samengevoegd op hostnaam met elk domein dat de Whop Pixel meldt. Rijen voor de whop.site-sites hebben een Whop-markering, zodat de twee bronnen gescheiden blijven, ook als beide verkeer hebben. Elke rij toont een trend in paginaweergaven, unieke bezoekers, paginaweergaven, toegeschreven verkopen, omzet in USD en de laatste dag waarop een event binnenkwam. Als je een domein uitklapt, worden de meest bekeken pagina's geladen, en elk cijfer voor paginaweergaven opent de uitsplitsing van de events waaruit het bestaat. Stel `showVerify` in om per rij een knop toe te voegen die de pagina waarop dit element staat vraagt de site te openen en te bevestigen dat de pixel wordt geactiveerd; stel `showSettings` in om op whop.site-rijen een instellingenknop toe te voegen die de klik meldt via `onSettingsRequested`, en `showEdit` om een primaire bewerkknop toe te voegen die meldt via `onEditRequested` — je pagina beheert het daadwerkelijke bewerken.

> [card] [PixelSetupElement](https://docs.whop.com/nl/elements/latest/websites/pixel-setup.md)
>
> Installeert de Whop Pixel en koppelt conversie-events: kopieer het fragment, controleer een pagina erop en bevestig dat de events worden geactiveerd. Mount het inline of binnen je eigen overlay.


## Related topics

- [WebsitesElement](https://docs.whop.com/nl/elements/latest/websites/websites.md)
- [Een website hosten op Whop](https://docs.whop.com/nl/developer/websites/overview.md)
- [Een website bouwen met de CLI](https://docs.whop.com/nl/developer/websites/quickstart.md)
