Skip to content

Commit aa331de

Browse files
Merge pull request #241 from nocodb/docs/iframe
2 parents 12636db + 1f0e445 commit aa331de

File tree

5 files changed

+69
-1
lines changed

5 files changed

+69
-1
lines changed

content/docs/dashboards/index.mdx

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -68,5 +68,6 @@ The following widget types are available:
6868
| **[Pie Chart](/docs/product-docs/dashboards/widgets/pie-chart)** | Visualizes parts of a whole |
6969
| **[Donut Chart](/docs/product-docs/dashboards/widgets/donut-chart)** | Pie chart variant with a hollow center |
7070
| **[Text](/docs/product-docs/dashboards/widgets/text)** | Displays static text |
71+
| **[iFrame](/docs/product-docs/dashboards/widgets/iframe)** | Embeds external web content |
7172

7273
---
Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
---
2+
title: 'iFrame'
3+
description: 'Embed external content securely inside your dashboard using the iFrame widget'
4+
---
5+
6+
The **iFrame** widget in NocoDB allows you to embed external web pages, applications, or dashboards directly inside your NocoDB dashboard. This is useful for integrating third-party tools, live reports, charts, or any web resource you want to monitor alongside your database data.
7+
8+
![iframe-widget](/img/v2/dashboards/widget-iframe.png)
9+
10+
11+
## Configuration
12+
13+
- **URL**
14+
Enter the web page URL you want to embed.
15+
> ⚠️ Only a limited set of **whitelisted domains** are supported. If the URL does not belong to a whitelisted domain, it cannot be embedded.
16+
17+
- **Parameters**
18+
You can pass query parameters to control the embedded page. For example:
19+
```
20+
https://app.nocodb.com/sharedViewID?disableTopbar=true&disableToolbar=false
21+
```
22+
23+
## Supported Whitelisted Domains
24+
The following domains other than NocoDB are supported for embedding:
25+
26+
- Airtable
27+
- Canva
28+
- ClickUp
29+
- CodePen
30+
- DBdiagram
31+
- Diagrams.net
32+
- Descript
33+
- Dropbox
34+
- Figma
35+
- Framer
36+
- GitHub Gist
37+
- GitLab Snippet
38+
- Gliffy
39+
- Google (Maps, Drawings, Drive, Docs, Sheets, Slides, Calendar, Forms, Looker Studio)
40+
- Grist
41+
- Instagram
42+
- Loom
43+
- Lucidchart
44+
- Marvel
45+
- MindMeister
46+
- Miro
47+
- Prezi
48+
- Scribe
49+
- Spotify
50+
- Tldraw
51+
- Trello
52+
- Typeform
53+
- Valtown
54+
- Vimeo
55+
- Pinterest
56+
- Whimsical
57+
- YouTube
58+
59+
## Use Cases
60+
61+
- Embedding analytics dashboards (e.g., Metabase, Grafana, Superset).
62+
- Displaying Google Docs, Sheets, or Slides within NocoDB.
63+
- Showing interactive charts or visualizations from allowed external apps.
64+
- Integrating custom internal tools from whitelisted domains.
65+

content/docs/dashboards/widgets/index.mdx

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,7 @@ NocoDB dashboards support the following widget types:
1313
| **[Pie Chart](/docs/product-docs/dashboards/widgets/pie-chart)** | Visualizes parts of a whole |
1414
| **[Donut Chart](/docs/product-docs/dashboards/widgets/donut-chart)** | Pie chart variant with a hollow center |
1515
| **[Text](/docs/product-docs/dashboards/widgets/text)** | Displays static information |
16+
| **[iFrame](/docs/product-docs/dashboards/widgets/iframe)** | Embeds external web content |
1617

1718

1819
### Adding Widgets

content/docs/dashboards/widgets/meta.json

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,8 @@
33
"number",
44
"text",
55
"pie-chart",
6-
"donut-chart"
6+
"donut-chart",
7+
"iframe"
78
],
89
"title": "Widgets"
910
}
485 KB
Loading

0 commit comments

Comments
 (0)