Can you embed an HTML file in Notion?
Quick answer
Notion doesn't run HTML you paste into a page. Its embed block takes a web address ("this should start with https not <iframe"), a code block shows the code as text, and an uploaded .html file stays a file. To show a working page, publish the HTML file at a link and paste the link into Notion as a bookmark or an embed.
Free plan: no credit card, 1 published page.
On this page
You have an .html file, perhaps a dashboard, a report, or a small app that ChatGPT or Claude made, and you want it on a Notion page. Notion shows content from other sites in embed blocks and shows code in code blocks, but it doesn't run HTML you paste into a page. So the page needs an address of its own first. This guide gives what each Notion block does with HTML, from Notion's Help Center, read on November 20, 2026.
To give the file an address, drop it into the upload box at the top of this page: it gives a preview link without an account. That preview runs no scripts. Click Keep this page — free, no card and sign up, and the page moves into your account, where its scripts run and you can publish it at a link for Notion.
What each Notion block does with HTML
| What you try | Notion's block | What you get |
|---|---|---|
| Paste the HTML code | Code (/code) | The code as text, with syntax highlighting and a Copy button |
Paste an <iframe> tag | Embed (/embed) | Notion asks for the address itself: "this should start with https not <iframe" |
Upload the .html file | Embed > Upload, or File | A file people download. Notion lists PDF, audio, video, and images as the files it embeds |
| Paste the page's address | Embed, Bookmark, or a mention | The page in a frame, or a card with its title, if its host allows |
Notion embeds content "from over 1,900 domains via the Iframely service", and it adds: "Some websites prohibit their content from being embedded elsewhere. If you receive a Failed to Load error, that's why."
Show the code in a code block
When the reader needs the code itself, a code block is the right place:
- Hover over a new line, click +, choose Code, and press Enter. Or type
/code. - Click inside the block and paste the code.
- Click the language name at the top left and choose HTML.
Notion's help: code blocks "display code so that it's broken out from the rest of your content and formatted by language." The page doesn't run there.
Embed a page by its link
When the reader needs the page working, give Notion its address:
- Hover over a new line, click +, and choose Embed. Or type
/embed. - Paste the page's
https://address and press Enter.
To show a card instead, paste the address on an empty line and, in the menu that appears, select Paste as bookmark. Notion says bookmarks "appear like distinct blocks with the page title, description and URL displayed." Paste as mention puts the link inline, in the text.
A Convika page refuses to be shown in a frame on another site, so add it as a bookmark: one click opens the page at its own address, full screen, with its scripts and forms running. Notion also has preconfigured embeds for some apps, CodePen among them, for code that runs inside the frame.
Ways to put an HTML file in Notion, compared
| Way | What the reader sees | The page runs | On Notion's apps |
|---|---|---|---|
| Code block | The code, highlighted | No | The same code |
Uploaded .html file | A file to download | Only after they open it in a browser | A file to download |
| Embed by address | The page in a frame | Yes, if its host allows frames | Notion: "Embeds that require login to an external site will not work on Notion's desktop app or mobile apps" |
| Bookmark | A card with the page's title | Yes, at its own address | The same card, one tap away |
Publish the page on Convika and add it to Notion in 4 steps
Convika serves one .html or .htm file up to 2 MB, or pasted code, at a lasting link, with its HTML, CSS, and JavaScript as they are.
1. Get a preview link
Drop the file into the upload box at the top of this page, or paste the code, and click Get my preview link. You get a link in seconds, without an account. It works for 3 minutes, with scripts and forms off, so it's for checking the layout. If the page's CSS and images sit in a folder next to it, drop that folder, or a zip of it, and the box puts them inside the file.
2. Keep the page
Click Keep this page — free, no card and sign up. The page moves into your account, and its scripts run in the dashboard preview.
3. Publish it
Click Publish page. Under Who can open this page?, choose Public and click Next. The first time, click Publish free: the page goes live with a small Convika bar at the bottom. Under it, a second button buys the Pro pass ($5 once for 30 days, no auto-renewal) and publishes the page without the Convika bar. On Free, the page is Public: anyone with the link can open it, and it may show up in search results and in Convika's gallery. For a report only your team should open, choose Private link or Only people with the password (Pro) instead: How to password-protect an HTML page covers both.
4. Paste the link into Notion
Copy the page's address, such as yourpage.convika.page. In Notion, paste it on an empty line and select Paste as bookmark.
When the page changes, publish the new version in Convika: the link stays the same, so the bookmark in Notion opens the new page. Free includes 1 published page and 10,000 page views a month, and the dashboard shows how many people opened it.
Skipbox
Cheap & fast GitHub Actions runners, unlimited for $39 a month
Your own machine keeps Docker layers and package caches between jobs. Switch by changing one runs-on line.
Start a free Skipbox trialFrequently asked questions
Can you embed HTML in Notion?
Not as code. Notion's embed block takes a web address, not HTML, and its help says the link "should start with https not <iframe". A code block shows HTML as text without running it. Publish the HTML file at a link, then paste that link into Notion as an embed or a bookmark.
How do I embed an HTML file in a Notion page?
Uploading it through Embed > Upload gives a file to download, since Notion embeds PDFs, audio, video, and images. To show the page working, publish the file at an https:// address and paste that address into an Embed block, or paste it as a bookmark when its host refuses frames.
Can Notion run HTML code?
No. A code block shows the code "formatted by language", with a Copy button, and the page doesn't run. A working page needs its own address: an embed block shows it in a frame if its host allows, and a bookmark opens it in one click.
Why does my Notion embed say Failed to Load?
The site refuses to be embedded. Notion: "Some websites prohibit their content from being embedded elsewhere. If you receive a Failed to Load error, that's why." Paste the link as a bookmark instead. Also check that you pasted the address itself, starting with https, not an <iframe> tag.
How do I share an HTML report with my team in Notion?
Publish the report at a link, then paste the link into the Notion page as a bookmark. Everyone with access to the Notion page opens the report in one click, on a computer or a phone. To keep it to your team, publish it as a private link or behind a password.
Sources
- Embeds, bookmarks & link mentions (Notion Help Center) (no date on the page; read November 20, 2026)
- Code blocks (Notion Help Center) (no date on the page; read November 20, 2026)
Next step
How to password protect an HTML page or website
A JavaScript password script leaves the password in the page source. To password protect an HTML page or link, encrypt the file or let a server check it.
Related articles
- How to embed an HTML page in Confluence, on Cloud or Data CenterConfluence Cloud has no HTML macro; Data Center's is off by default. What Atlassian's docs say about the iFrame macro, Smart Links, attachments, and import.
- How to share an HTML file as a link that opens on any phoneUpload the file to a host and send its link; email and Google Drive send the code. 8 hosts compared, from Convika to Netlify Drop, with 4 steps.
- Share an HTML File in Slack as a Working PageSlack keeps HTML files as downloads or raw snippets. Publish report.html on Convika to paste a link that opens with working charts and stays out of Google.
- How to share a single-file HTML app from Claude Code with only your teamSharePoint and OneDrive download an HTML app instead of running it. Publish it behind a password, post one link, and update it at that link. No server.
- How to put an HTML file on a Google Sites pageGoogle Sites takes no .html upload. Paste the code under Insert > Embed > Embed code, use a full page embed, or link a button to the page at its own address.