# Embed a dashboard in your website or app

> Put a DataxLand dashboard page into your portal, admin panel or web app with one iframe snippet; lock filters, restrict domains and revoke access at any time.

Embedding places **one dashboard page** of your workspace inside another website. Viewers **don't need a DataxLand account**:
they see the page's tiles, can change the period and use the filters you open up. There is no Ask Si, no number explainer, no
metric handbook and no link back into the app.

Embedding is included from the **Small Business** plan up (see [Plans and limits](/en/docs/billing/quotas)): each plan has a number
of active embed codes and a number of **views per month**. One view is one load of the embedded page.

## Create an embed code

1. Open the dashboard page (the **Reports** group in the sidebar). If your audience should only see part of the
   numbers, set the filter first, for example **Channel** = Shop A.
2. Click **Share → Embed dashboard**. This needs the **Admin** role or above.
3. Fill in:
   - **Label**: helps you recognise the code in the list (e.g. "Shop A partner portal").
   - **Allowed domains**: one per line, like `https://portal.example.com`. Use `https://*.example.com` for
     all subdomains. `http://` only works for `localhost` while testing. Up to 10 domains.
   - **Expires after**: 7 to 365 days.
   - **Period when opened**: the period shown when a viewer opens the page; they can change it.
   - **Lock the current filters**: viewers can't remove these filters. Tiles whose metric can't be filtered by a
     locked filter are hidden from the embedded page, so unfiltered numbers never leak.
   - **Viewers can filter by**: dimensions viewers pick values for themselves (e.g. platform).
4. Click **Create embed code**, then **Copy iframe code** or **Copy link**.
   **The code is shown only this once**; if you lose it, create a new one and revoke the old one.

The snippet looks like this:

```html
<iframe src="https://app.dataxland.com/embed/dxe_..." title="P&L overview" width="100%" height="900"
  style="border:0" loading="lazy" referrerpolicy="no-referrer" allow="fullscreen"></iframe>
```

Paste it into an HTML page, CMS or web app served from **one of the declared domains**. Browsers block the frame on any other
domain (DataxLand sends a `Content-Security-Policy: frame-ancestors` header built from the code's list).

## What viewers see

- The page title, the period picker, the filters you opened up, and the locked filters (with a padlock icon).
- The page's tiles, formatted with the workspace's **currency, time zone and number format** ([regional settings](/en/docs/workspace/region)),
  with the same **Standard** confirmation label as in the app.
- Numbers go through the same metric layer as the app: one definition everywhere, and no buyer personal data.

## Manage and revoke

The **Embed dashboard** dialog lists the page's codes: domains, expiry, **views this month** and status (**Active**,
**Expired**, **Revoked**). Click **Revoke** to stop a code: the embedded page shows "revoked" on its
next load.

Codes belong to the **workspace**, not to the person who created them: if that member leaves, the code keeps working until an
Admin revokes it. Every creation and revocation is recorded in the workspace security log.

## Running out of views, downgrading

- At **80%** of the month's views, the Owner gets an email and an in-app notice.
- When views run out, embedded pages show "paused" until the next period; dashboards inside the app are unaffected. Buy an extra
  **10,000 views** or upgrade your plan.
- Downgrading to a plan without embedding pauses every embedded page; codes stay in the list and work again after you upgrade (if
  they haven't expired).

## Security

- `frame-ancestors` stops **other** sites from framing the page, but **anyone with the link can open the embedded page** (like a
  share link). For sensitive numbers: place the iframe only behind your own login, use a short expiry, lock filters, and revoke
  the code as soon as it leaks.
- The embedded page never passes its URL (which contains the code) to other sites (`no-referrer`), is not cached and is not
  indexed by search engines.
- Numbers on the embedded page follow the [row-level access](/en/docs/workspace/data-access) of the person who created the code: if
  they can only see one branch, the embed only shows that branch. If the creator leaves the workspace, the embed stops showing
  numbers.
- Each code embeds one dashboard page of a pack. Need filtering per signed-in user of your own system? Contact DataxLand.

## Related

- [Dashboards and pinning to pages](/en/docs/dashboards/pin)
- [Plans and limits](/en/docs/billing/quotas)
- [Security and privacy](/en/docs/security-privacy)
