Skip to main content

​
Limitations

  • Users who view the Omni iframe in a Notion document must be Omni users. The first time users in Notion view the Omni iframe, they will need to authenticate to Omni to view the dashboard content.
  • While not required, viewing the Omni iframe in Notion works best on the web version of Notion.

​
Requirements

To follow this guide, you’ll need:
  • Permissions in Omni that allow you to access the dashboard you want to embed
  • Permissions in Notion that allow you to create and edit documents
Note: Users who view the Omni iframe in Notion must have permissions in Omni that allow them to view the dashboard being embedded.
1

Retrieve the dashboard's embed URL

  1. In a published Omni dashboard, click Share to open the share modal:
  2. Click the Copy button next to the <iframe> field to copy the URL.
  3. In a text editor, only copy the Omni URL. For example, if you copied a string like the following: 
    <iframe src="https://omni.test.embed-exploreomni.dev/dashboards/demo-dash"></iframe>
    You will only want the URL: 
    https://omni.test.embed-exploreomni.dev/dashboards/demo-dash
2

Create an embed component in Notion

  1. In a Notion document, use the /embed command to create an embed component.
  2. Paste the Omni URL into the field:
  3. Click Embed link.
3

Test the iframe

Your Omni dashboard should now be embedded in Notion! 🎉Before you share the Notion document with other users, make sure that you can view the dashboard by logging out of Omni and then back in again. This allows you to check that the dashboard displays correctly after authentication.
4

Share the Notion document

Share the Notion document with other users in your Notion instance. Note: Users will have to authenticate with Omni before they can view the dashboard content.