Embedding widgets¶

Any Chart, Markdown, Map, or Calendar widget on a View can be embedded outside TableView — a public link that needs no login and renders a read-only snapshot of that widget's data on another site.

An embed is never a live connection to your workspace. It shows a cached copy of the widget's data that refreshes automatically on the interval you choose, so embedding a widget adds no extra load on your data every time someone views the page it's on.

Enable embedding on a widget¶

1. Open a View and find the widget you want to embed.
2. Click the ⋮ menu in the widget's top-right corner and choose Embed.
3. Click Enable embedding.

This generates a unique public link (token) for that widget.

Configure the embed¶

• Refresh interval — how often the embed's cached snapshot is allowed to update, from every minute up to every 24 hours. Viewers always see the most recent snapshot; the interval only controls how often a new one is computed.
• Filters — narrow what the embed shows without changing the widget itself. For example, a Chart widget on your dashboard can show every deal stage, while its embedded version filters down to just "Won" deals. Click + Add filter, pick a field, operator, and value, then Apply filters.

Embed as an iframe¶

Copy the iframe snippet from the Embed dialog and paste it into your site's HTML:

<iframe src="https://app.tableview.se/embed/w/YOUR_TOKEN" style="width:100%;height:400px;border:0;" title="My widget"></iframe>

Adjust the width/height styles to fit where you're placing it.

Embed with a script tag¶

If you'd rather not manage an iframe by hand, copy the script snippet instead:

<div id="tv-embed-YOUR_TOKEN"></div>
<script src="https://app.tableview.se/embed.js" data-token="YOUR_TOKEN" data-target="tv-embed-YOUR_TOKEN" async></script>

The script finds the <div> by its id and injects a sized iframe into it. Two optional attributes control its size: data-width (default 100%) and data-height (default 400px). Omit data-target to have the widget inserted right after the script tag instead.

Rotate or turn off an embed¶

Open the widget's ⋮ menu → Embed again at any time to:

• Rotate link — replaces the token with a new one. The old link stops working immediately; use this if a link leaked somewhere you didn't intend.
• Turn off embedding — disables the embed entirely. Existing <iframe>/<script> tags on other sites will show that the embed has been turned off.

What's included in an embed¶

• Chart widgets show the same aggregated buckets as the live chart.
• Markdown widgets show the widget's current text (or, in "existing note" mode, the note's current content at the time of the last refresh).
• Map and Calendar widgets show only the specific record fields the widget itself uses — the pin location, event date, optional title, and optional measure — never a record's other fields. Nothing else from the underlying card is exposed.