Add Comments to Your Drupal Site
This is the official Drupal Module for FastComments.
A Drupal module that integrates FastComments with Drupal 10/11, providing widget blocks, entity field integration, SSO, and granular permissions.
Repository
Installation 
- Place this module in your Drupal site's
modules/custom/fastcomments/directory (or install via Composer:composer require drupal/fcom). - Enable the module:
Or enable via the admin UI at Extend (drush en fastcomments/admin/modules).
Configuration
Navigate to Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).
Settings
- Tenant ID (required) - Your FastComments Tenant ID. Find this under Settings > API/SSO (EU).
- API Secret - Required for Secure SSO, webhook verification, and page sync. Found under Settings > API/SSO (EU).
- SSO Mode - Single Sign-On integration:
- None - No SSO, users comment as guests or create FastComments accounts.
- Simple - Passes Drupal user info (name, email, avatar) to FastComments without server-side verification.
- Secure - Uses HMAC-SHA256 verification to securely authenticate Drupal users with FastComments (recommended).
- Commenting Style - The type of widget to display:
- Live Comments - Real-time threaded comments.
- Streaming Chat - Live chat interface.
- Collab Chat - Collaborative text-selection annotation on the main content area.
- Collab Chat + Comments - Both collab chat and standard comments.
- CDN URL - FastComments CDN URL (default:
https://cdn.fastcomments.com). - Site URL - FastComments site URL (default:
https://fastcomments.com). - Email notifications - Send an email to content authors when a new comment is posted on their content.
Adding Comments to Content Types
Add the FastComments field to your content types via Structure > Content types > [type] > Manage fields. The field has a status toggle and an optional custom identifier per entity.
EU Data Residency
For EU data residency, update:
- CDN URL to
https://cdn-eu.fastcomments.com - Site URL to
https://eu.fastcomments.com
Widget Blocks
Several blocks are available via Structure > Block layout (/admin/structure/block):
- FastComments Widget - The main commenting widget. Auto-detects the current entity. Skips entities that already have the FastComments field (to prevent duplicates).
- FastComments Live Chat - Real-time streaming chat. Can be placed alongside the comment field on the same page.
- FastComments Collab Chat - Text-selection annotation and discussion.
- FastComments Image Chat - Coordinate-based annotation on images.
- FastComments Recent Comments - Displays recent comments across your site. Configurable comment count.
- FastComments Top Pages - Shows pages with the most comments.
Content-centric blocks (Live Chat, Collab Chat, Image Chat) auto-detect the current entity and fall back to a path-based identifier on non-entity pages.
Multilingual
The module automatically passes the current Drupal site language to all widgets.
Permissions
- Administer FastComments - Access to the FastComments settings form.
- View FastComments - Required to see the commenting widget.
- Toggle FastComments - Allows users to enable/disable comments per entity via the field widget.
How It Works
When a user visits an entity with the FastComments field enabled:
- The FastComments JavaScript widget is loaded from the CDN.
- If SSO is configured, the user's Drupal identity is passed to FastComments.
- A
<noscript>fallback provides server-rendered comments for users without JavaScript (Live Comments and Streaming Chat modes only).
Requirements
- Drupal 10 or 11
- PHP 8.1+
- A FastComments account
Need Help?
If you encounter any issues or have questions about the Drupal Module, please:
Contributing
Contributions are welcome! Please visit the GitHub repository for contribution guidelines.