> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wisdom.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Embed a Dashboard

This guide outlines the process for embedding a WisdomAI Dashboard into your application. Before proceeding, make sure you've reviewed the [Embeddings Overview](/integrations/embeddings/embedding) for authentication setup and security requirements.

<Note>
  The API and embed URL examples use `<customer>.wisdom.ai` as a placeholder. Replace it with the base URL of your WisdomAI tenant — the same domain you use to log in. Both `wisdom.ai` and `askwisdom.ai` are valid depending on your deployment.
</Note>

## Construct the embed URL

Construct the special embed URL for your Dashboard and append the newly generated JWT in the authentication stage.

1. Take your original Dashboard URL and insert `/embed/` before the Dashboard's name and ID.
2. Append the JWT as a `token` query parameter. The URL should look like the following:
   * **Original URL**: `https://<customer>.wisdom.ai/dashboards/name-id`
   * **Final Embed URL**: `https://<customer>.wisdom.ai/dashboards/embed/name-id?token=<JWT_FROM_STEP_1>`
3. You can now use this URL as the `src` for an `<iframe>` in your application:
   ```html theme={null}
   <iframe
     src="https://<customer>.wisdom.ai/dashboards/embed/name-id?token=<JWT_TOKEN>"
     style="width: 100%; height: 100%; border: 0;" />
   ```

<Note>
  **URL Update: Story to Dashboard**

  The embedding URL has been updated to use `/dashboards/` instead of `/stories/`.

  If you are currently using an older URL containing `/stories/`, it will continue to work and does not require immediate replacement.
</Note>

## Controlling edit permissions with RBAC

Embedded dashboards reflect the user's RBAC role. To hide edit buttons and prevent modifications in your embedded view, assign the user the **Viewer** role when creating them. There is no separate embed-specific parameter for this.

See [RBAC for Embedded Users](/integrations/user-management/rbac) for instructions on assigning roles and a full breakdown of what each role controls in the embedded interface.

## Validation

To validate that the process worked, open the final embed URL in your browser. The WisdomAI Dashboard should load correctly without prompting for a login. If you encounter an error, please refer to the troubleshooting steps below.

## Next steps

<CardGroup cols={2}>
  <Card title="Embed Chat" icon="message" href="/integrations/embeddings/iframe/embed-chat">
    Discover how to embed conversational AI chat interfaces
  </Card>

  <Card title="Impersonate User API" icon="user" href="/integrations/graphql-api/mutations/auth/impersonate-user">
    Detailed documentation for the authentication API
  </Card>
</CardGroup>