Knowledge base Turn Notion into a knowledge base on your website
If your team already writes help articles in Notion, you don't need a second tool to publish them. Keep writing in Notion and show the same pages as a knowledge base on your website or inside your app.
This guide covers how to structure a knowledge base in Notion, how to put it on your site with NotionHero, and what to know before you start.
Why run your knowledge base in Notion
- One place to write. Support and product teams edit articles where they already work.
- No copy-pasting. Your site shows the Notion page, so there is only one version of each article.
- Rich content for free. Headings, toggles, callouts, images, videos, tables and databases all come along.
How to structure it in Notion
Start with one home page and make each category a sub-page, for example Getting started, Account and billing and Troubleshooting. Put each article inside its category as its own page.
For larger knowledge bases, use a Notion database of articles with properties like Category and Last updated, and show it as a list or gallery on the home page.
Title articles the way customers ask the question: “How do I change my billing email?” is easier to find than “Billing settings”.
How visitors use it
Visitors browse your knowledge base without leaving your site. Links to sub-pages open inside the embed, with breadcrumbs to go back up a level.
Put it on your website in 3 steps
- Share the page from Notion. Open the page in Notion, click Share, turn on Share to web and copy the link.
- Add it to NotionHero. Paste the link into NotionHero and pick the look: cover image, dark mode, or your own CSS on the Heroic plan.
- Paste the embed code into your site. Copy the snippet into WordPress, Webflow, Wix, Squarespace, Ghost or your own app. It resizes to fit the page.
The embed code looks like this:
<iframe src="https://e.notionhero.io/e1/p/your-page"
width="100%" height="600" style="border:0" data-notionhero-autoheight></iframe>
<script async src="https://e.notionhero.io/embed.js"></script>
Put your knowledge base on your site
Free for up to 3 embeds. No credit card needed.
Frequently asked questions
Do I need to write code?
No. You paste one snippet into your website builder, the same way you would add a YouTube video.
How quickly do edits show up on my site?
Free embeds refresh from Notion every 3 days. On the Heroic plan they refresh every hour, and you can refresh by hand right after you publish a change.
Can visitors search the knowledge base?
Not inside the embed yet. Group articles into categories and a database view so they're easy to scan.
Does embedded content help my own site's search ranking?
Search engines treat embedded content as a separate page, so your articles won't add to your own site's ranking. The embed is built for visitors who are already on your site or in your app.
Does my Notion page have to be public?
Yes. NotionHero reads pages that are shared to the web, so anyone with the notion.site link can also read them there. Don't put private information in a public knowledge base.