
Language 🇺🇸 English (US)
Getting Started
Widget Styling
Other Frontend Libraries
Custom Styling Guide
This guide provides the complete default CSS used by the FastComments commenting widget (v2) and some instructions for overriding the styles.
Understanding the default CSS allows you to:
- Customize the appearance by overriding specific styles
- Troubleshoot styling issues by seeing which classes and selectors are available
- Build custom themes that work with the widget's structure
- Use with AI assistants to generate custom CSS modifications.
How to Override Styles
Overriding styles varies based on the widget. For the comment widget, you have to use the customCSS config parameter to
pass the CSS into the iframe, or specify the CSS in the Customization page in the admin dashboard which will serve the CSS
from our CDN.
How to Customize Styles 
How to Customize Comment Widget Styles
You can customize the comment widget styling in two ways:
Option 1: Via customCSS Parameter
Pass your custom CSS as a string to the customCSS parameter when initializing the widget:
window.fcConfigs = [{
target: '#fastcomments-widget',
tenantId: 'your-tenant-id',
customCSS: `
.fast-comments .comment {
background-color: #f0f0f0 !important;
border-radius: 8px !important;
}
`
}];
Option 2: Via Admin Dashboard
- Go to the Widget Customization page in your admin dashboard
- Scroll to the "Custom CSS" section under "Advanced"
- Enter your custom CSS
- Click "Save"
Your custom CSS will be applied to all comment widgets on your site.
Tips
- Use
!importantto override default styles if needed - Target specific selectors to avoid affecting other parts of your site
- Test your CSS in different browsers for compatibility
- The widget uses standard CSS - no special preprocessors required
Comment Widget Styling Reference (v2, latest) 

Recent Comments Widget Styling 
The Recent Comments Widget displays a list of the most recent comments across your site or for a specific page. It includes a heading, rounded avatars, comment previews, clickable dates that deep-link to the comment, and automatic dark mode detection.
Basic Installation
Run 
Configuration Options
- tenantId (required): Your FastComments tenant ID
- urlId (optional): Filter to a single page. Leave null for all pages
- count (optional): Number of comments to show. Default is
10 - hasDarkBackground (optional): Force dark mode styling. Auto-detected from the page background if not set
Widget Structure
The widget renders with the following HTML structure:

Default CSS Reference

Customization Examples
Change Avatar Size

Show More Lines of Comment Text

Remove the Container Border

Most Discussed Pages Widget Styling 
The Most Discussed Pages Widget displays a ranked list of your most commented pages. It includes a heading, numbered ranks, comment counts with icons, last activity dates, and automatic dark mode detection.
Basic Installation
Run 
Configuration Options
- tenantId (required): Your FastComments tenant ID
- hasDarkBackground (optional): Force dark mode styling. Auto-detected from the page background if not set
Widget Structure
The widget renders with the following HTML structure:

Default CSS Reference

Customization Examples
Remove the Rank Badges

Remove the Container Border

Recent Discussions Widget Styling 
The Recent Discussions Widget displays a list of pages sorted by the most recent comment activity. It includes a heading, last activity dates, comment counts with icons, and automatic dark mode detection.
Basic Installation
Run 
Configuration Options
- tenantId (required): Your FastComments tenant ID
- count (optional): Number of pages to show. Default is
20, max100 - hasDarkBackground (optional): Force dark mode styling. Auto-detected from the page background if not set
Widget Structure
The widget renders with the following HTML structure:

Default CSS Reference

Customization Examples
Remove the Container Border

Custom Link Color
