Anant Dalela
11/03/2026, 4:04 PMkapa.ai
11/03/2026, 4:04 PM@gooddata/sdk-ui-analytical-designer package provides an AnalyticalDesigner React component that renders the full editor inside your own React application, without an iframe. [Embed Analytical Designer]
> Note: The public API is marked @alpha, meaning its shape can change outside of the usual SemVer guarantees. Factor that in before depending on it in production. [API maturity]
Here's a minimal example:
import { AnalyticalDesigner } from "@gooddata/sdk-ui-analytical-designer";
import "@gooddata/sdk-ui-analytical-designer/styles/css/main.css";
import { BackendProvider, WorkspaceProvider } from "@gooddata/sdk-ui";
import { backend } from "./backend.js";
export function App() {
return (
BackendProvider backend={backend}
<WorkspaceProvider workspace="workspace-id">
div style={{ height: "100vh" }}
{/* Pass an insight ID to open an existing visualization, or omit it for a new one */}
<AnalyticalDesigner insight="visualization-id" />
/div
/WorkspaceProvider
/BackendProvider
);
}
[Embed Analytical Designer]
A few things to keep in mind:
• Only one instance per page — mounting a second AnalyticalDesigner while one is already mounted throws an error. [Embed Analytical Designer]
• Styles must be imported in the correct order — the SDK stylesheets need to come before main.css. [Embed Analytical Designer]
• Cache resets — if your backend uses caching, pass cacheReset so the catalog Refresh button and metric edits load fresh data. [Embed Analytical Designer]
So to directly answer your question: both options are available — iframe embedding and React SDK embedding. The React SDK approach gives you much more control (typed event callbacks, commands via a ref, slot customization, etc.), while the iframe approach is simpler to set up. [Embed Visualizations] 👍 0 button 👎 0 button ℹ️ Tip: Mention @kapa.ai in the thread for follow-ups.
👀 Our Support team monitors all messages and will jump in if needed.Yvonne Changamuka
11/03/2026, 4:41 PMAnant Dalela
11/09/2026, 9:09 PM@gooddata/sdk-ui-analytical-designer ?
Saw the release note here: gooddata.ai/docs/cloud/whats-new-cloud#…Yvonne Changamuka
11/09/2026, 9:56 PM@gooddata/sdk-ui-analytical-designer is the Analytical Designer application as a React component, as explained in our docs here. It looks and works the same as Analytical Designer in GoodData Cloud: the same catalog, drop zones, configuration panel, filters, and saving. You render it inside your own React application, on your backend instance, without an iframe.
Let me know if this helps.