Browser Extension Guide

Use Classy Comments on any website with our browser extension

Installation

Download Extension (28KB)

Updated: November 1, 2025

Chrome / Edge / Brave

  1. Download and extract the extension zip file (classy-comments.zip)
  2. Open Chrome and navigate to chrome://extensions
  3. Enable "Developer mode" (toggle in top-right)
  4. Click "Load unpacked"
  5. Select the unzipped extension folder
  6. The extension is now active!

Note: Chrome Web Store version coming soon! For now, use developer mode.

Firefox

  1. Download the extension
  2. Open Firefox and navigate to about:debugging
  3. Click "This Firefox" in the sidebar
  4. Click "Load Temporary Add-on"
  5. Select the manifest.json file from the extension folder

How It Works

The extension automatically finds and enhances comment fields on any website:

Automatic Detection

The extension automatically detects:

  • <textarea> elements (traditional comment boxes)
  • contenteditable elements (modern editors like Twitter, Reddit, YouTube)

Smart Filtering

Does NOT appear on:

  • Search boxes (Google, Bing, etc.)
  • Single-line input fields (name, email, password)
  • Blacklisted domains (configurable)

Usage

  1. Write your comment
  2. Click the ✨ button in the top-right of the text field
  3. Review the refined version
  4. Approve, edit, or cancel

Configuration

Click the extension icon in your browser toolbar to open settings.

Basic Settings

Enable on all sites

Toggle to enable/disable the extension globally.

API Key (Required)

The browser extension requires a valid API key to function. Get your API key from the dashboard. The extension will use the refinement settings you configured there.

Format: cc_live_sk_xxxxxxxx

No Demo Mode Available

Unlike the WordPress plugin and CDN version, the browser extension does not support demo mode. You must have a valid API key to use the extension. Free tier includes 100 refinements per month.

Domain Control

Blacklisted Domains

Sites where the extension won't run. Enter one domain per line.

facebook.com
twitter.com
linkedin.com

Default blacklist: Search engines are blocked by default.

Whitelisted Domains (Optional)

If set, the extension will ONLY run on these sites (overrides blacklist).

reddit.com
news.ycombinator.com
github.com

Where Are Refinement Settings?

Settings come from your dashboard

When using AI mode, the extension uses the refinement settings (formality, tone, profanity handling, etc.) that you configured in your dashboard settings.

This means:

  • Configure settings once in the dashboard
  • Settings apply across all your tools (WordPress, extension, npm)
  • No need to reconfigure for each tool

How It Works

The extension automatically detects comment fields on websites and adds the ✨ refinement button. It works by:

  • Scanning for standard HTML textarea and contenteditable elements
  • Detecting comment forms on pages you visit
  • Adding the ✨ button when you focus on a comment field

The extension should work on most websites with standard comment fields, but compatibility varies depending on how each site implements their comment system.

Troubleshooting

Button not appearing

  • Check that extension is enabled in settings
  • Verify site is not blacklisted
  • Check browser console for errors (F12 → Console)
  • Try refreshing the page
  • Ensure the field is a textarea or contenteditable (not a single-line input)

AI mode not working

  • Verify API key is correct
  • Ensure Demo Mode is disabled
  • Check you haven't exceeded quota (view dashboard)
  • Verify API is accessible (check Network tab for errors)

Button appears on wrong fields

  • Add the site to your blacklist
  • Report the issue on GitHub with site URL

Privacy & Permissions

Required Permissions

storage

Save your settings (API key, preferences)

activeTab

Access current page to find comment fields

host permissions

Connect to API server (api.classycomments.com)

Data Privacy

  • Comment text is sent to our API only when you click the ✨ button
  • API key is stored locally in your browser
  • No tracking, analytics, or third-party services
  • Open source - verify the code yourself
  • Data is only sent when actively using the refinement feature

Need Help?

For extension support:

Check FAQContact us