WordPress Troubleshooting and F.A.Q

Keep in mind that the Disqus WordPress (WP) plugin is designed to replace your WP comment system wherever it is referenced within your templates. Any actions such as closing comments or removing references to the comment template within WP could result in Disqus not displaying properly.

Troubleshooting steps

Most WordPress irregularities are caused by theme or plugin conflicts. To test, we'd recommend the following:

  1. Reverting to a default WordPress theme
  2. Disabling all plugins
  3. Resetting the Disqus plugin - This can be done using the "Reset" button in the "Plugin Settings" menu within the Disqus WP plugin. A step-by-step guide is available here. Reset button

Commenting embed not appearing, or isn't loading

Disqus loads its javascript from external files. Some plugins and services for your site aren't compatible with this, and you can try disabling Render Javascript in external files under Advanced Options in Disqus "Plugin Settings". This will render the javascript directly in your page markup and should fix this.

Comment counts not working, or code showing up in other plugins

Enable the Comment Counts checkbox under Advanced Options in Disqus "Plugin Settings". This will output Disqus JavaScript in the footer to fix this. NOTE: This only applies when the javascript is not being output in external files.

Missing comments form or "Comments closed" error

Make sure comments are enabled within WordPress itself. See WordPress' Enable and Disable Comments guide.

Common conflicting themes/plugins:

Possible conflicting themes/plugins:

If none of the above conflicts are causing the issue, it may be a conflict in your browser, please see Browser plugin/extension conflicts for more information.

If you've encountered an error message

Visit the Error Message FAQ to see if the error is listed.

WordPress F.A.Q.

Can Disqus be used on WordPress.com?

Disqus can currently be used only on self-hosted WordPress sites (i.e., using the WordPress.org software); WordPress does not allow plugins on WordPress.com-hosted sites. Per WordPress' documentation on plugins:
Plugins are tools used to extend the functionality of the WordPress platform. However, they are only applicable to self-hosted blogs and web sites using the WordPress.org software. Plugins are not permitted here at WordPress.com for various security reasons.

More information on how to use Disqus in conjunction with WordPress can be found at WordPress' documentation on plugins.

Is Disqus free to use on my site?

Yes! Disqus is free to use. We also provide subscription plans for larger, commercial sites that want access to more powerful moderation and audience tools and customization.

How do I customize the look-and-feel of Disqus?

Disqus automatically checks your site's font and background color and adapts to either a light or dark color scheme, along with a serif or sans-serif font. If these are detected incorrectly, you can override them in your Settings.

Will I lose comments if I deactivate Disqus?

The Disqus for WordPress plugin automatically syncs comments back to WordPress. These comments will remain in WordPress should Disqus be deactivated or removed. You can also export your comments from Disqus at any time.

Can I import my existing WordPress comments into Disqus?

Yes, you can import your existing WordPress comments into Disqus during installation.

How do I set up Single Sign-On (SSO)?

SSO allows users in your database to comment without requiring them to register with Disqus. Access to SSO is currently available as an add-on for users with a Pro subscription. Also check out our guide for setting up SSO on WordPress.

Did you find this article helpful?