
Language 🇺🇸 English
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
Customizing the Comment Box Border 
The border around the comment box is made of the text area's own border plus a few thin lines the widget draws around it. To change its color or corner roundness, set these CSS variables instead of styling the textarea directly. The variables restyle every part of the border at once, so the corners and colors always line up.
| Variable | What it changes | Default |
|---|---|---|
--fc-input-border-color | Border color | #bfbfbf |
--fc-input-border-color-focus | Border color while the user is typing | #555 |
--fc-input-border-radius | Roundness of the rounded corners | 11px |
--fc-input-border-start-start-radius | Roundness of the square top-left corner (top-right in right-to-left languages) | 0 |
Add the CSS to the Custom CSS box on the Widget Customization page, or pass it with the customCSS option. You only need to set the variables you want to change.
You can also use the Comment box border helper right under the Custom CSS box, which writes this CSS for you.
Change the Border Color

Change the Border Color While Typing

Round All Four Corners
By default the top-left corner is square. Set both radius variables to round all four corners the same:

Square Corners

Match Your Brand

Different Colors in Dark Mode
When the widget is in dark mode it has the dark class, so you can set different values for dark mode:

Why Not Style the Text Area Directly?
The widget draws part of the comment box border itself, around the text area. If you set border-color or border-radius only on the textarea, those lines keep the default style and the border looks mismatched, for example a square line running through a rounded corner. The variables above change both at once.
Comment Widget Custom CSS 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
