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

# ChartElement

> De prestaties van een account over een tijdvenster, met een kiezer voor wat er wordt geplot — uitgaven, impressies, klikken of elke conversie die het account registreert. Alleen-lezen.

> [!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). Geef props en callbacks door via de create-opties of als React-props.

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Ads /* options */>
        <Reporting>
          <ChartElement onMetricChanged={(e) => console.log(e)} onTimezoneChanged={(e) => console.log(e)} onPeriodChanged={(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('chart', {
    onMetricChanged: (e) => console.log(e),
    onTimezoneChanged: (e) => console.log(e),
    onPeriodChanged: (e) => console.log(e)
  }).mount('#ads-reporting-chart');
</script>
```

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

## Props

**metric** `string`

Wat de grafiek plot — `spend`, `impressions`, `clicks` of een conversie. De kiezer wijzigt deze waarde; stel haar in om op iets anders te openen. Geef voor `conversions`, `conversion_value` en `cost_per_conversion` de conversie op in `metricEvent`. Standaard: `"spend"`.

Een van `"funnel"`, `"spend"`, `"impressions"`, `"clicks"`, `"cost_per_1k_impressions"`, `"cost_per_click"`, `"conversions"`, `"conversion_value"` of `"cost_per_conversion"`.

**metricEvent** `string`

De conversie waarnaar `metric` verwijst als dat een metriek per conversie is — `payment.completed`, `pixel.lead` of een aangepast event dat het account zelf benoemt. Wordt door elke andere metriek genegeerd. Standaard: `""`.

## Events

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

### `onMetricChanged`

De kijker heeft een ander resultaat gekozen om te plotten. `metric` is wat er wordt geplot; `event` benoemt de conversie waarnaar het verwijst en is alleen aanwezig voor `conversions`, `conversion_value` en `cost_per_conversion` — het account bepaalt hoe die heten, dus het is een string in plaats van een vaste waarde. Spiegel het in je eigen URL en geef het terug als `metric`/`metricEvent` als je wilt dat de keuze een herlaadbeurt overleeft; het element onthoudt de keuze hoe dan ook zolang het gemount is.

**payload** `object`

**properties**

**metric** `string` *required*

Een van `"funnel"`, `"spend"`, `"impressions"`, `"clicks"`, `"cost_per_1k_impressions"`, `"cost_per_click"`, `"conversions"`, `"conversion_value"` of `"cost_per_conversion"`.

**event** `string`

### `onTimezoneChanged`

De kijker heeft gewijzigd in welke tijdzone de cijfers worden gerapporteerd: de gemaakte keuze EN de IANA-zone waarin die resulteert. De keuze is het deel dat een herlaadbeurt overleeft — sla haar op en geef haar terug als `timezone`, zoals het Whop-dashboard met zijn eigen kopie doet; het element onthoudt de keuze hoe dan ook zolang het gemount is. `resolved` wordt meegestuurd zodat een host zijn eigen cijfers kan labelen zonder de accountvoorkeur opnieuw op te zoeken, en is de eigen zone van de kijker wanneer het account er geen heeft ingesteld.

**payload** `object`

**properties**

**timezone** `"account" | "local"` *required*

**resolved** `string` *required*

### `onPeriodChanged`

De kijker heeft het rapportagevenster verschoven: de gekozen periode EN het tijdvenster waarin die resulteert, als ISO 8601-tijdstippen. De datums worden opgelost meegestuurd, omdat je met alleen een periodenaam de berekening van daggrenzen en accounttijdzone opnieuw zou moeten doen om ermee te werken; de periode wordt ook meegestuurd, omdat alleen die een herlaadbeurt overleeft als VOORTSCHRIJDEND venster — opgeslagen datums zouden het vastzetten. Elk oppervlak onder dezelfde handle heeft de wijziging al gevolgd.

**payload** `object`

**properties**

**period** `string` *required*

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

**from** `string` *required*

**to** `string` *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\<ChartElementProps\>` *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)
- [BalanceElement](https://docs.whop.com/nl/elements/latest/wallet/balances-balance.md)
- [Chat-element](https://docs.whop.com/nl/developer/guides/chat/chat-element.md)
