How to add comments to Notion Sites
What is Notion Sites?
Notion Sites allows you to publish Notion pages as public websites. Whether you're building a documentation, wiki or simple website, Notion Sites handles the heavy lifting of converting your content into clean, performant HTML.
Why add comments to your Notion Sites site?
Adding comments brings your blog to life by letting readers discuss your posts. Comments show your content resonates with real people. They improve SEO with fresh user-generated content and help you learn what your audience wants.
Chirp Form gives you a simple solution that works perfectly with Notion Sites's static architecture while respecting visitor privacy with EU hosting and GDPR compliance.
How Chirp Form works with Notion Sites
Chirp Form uses two elements: <chirp-form> for submitting comments and <chirp-feed> to display them. Chirp Form handles everything behind the scenes. It stores submissions, filters spam and sends email notifications while your Notion Sites site stays completely static. Submissions are identified through privacy-friendly cryptographic hashing rather than storing IP addresses or personal data directly.
Installation steps
Step 1: Add the Chirp Form script
Add the Chirp Form script to your Notion Sites layout file. For most sites this goes in Any page with embed block in the <head> section:
<head>
<!-- Your existing head content -->
<script defer src="https://embed.chirpform.com/latest/chirpform.umd.js"></script>
</head>
The defer attribute ensures the script loads without blocking your page content.
Step 2: Add to your post layout
Add both Chirp elements to any published page or blog post. Create two embed blocks at the bottom of your page:
- Add a heading:
## Comments - Type
/embedand add:
<chirp-form form-id="YOUR_FORM_ID"></chirp-form>
- Type
/embedagain and add:
<chirp-feed form-id="YOUR_FORM_ID" filter-url="current"></chirp-feed>
The filter-url="current" ensures comments are unique to each page. Replace YOUR_FORM_ID with your actual form ID from your Chirp Form dashboard.
Step 3: Configure your form (optional)
You can fully customize your form fields through your Chirp Form dashboard. The form automatically fetches your configuration and renders everything you've set up.
For styling, you can fully customize the appearance using standard CSS. Check the styling documentation for detailed customization options.