Docs menu
Disfora documentation
What is Disfora?
Disfora is a comment system you add to a website with one script tag. It shows comments, star ratings, polls and forms on your pages, and gives you a dashboard to moderate and manage them. It works on any site where you can edit the HTML: a static site, a CMS like Ghost or Webflow, or an app built with a framework like Next.js. On WordPress, the plugin sets it up for you.
It's funded by paid plans rather than advertising, so the widget shows no ads and doesn't track readers for advertisers. Your first site is free.
How it works
You add the script once and an empty element, called a container, wherever a widget should appear:
<script src="https://disfora.com/public/disfora.js" async></script>
<div data-disfora-ratings></div>
<!-- your article -->
<div data-disfora-comments></div>
- The script asks Disfora which project the page belongs to, using the page's domain.
- It downloads the code for the widgets the page has containers for, and nothing else.
- Each widget is drawn inside its container, as part of your page rather than in an iframe. It sits in its own shadow root, so your site's CSS and the widget's CSS don't affect each other. Colours, font and corners come from your project's settings.
- Comments and ratings belong to the page's address, so every post gets its own thread.
The widget only loads on domains you've proven you own, with a DNS record, a file or a meta tag. You can also
serve it from a subdomain of your own, like comments.yoursite.com, so readers' sign-in cookies
belong to your site.
What readers get
- Comments with threaded replies, Markdown, @mentions, GIFs and votes.
- One account for every Disfora site. Readers sign in with Google or an email code, once.
- Guest comments, if you turn them on: readers comment with just a name, and you approve each one.
- Clout: a public win and loss record from the votes on their comments, carried across sites.
- Notifications for replies and mentions, with a setting for each kind.
- Star ratings, one per reader per page, so the average reflects real readers.
- Polls with single or multiple choice, and forms that submit without leaving the page.
What you manage
Each site is a project in your dashboard. For each project you get:
- A moderation queue for comments held for review, plus pins and locks on the widget itself.
- Banned keywords for words, phrases, email addresses, phone numbers and patterns, set to block or warn.
- Bans and shadow bans for readers who keep causing trouble, and an audit log of who did what.
- Automations (paid plans): rules that warn or stop the writer before they post.
- Polls and forms, built in the dashboard, with live poll results and form submissions you can export as CSV.
- Webhooks that send comments, ratings and form submissions to your own systems as signed POST requests.
- Styles for the widget's colours, font and corners.
- Team roles (Team plan): owners, managers, editors and viewers.
- Import from Disqus or Commento, with replies, author names and dates.
Plans
The free plan covers one site with comments, ratings, polls, forms, moderation tools and webhooks, and shows a small Disfora link. Paid plans add sites, automations and email alerts for form submissions, remove the Disfora link, and on the Team plan, let you invite a team. See pricing.
Using these docs
- New to Disfora? Start with Installation. It covers every site.
- Using a specific platform? The platform guides show where the script and the container go on Astro, Docusaurus, Gatsby, Ghost, Hugo, Jekyll, MkDocs, Next.js, Squarespace, Webflow and WordPress.
- Beyond comments, the feature pages cover star ratings, polls, forms, styles and webhooks.
- Moving from Disqus or Commento? Migrate from Disqus brings your comments with you, and covers Commento exports too.
- Every page ends with a comment thread. Ask there, or contact us.
Ask a question
Something missing or unclear? Ask here and we'll answer in the thread.
Updated October 2026