Browser Extension Guide

Use Classy Comments on any website with our browser extension

Installation

Chrome / Edge / Brave

  1. Download the extension (classy-comments-extension.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.

Demo Mode

Enabled (Default): Works offline using rule-based refinement. No API key needed.

Disabled: Uses full AI-powered refinement from your dashboard settings.

API Key

Get your API key from the dashboard. The extension will use the refinement settings you configured there.

Format: cc_live_sk_xxxxxxxx

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

Tested & Working On

Fully Supported

  • Reddit
  • Twitter / X
  • YouTube
  • Hacker News
  • GitHub
  • WordPress sites
  • Medium
  • Stack Overflow
  • Disqus comments

Should Work On

Any site with standard comment fields:

  • Blog comment sections
  • Forums
  • Community platforms
  • Review sites
  • Social networks

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
  • No data is collected in Demo Mode (works offline)
  • API key is stored locally in your browser
  • No tracking, analytics, or third-party services
  • Open source - verify the code yourself

Need Help?

For extension support: