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.
Installation Tutorial Video
Most WordPress irregularities are caused by theme or plugin conflicts. To test, we'd recommend the following:
- Reverting to a default WordPress theme
- Disabling all plugins
Common conflicting themes/plugins:
- Thesis 2.0 (theme) - Resolution for this conflict
- Twenty Thirteen (theme) - Resolution for this conflict
- MailChimp's Social Plugin
- Facebook Connect
- GeoDirectory (plugin) - Resolution for this conflict
Possible conflicting themes/plugins:
- HTTP / HTTPS Remover - (To resolve, use Make Paths Relative instead)
- Spam Free Wordpress plugin
- Root Relative URLs
- Google Friend Connect Plugin
- Headway (theme) - Resolution for this conflict
- Hatch (theme) - Have a fix for this? Let us know!
- Hybrid 1.2 (theme) - Have a fix for this? Let us know!
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.
If Syncing is not working in version 3.x
1. Check the webhook link here: https://YOURSITE.com/wp-json/disqus/v1/sync/webhook
If that link is not returning anything or not loading, something is blocking outside sources like Disqus from making requests to your site.
If the REST API is blocked for Disqus or your entire site, you’ll want to ensure that it is enabled. You can follow instructions here to enable REST API and troubleshoot why it may not be enabled:
More general information on the REST API may be found here: https://v2.wp-api.org/
2. This may also be caused by a conflict with ones of your current plugins (often a security plugin). You can test this by temporarily disabling all plugins except Disqus. (These are not permanent recommendations; they are simply to help isolate the issue.) Once all themes (or the suspected themes) have been disabled, try to click the Syncing option within the Disqus plugin to sync your comments.
Specific conflicting themes that we've identified so far:
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.
How can I install an older version of the plugin?
Do install an older version (before the major 3.0+ update), go to https://github.com/disqus/disqus-wordpress/releases/tag/2.86 to download version 2.6. For more information on how to install, see WordPress' Managing Plugins. Use this version only if you have trouble with the current plugin.