Docs menu
Replace WordPress comments with the Disfora plugin
Before you start
- A Disfora account. You can create one, free, while you connect: the plugin sets up the project for your site.
- WordPress 6.0 or later. On WordPress.com, a plan that lets you install plugins.
1. Install the plugin
In WordPress admin, open Plugins → Add New Plugin, search for Disfora, then click Install Now and Activate. You can also download it from wordpress.org/plugins/disfora and upload the zip under Plugins → Add New Plugin → Upload Plugin.
2. Connect your site
Open Settings → Disfora and click Connect with Disfora. Sign in, or create an account, and Disfora looks for a project with your site's domain:
- If you already have one, confirm it and the plugin connects to it.
- If you don't, Disfora creates one for your domain. The free plan includes one site.
You're sent back to WordPress. The plugin proves you own the domain by publishing a verification meta tag and file on your site. When it says Connected. Disfora is now live on your site., open a post to see the comments.
3. Choose where comments show
Disfora appears where your theme shows WordPress comments, in classic themes and block themes. Under Settings → Disfora:
- Show Disfora in place of WordPress comments is on by default. Turn it off to show Disfora only where you add the block or a shortcode.
- Replace comments on picks the post types that use it: posts and pages by default, and custom post types like products or docs.
To keep WordPress comments on a single post, tick Use WordPress comments on this page instead of Disfora in the Disfora box in the editor sidebar.
Many themes hide the comment section on posts with comments turned off. If a post shows nothing, open comments in the post's Discussion settings, or add the Disfora block to it.
Ratings, polls and forms
Add the Disfora block in the block editor and pick what it shows, or paste a shortcode into any post, page or widget:
| Shortcode | Shows |
|---|---|
[disfora] |
The rating and comments together |
[disfora_comments] |
Comments |
[disfora_ratings] |
A star rating for the page |
[disfora_poll id="…"] |
A poll |
[disfora_form id="…"] |
A form |
Create polls and forms in your Disfora dashboard. For the id, paste the poll's or form's id, or the whole code from its Copy embed code button. If a post already has comments from the block or a shortcode, the comment section at the bottom stays empty, so the thread never shows twice.
Moderation, colours and fonts are set in the dashboard: click Open Disfora dashboard on the settings page. See Styles.
Your existing comments
WordPress comments stay in your WordPress database. They're hidden on posts that use Disfora and come back if you switch a post, or the whole site, back to WordPress comments. The plugin doesn't copy them into Disfora. To keep an older post's discussion on show, switch that post back with the box in the editor sidebar.
Coming from the Disqus plugin? Deactivate it, then import your Disqus export. The comments land under the same posts.
If verification fails
If the plugin says Connected, but Disfora couldn't confirm you own this domain yet, Disfora couldn't read the proof from your site. Comments don't load until it does. The usual causes:
- A page cache (a caching plugin, your host's cache or Cloudflare) serving an old copy of your homepage. Clear it.
- A firewall or security plugin blocking Disfora's request. Allow it through.
- A site that isn't public, such as a local install, a password-protected staging site or maintenance mode. Disfora has to reach your site, so connect from the live one.
Then click Retry verification on the settings page.
Turning it off
Click Disconnect on the settings page, or deactivate the plugin, and your theme's WordPress comments come back. Your Disfora comments stay in your Disfora project, so connecting again brings them back. Deleting the plugin also removes its settings.
Ask a question
Something missing or unclear? Ask here and we'll answer in the thread.
Updated October 2026