WordPress Installation

Add Simple Commenter to your WordPress website. Choose the method that works best for your setup.

Method 1: Simple Commenter Plugin (Recommended)

The official plugin handles everything automatically — no code needed. It also gives you full comment management directly inside WordPress admin.

Installation

1. Search "Simple Commenter" in your WordPress plugin directory, or download from WordPress.org. Click Install, then Activate.
2. Go to the Commenter menu in your WordPress admin and connect your account. Sign in with Google or enter your email for a verification code.

3. Choose an existing project or create a new one. The widget automatically appears on your site.

Comment Management

Once connected, you can manage all feedback directly from WordPress admin:

• View, filter, and search comments
• Update status (To Do, In Progress, Done) without leaving WordPress
• Set priority levels (Low, Normal, High)
• Reply to comments with file attachments
• Track unread comments with badge notifications in your admin menu

Automatic User Sync

The plugin automatically syncs your WordPress users:

• Team members (admins, editors) sync as collaborators
• Clients with WordPress accounts sync as commenters
• Role mapping is automatic — no manual setup
• Daily sync keeps everything up to date

Role-Based Widget Visibility

Control who sees the feedback widget:

• Everyone (including guests)
• Logged-in users only
• Specific WordPress roles (Administrators, Editors, Authors, etc.)
• Conditional loading via ?feedback=true URL parameter for testing. The check runs in the visitor's browser, so it works on sites with full page caching (LiteSpeed, WP Rocket, Cloudflare)

This is useful for keeping the widget visible on staging but hidden from public visitors on production.

Method 2: Code Snippet Plugins

If you prefer to embed the script manually using a code snippet plugin, this keeps your code safe when updating themes.

Using WPCode (Free)

1. Install and activate the WPCode plugin (or "Insert Headers and Footers")
2. Go to Code Snippets > Header & Footer
3. Paste this in the Footer section:

<script
  src="https://simplecommenter.com/js/comments.min.js?id=sc_your_project_key"
  defer
></script>

4. Click Save Changes

Using Insert Headers and Footers

1. Install Insert Headers and Footers by WPBeginner
2. Go to Settings > Insert Headers and Footers
3. Paste the script in the Scripts in Footer box
4. Save

Method 3: Theme Editor

1. Go to Appearance > Theme File Editor
2. Select your active theme
3. Open footer.php (or your theme's footer template)
4. Add this code before </body>:

<script
  src="https://simplecommenter.com/js/comments.min.js?id=sc_your_project_key"
  defer
></script>

5. Click Update File

Method 4: Child Theme

The safest method for theme modifications.

Add this to your child theme's functions.php:

function add_simplecommenter_widget() {
    ?>
    <script src="https://simplecommenter.com/js/comments.min.js?id=sc_your_project_key" defer></script>
    <?php
}
add_action('wp_footer', 'add_simplecommenter_widget');

Method 5: Elementor

If using Elementor Pro:

1. Go to Elementor > Custom Code
2. Click Add New
3. Set location to Body - End
4. Paste the script:

<script
  src="https://simplecommenter.com/js/comments.min.js?id=sc_your_project_key"
  defer
></script>

5. Set display conditions and publish

Verifying Installation

1. Clear any caching plugins (WP Super Cache, W3 Total Cache, etc.)
2. Visit your site in an incognito/private window
3. Look for the feedback widget button
4. Check browser console (F12) for any errors

Troubleshooting

Widget not appearing

• Clear your WordPress cache
• Clear any CDN cache (Cloudflare, etc.)
• Check that the script wasn't removed by a security plugin
• Verify the embed identifier matches your dashboard project (sc_... preferred)

Widget shows when logged in, but not in incognito

If the widget appears while you are logged into WordPress but is missing for logged-out visitors or in an incognito window, a JavaScript optimization plugin is almost always the cause. These plugins skip optimization for logged-in administrators, which is exactly why the problem stays invisible to you and only affects real visitors.

The feature responsible is usually called Combine JavaScript, JS Combine External and Inline, or Merge JS. It merges external scripts into a single file hosted on your own domain. That rewrite drops the ?id=sc_... project key from the widget's script URL, and without that key the widget cannot tell which project it belongs to, so it stops silently with no console error.

Plugins known to do this: LiteSpeed Cache, WP Rocket, Autoptimize, W3 Total Cache, SG Optimizer, and Jetpack Boost.

Excluding the widget from LiteSpeed Cache, WP Rocket, and Autoptimize

The fix is to exclude simplecommenter.com from JavaScript combining, so the widget script keeps its own tag and its ?id= project key. This is standard practice for third-party widgets and has a negligible effect on page speed scores, since the script is a 3KB loader.

• LiteSpeed Cache — Page Optimization > Tuning > JS Excludes, add simplecommenter.com on its own line. If JS Delay is enabled, add the same line to JS Delayed Excludes.
• WP Rocket — File Optimization > Excluded JavaScript Files, add simplecommenter.com.
• Autoptimize — JavaScript Options > Exclude scripts from Autoptimize, append simplecommenter.com to the list.
• W3 Total Cache — Performance > Minify > Never minify the following JS files.
• SG Optimizer and Jetpack Boost — turn off JavaScript combining, or add the same exclusion where the plugin allows one.

To confirm the fix, open your site in a fresh incognito window and view the page source. You should see the script tag with the project key intact:

<script
  src="https://www.simplecommenter.com/js/comments.min.js?id=sc_your_project_key"
  defer
></script>

If that tag is missing, or the ?id= is gone, the optimizer is still absorbing it.

Conflicts with other plugins

• Try disabling other JavaScript optimization plugins temporarily (see the section above for the usual culprit)
• Check if a security plugin is blocking external scripts
• Ensure no duplicate scripts are loaded

WooCommerce sites

The widget works on WooCommerce pages. If you only want it on certain pages:

function add_simplecommenter_widget() {
    // Only load on non-cart/checkout pages
    if (is_cart() || is_checkout()) return;
    ?>
    <script src="https://simplecommenter.com/js/comments.min.js?id=sc_your_project_key" defer></script>
    <?php
}
add_action('wp_footer', 'add_simplecommenter_widget');

Need help? Contact support.