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

# TableElement

> De campagnes, advertentiegroepen en advertenties van een advertentieaccount in één tabel, met tabbladen om ertussen te wisselen: kies rijen om het onderliggende niveau te filteren, zoek, sorteer, splits de cijfers uit, kies je kolommen, en pauzeer, hervat, dupliceer of verwijder direct vanuit een rij. Het tijdvenster waarover gerapporteerd wordt en de rijen waarop gefilterd is, staan op de handle, zodat een grafiek die ernaast is gemount over precies hetzelfde rapporteert.

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

*Sinds `v1.0.0`.*

Wordt gemount binnen [`Reporting`](https://docs.whop.com/nl/elements/latest/ads/reporting), in [`Ads`](https://docs.whop.com/nl/elements/latest/ads/overview). `accountId` en `accessToken` komen uit `Ads`. Geef props en callbacks door via de create-opties of als React-props.

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Ads /* options */>
        <Reporting>
          <TableElement onTabChanged={(e) => console.log(e)} onFilterChanged={(e) => console.log(e)} onColumnsChanged={(e) => console.log(e)} onCustomMetricsChanged={(e) => console.log(e)} onViewChanged={(e) => console.log(e)} onSourcesChanged={(e) => console.log(e)} onAttributionModelChanged={(e) => console.log(e)} />
        </Reporting>
      </Ads>
    </WhopElements>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const ads = window.WhopElements().ads.create({ /* options */ });
  const reporting = ads.create('reporting', { /* options */ });
  reporting.create('table', {
    onTabChanged: (e) => console.log(e),
    onFilterChanged: (e) => console.log(e),
    onColumnsChanged: (e) => console.log(e),
    onCustomMetricsChanged: (e) => console.log(e),
    onViewChanged: (e) => console.log(e),
    onSourcesChanged: (e) => console.log(e),
    onAttributionModelChanged: (e) => console.log(e)
  }).mount('#ads-reporting-table');
</script>
```

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

## Props

**useCampaignCreator** `boolean`

Wat er gebeurt wanneer een kijker iets wil bewerken — via een rijmenu, een conceptrij of Edit ad in de detailoverlay. Standaard aan: de campagnebuilder opent boven de pagina, op de gevraagde campagne en stap, zodat bewerken werkt zonder dat je iets hoeft te koppelen. Zet het uit om het bewerken van campagnes zelf af te handelen — er opent dan niets en het verzoek komt terug via `editRequested`. Standaard: `true`.

**breakdown** `string | null`

Heeft geen effect meer: de tabel toont altijd volledige rijen. Wordt geaccepteerd zodat bestaande embeds blijven werken. Standaard: `null`.

**columns** `string[] | null`

De zichtbare kolommen, op naam — standaardkolommen zoals `impressions` en `roas`, en eventuele pixelevents die de kijker heeft toegevoegd. Als dit niet is ingesteld, opent de tabel met de eigen standaardinstellingen. Komt volledig terug via `columnsChanged`; sla de lijst op en geef haar hier door om de indeling te behouden. Standaard: `null`.

**customMetrics** `CustomMetricDefinition[]`

Kolommen die worden berekend uit de cijfers die al in de tabel staan — een formule die je een naam en opmaak geeft. De tabel kan ze bewerken, en elke wijziging komt terug via `customMetricsChanged` als de volledige nieuwe lijst; sla die op en geef haar hier door om haar te behouden. Standaard: `[]`.

**properties**

**name** `string` *required*

**formula** `string` *required*

**format** `"number" | "currency" | "percent"` *required*

**enabled** `boolean` *required*

**sourcesDrill** `string | null`

Waarin het tabblad All is ingezoomd, als bronpad: `null` voor de roots, `ext:*` voor een lijst met platforms, `ext:<platform>:*` voor de campagnes van dat platform. Komt terug via `viewChanged`. Standaard: `null`.

**query** `string`

Waarop het zoekvak van het tabblad Ads is gefilterd. Standaard: `""`.

**showPausedCampaigns** `boolean`

Of gepauzeerde campagnes worden weergegeven. Standaard: `true`.

**showPausedAdGroups** `boolean`

Of gepauzeerde advertentiegroepen worden weergegeven. Standaard: `true`.

**showPausedAds** `boolean`

Of gepauzeerde advertenties worden weergegeven. Standaard: `true`.

## Events

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

### `onTabChanged`

Het geopende tabblad is gewijzigd. Spiegel het in je eigen URL als je wilt dat het een herlaadbeurt overleeft.

**payload** `object`

**properties**

**tab** `"ads" | "all" | "businesses" | "campaigns" | "ad-groups"` *required*

### `onFilterChanged`

De kijker heeft de weergave beperkt — door rijen aan te vinken of door vanuit een campagne door te klikken naar de advertentiegroepen. Elk oppervlak onder dezelfde handle heeft dit al gevolgd.

**payload** `object`

**properties**

**campaignIds** `string[]` *required*

**adGroupIds** `string[]` *required*

**adIds** `string[]` *required*

### `onColumnsChanged`

De kijker heeft een kolom getoond of verborgen. Bevat elke kolom die nu zichtbaar is, zowel standaardkolommen als pixelevents — sla de lijst op en geef haar direct terug als `columns`, anders wordt de indeling bij de volgende mount teruggezet.

**payload** `object`

**properties**

**columns** `string[]` *required*

### `onCustomMetricsChanged`

De kijker heeft een berekende kolom toegevoegd, bewerkt of verwijderd. Bevat hoe dan ook de volledige lijst — sla die ongewijzigd op en geef haar terug als `customMetrics`, anders zijn ze bij de volgende mount verdwenen.

**payload** `object`

**properties**

**customMetrics** `CustomMetricDefinition[]` *required*

**properties**

**name** `string` *required*

**formula** `string` *required*

**format** `"number" | "currency" | "percent"` *required*

**enabled** `boolean` *required*

### `onViewChanged`

De kijker heeft een van de eigen besturingselementen van de tabel gewijzigd — het inzoomen op het tabblad All, het zoekvak, of de schakelaar voor gepauzeerde items op een van de drie tabbladen. Bevat ze allemaal, ongeacht welke is gewijzigd; sla ze op en geef ze terug als props, anders worden ze bij de volgende mount teruggezet.

**payload** `object`

**properties**

**sourcesDrill** `string | null` *required*

**breakdown** `null` *required*

**query** `string` *required*

**showPausedCampaigns** `boolean` *required*

**showPausedAdGroups** `boolean` *required*

**showPausedAds** `boolean` *required*

### `onSourcesChanged`

Waar het tabblad All nu naar kijkt, als bronpaden die je direct aan een grafiek kunt doorgeven: `null` buiten het tabblad All (alleen Whop-advertenties), `[]` voor elke bron, anders de aangevinkte rijen of de groep waarin is ingezoomd. Elk oppervlak onder dezelfde handle heeft dit al gevolgd.

**payload** `object`

**properties**

**sources** `string[] | null` *required*

### `onAttributionModelChanged`

De kijker heeft via de kiezer op het tabblad All gewijzigd welk contactmoment de toeschrijving krijgt. Elk oppervlak onder dezelfde handle heeft de toeschrijving al bijgewerkt; sla dit op en geef het terug als `attributionModel`, anders valt het bij de volgende mount terug op last touch.

**payload** `object`

**properties**

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

### `onLoaderStart`

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

### `onReady`

Wordt uitgevoerd na de eerste volledige weergave van het element.

### `onError`

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

**e** `object`

**properties**

**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 ervan vrij. Je kunt dit meer dan eens aanroepen. React verwijdert het element automatisch.

### `update`

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

**Parameters**

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

## Styling

Dit element stelt geen klassennamen beschikbaar voor styling. Gebruik `appearance` (thema, accentkleur, variabelen) om de stijl aan te passen.


## Related topics

- [Rapportage](https://docs.whop.com/nl/elements/latest/ads/reporting.md)
- [PaymentsTableElement](https://docs.whop.com/nl/elements/latest/dashboard/paymentsTable.md)
- [WebsitesElement](https://docs.whop.com/nl/elements/latest/websites/websites.md)
