Deze pagina is nog niet vertaald en wordt daarom in het Engels getoond.

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.

Get a link for my HTML file

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 tryNotion's blockWhat you get
Paste the HTML codeCode (/code)The code as text, with syntax highlighting and a Copy button
Paste an <iframe> tagEmbed (/embed)Notion asks for the address itself: "this should start with https not <iframe"
Upload the .html fileEmbed > Upload, or FileA file people download. Notion lists PDF, audio, video, and images as the files it embeds
Paste the page's addressEmbed, Bookmark, or a mentionThe 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:

  1. Hover over a new line, click +, choose Code, and press Enter. Or type /code.
  2. Click inside the block and paste the code.
  3. 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.

When the reader needs the page working, give Notion its address:

  1. Hover over a new line, click +, and choose Embed. Or type /embed.
  2. 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

WayWhat the reader seesThe page runsOn Notion's apps
Code blockThe code, highlightedNoThe same code
Uploaded .html fileA file to downloadOnly after they open it in a browserA file to download
Embed by addressThe page in a frameYes, if its host allows framesNotion: "Embeds that require login to an external site will not work on Notion's desktop app or mobile apps"
BookmarkA card with the page's titleYes, at its own addressThe 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.

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.

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 trial⁠

Frequently 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

Turn your HTML file into a link for Notion

Upload the file once and publish it, scripts and all. Paste the link into Notion, and your team opens the working page in one click.

Get a link for my HTML file

Free plan: no credit card, 1 published page.