Embedding Dashboards & Widgets

AgenticBI lets you embed dashboards and widgets into external websites and applications using either a public share URL or a simple iFrame embed code. Both are available on the Team plan.

Two options are available on the Team plan:

A small AgenticBI watermark is included on embeds. To remove the watermark, customize the iFrame chrome, or use SSO / secure encrypted embeds / a white-label JavaScript SDK, you'll need the AgenticBI Enterprise plan -- contact us to upgrade.

Getting Started

AgenticBI's basic embed lets you drop a live dashboard or widget into another web page with a single URL or iFrame. The dashboard refreshes the same way it does inside AgenticBI -- viewers see your latest data without an account.

Key concepts

Shareable URL: A public URL that renders the dashboard or widget in any browser. Anyone with the URL can view the embed.

Embed code: An iFrame snippet (HTML) that wraps the shareable URL so you can drop the embed into a webpage, blog, or internal portal.

URL parameters: Optional query-string parameters appended to the shareable URL to filter the data shown or apply a theme.

Note: Basic embeds are publicly accessible -- anyone with the URL can view the dashboard. Don't use the simple URL share for data you wouldn't otherwise post on a public page. For embeds that authenticate the viewer or filter data per user, use the AgenticBI Enterprise plan's SSO / secure-hash options.

URL Embed

Simple URL Share and Embed

Use this option to share or embed a dashboard for public access without security.

To enable a public share URL, click the menu icon in the top right of the dashboard, select Sharing Options, toggle on Shareable URL, and click Save Changes. The embed code can also be used to embed the dashboard into your own portal or HTML pages. To disable the URL, return to Sharing Options and toggle it off.

Full URL example:

https://app.agenticbi.com/d/3cKltxiizxNFgxjRvanZwY2WZoiikPo5ip3EqS13cii1KdQie

Filtering a Shared URL

Append a contentFilters parameter to a shareable URL to open the dashboard or widget pre-filtered, for example to a single customer or date range.

Note: Filter values in a shareable URL are visible and can be edited by anyone with the link. Use them for convenience, not security. Encrypted filters that viewers cannot change require the AgenticBI Enterprise plan's Secure URL Embed.

contentFilters takes a JSON array. Each object in the array is one filter:

[{"fieldName":"customer","values":["Costco"],"operator":"="}]
Key Description
fieldName The field to filter on. Must match the field name in the dataset exactly, including case.
values Always an array, even for a single value. Quote strings (["Costco"]) and leave numbers unquoted ([90000]).
operator One of the supported operators below. Case sensitive.

Important: A fieldName that does not match a field on the dataset is ignored, and the dashboard shows unfiltered data with no error. Before sending a link that is meant to narrow the data, open it and check that the row count matches what you expect.

URL encode the whole JSON string and append it to the URL. Keep the full URL under 6,000 characters. Longer URLs fail with an HTTP 413 error.

https://app.agenticbi.com/d/<dashboardShareId>?contentFilters=%5B%7B%22fieldName%22%3A%22customer%22%2C%22values%22%3A%5B%22Costco%22%5D%2C%22operator%22%3A%22%3D%22%7D%5D

Supported operators

Important: Operators are case sensitive and must match exactly. An unrecognized operator, such as IN, LIKE, <> or a typo, does not cause an error. It is treated as =, so the dashboard loads normally but shows the wrong rows.

Operator Description
=, != Equals or does not equal the value. Case sensitive.
in, not in Matches, or excludes, any value in the array.
like, not like Contains, or does not contain, the value. Case insensitive, except on datasets stored in an external SQL data store, where case sensitivity follows that database.
Starts With Begins with the value. Title case. Not supported on datasets stored in an external PostgreSQL, MySQL, Redshift or Snowflake data store, where this filter is ignored. Use like there instead.
>, >=, <, <= Number and date comparisons. Only the first value in the array is used.
range Between a start date and an end date, including both days in full: "values":["2026-07-25","2026-07-28"]. For number ranges, use >= and <= instead.
is null, is not null Field is empty, or has a value. Use an empty values array: "values":[].

Operator support can differ by datasource type, so test links against your own data before sharing them.

Combining filters: All filters in the array are combined with AND. To match one value OR another on the same field, put the values in a single in filter.

Date ranges: Use range to include both the start and end dates in full:

[{"fieldName":"Sent Date","values":["2026-07-25","2026-07-28"],"operator":"range"}]

If you use two filters instead, use < with the day after your last day as the upper bound. A date without a time is read as midnight, so <= leaves out rows from later in the last day. On a dashboard link, dates are read in the dashboard owner's timezone and the viewer's timezone has no effect. On a widget link, a signed-in viewer's own timezone is used.

Empty results: A value that does not exist in the data returns an empty dashboard with no error. Check spelling and capitalization first.

Embedding with iFrame

The easiest method for embedding an AgenticBI display (dashboard or visualization) is with the copy-paste embed code. Navigate to a dashboard or visualization in AgenticBI and copy the Embed Code from the Share option.

Once acquired, this code can be pasted into HTML. This method is useful for simple embeddings, such as embedding into websites, blogs, or internal knowledge bases.

Embedding with an iFrame

<iframe width="1280" height="960" src="https://app.agenticbi.com/d/YOUR_SHARE_URL" frameborder="0" allowfullscreen></iframe>

What's available on the Enterprise plan

The AgenticBI Enterprise plan unlocks advanced embedding options that aren't available on Team:

  • Secure URL Embed -- encrypted query parameters so viewers can only see the data you allow.
  • Single Sign-On (SSO) -- pass your application's logged-in user identity into AgenticBI so embeds respect each viewer's permissions and content filters.
  • JavaScript Embed API -- programmatic embed with custom CSS, theme switching, view options, filters, and interactive controls.
  • White-label -- remove the AgenticBI watermark and brand the embedded experience as your own.
  • Multi-tenancy -- workspace-based isolation and row-level security for SaaS embedding scenarios.
  • Embedding without cookies -- token-based session handling for third-party-cookie-blocked browsers.

Contact us to enable these.