Skip to main content
Last updated on

Embed a Genie space

Beta

This feature is in Beta. Workspace admins can control access to this feature from the Previews page. See Manage Databricks previews.

You can embed a Genie space as an iframe in an external website or application. This lets business users interact with Genie directly within your internal tools or portals without navigating to Databricks.

Requirements​

Before you can embed a Genie space, the following must be in place:

  • Workspace admin: Must configure allowed embedding surfaces in Genie access management settings.
  • Space author: Must have at least CAN MANAGE permission on the Genie space.
  • End users: Must have explicit access to the Genie space and the underlying data assets it uses. Users who are not signed in to Databricks are prompted to authenticate before they can interact with the embedded space.
note

Embedded Genie space users can send prompts but cannot edit the space configuration.

Step 1: Enable the feature preview​

A workspace admin must enable Embed Genie as an iframe from the Previews page before the feature is available in the workspace.

Step 2: Configure allowed embedding surfaces​

A workspace admin must configure allowed embedding surfaces before a Genie space can be embedded. See Manage dashboard and Genie space embedding.

Step 3: Generate the iframe code​

After an admin has configured allowed surfaces, space authors can generate the iframe embed code.

  1. Open the Genie space you want to embed.
  2. Click Share.
  3. In the Share dialog, click Embed space.
  4. Copy the generated iframe code.

Step 4: Add the iframe to your application​

Paste the iframe code into your external website or application.

To enable full functionality, including copying CSV data and copying conversation links, add the allow="clipboard-write" attribute to the iframe element:

Html
<iframe src="<your-genie-space-url>" allow="clipboard-write" width="100%" height="600"></iframe>

Best practices​

  • Grant explicit data access: Make sure end users have access to both the Genie space and all underlying data assets used by the space. Users only see data they have permission to access.
  • Enable clipboard access: Include allow="clipboard-write" on the iframe element so users can copy query results and conversation links.
  • Limit allowed surfaces: Only add domains to the allowed embedding surfaces list that you trust and control.