Skip to content
Vuukle Docs

Comments widget

The Comments widget is Vuukle’s flagship — a threaded comment system with social/email login, GIFs, image upload, voting, sorting, and built-in moderation.

Enable the widget

Add the install script, then drop the widget anchor wherever you want comments to render:

<div id="vuukle-comments"></div>

Configuration is in the dashboard

Everything that used to live in VUUKLE_CONFIG.comments is now managed from the Vuukle dashboard → Site Settings → Comment Widget. This includes:

  • Login methods — toggle Facebook, Google, Twitter, Disqus, email/password, Vuukle
  • Character limit — max characters per comment
  • Default sort order — Latest, Oldest, Best, Most Replied
  • Auto-publish — on/off (off sends every new comment to moderation queue)
  • Toxicity & spam thresholds — the AI moderation cut-offs (more)
  • Editor options — which formatting buttons appear in the comment editor
  • Theme — accent color, dark mode forcing
  • Visible-string overrides — labels in your locale

The browser-side VUUKLE_CONFIG is intentionally focused on per-article metadata (title, url, image, tags). That’s the only thing the browser knows that the server doesn’t. Everything else belongs in the dashboard so non-technical admins can change it without redeploys.

For the full browser-side schema, see the VUUKLE_CONFIG reference.

SSO (the one auth method still wired browser-side)

If you have your own login system and want to skip the Vuukle login modal, hook up Single Sign-On via a callback:

<script>
  var VUUKLE_CONFIG = {
    apiKey: 'YOUR_PUBLIC_API_KEY',
    articleId: 'post-12345',
    comments: {
      auth: {
        sso: { onClick: openYourLoginModal },
      },
    },
  };
</script>
<script src="https://cdn.vuukle.com/platform.js" async></script>

Replace openYourLoginModal with your own function. Generate a signed SSO token server-side and pass it to window.vuukleLogin(token) to authenticate the user. Full walkthrough: SSO overview and generate an SSO token.

To force SSO-only (remove all other login buttons), enable Site Settings → Comment Widget → Login method → SSO only in the dashboard.

Customize the look-and-feel

The dashboard exposes every customization point as a form field — no code required:

Want to change…Where in the dashboard
Brand color, dark modeSite Settings → Comment Widget → Theme
Login providers shownSite Settings → Comment Widget → Login methods
Character limitSite Settings → Comment Widget → Character limit
Default sort orderSite Settings → Comment Widget → Default sort
Auto-publish on/offSite Settings → Comment Widget → Auto-publish
Toxicity / spam thresholdsSite Settings → Comment Widget → Moderation
Editor toolbar (images, GIF, bold, etc.)Site Settings → Comment Widget → Editor
String overrides (translations)Site Settings → Comment Widget → Visible text

Auto-moderation

Tune toxicity and spam thresholds in the dashboard. Guide →

SSO overview

Skip the Vuukle login and authenticate users with your own system. SSO →

Was this page helpful?
Help us improve — drop a note or open the dashboard.
Suggest an edit ↗ Email support Open dashboard ↗