Disfora
Docs menu

Replace WordPress comments with the Disfora plugin

The Disfora plugin replaces your theme's comment section with Disfora. Install it, click Connect, and every post gets its own thread. There's no code to paste and no domain check to do by hand.

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