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 PM