Dashboards and pages

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): 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

Embed a dashboard in your website · ~60s
  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:

<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), 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 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.

Markdown