General settings (VUUKLE_CONFIG)

VUUKLE_CONFIG is the global object every Vuukle widget reads from. You set it once per page and the script handles initialization.

The shape is intentionally small. Per-site behaviour — theme, login methods, character limits, sort order, moderation thresholds, emote images, translations — is managed from the dashboard, not from this config. The browser only knows things the server doesn’t: which article you’re on, what its title is, what its image is.

The complete browser-side schema

<script>
  var VUUKLE_CONFIG = {
    apiKey: 'YOUR_PUBLIC_API_KEY',  // required
    articleId: 'post-12345',         // optional — falls back to page URL
    title:  'Article title',
    url:    'https://example.com/article-slug',
    img:    'https://example.com/img/article.jpg',
    tags:   'tag1, tag2, tag3',
    author: 'Article author',
  };
</script>
<script src="https://cdn.vuukle.com/platform.js" async></script>

Key	Type	Required	Description
apiKey	string	Yes	Public API key from Integration → API Key in the dashboard.
articleId	string | number	Optional	Unique identifier per article — stable across page loads. Falls back to the page URL if omitted. Recommended for sites where URLs can change.
title	string	Recommended	Article title — used in shared URLs and OG previews.
url	string	Recommended	Canonical article URL.
img	string	Recommended	Article hero image URL.
tags	string	Optional	Comma-separated tags for analytics and recommendations.
author	string	Optional	Author name.

What’s not here (and where to find it)

These options used to live in VUUKLE_CONFIG but are now managed entirely from the dashboard:

Old config key	Where it lives now
theme.color, theme.darkMode	Site Settings → Comment Widget → Theme
comments.maxChars	Site Settings → Comment Widget → Character limit
comments.sorting	Site Settings → Comment Widget → Default sort
comments.countToLoad	Site Settings → Comment Widget → Initial count
comments.toxicityLimit, spamLimit	Site Settings → Comment Widget → Moderation
comments.auth.{facebook,google,…}	Site Settings → Comment Widget → Login methods
comments.editorOptions	Site Settings → Comment Widget → Editor
emotes.firstImg, firstName, etc.	Site Settings → Emote settings
emotes.disable, size	Site Settings → Emote settings
powerbar.defaultEmote, verticalPosition	Site Settings → ShareBar Settings
language	Auto-detected from the visitor’s locale; specific overrides in the dashboard
wordpressSync	Handled automatically by the WordPress plugin

The one exception is SSO — it’s still wired browser-side because it has to call a function you control:

<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>

See SSO overview.

Related

Comments widget

Where to configure login methods, moderation, theme. Comments →

Customize emote images

Replace the 6 default reactions via the dashboard. Emote customization →

Dashboard tour

What lives where in the publisher dashboard. Tour →

VUUKLE_CONFIG reference

Complete schema in one page. Reference →