Skip to content
Vuukle Docs

Widgets overview

Vuukle ships five widgets you can mix and match per article. Each widget is a single <div> and a few configuration keys.

Comments

Threaded comments, reactions, voting, image and GIF support, social and email login, moderation. Reference →

Emotes

One-tap reactions. Six default emotes — fully customisable images and labels. Reference →

ShareBar

Social share bar — horizontal or vertical sticky. Configurable networks. Reference →

Newsfeed

Article-recommendation grid. Pulls from your archive and the global Vuukle network. Reference →

Comment count

Show the number of comments on an article anywhere — listings, sidebars, footers. Reference →

Configure once, ship everywhere

Every widget reads from a single global object — VUUKLE_CONFIG. You set it once per page; the script handles initialisation.

<script>
  var VUUKLE_CONFIG = {
    apiKey: 'YOUR_API_KEY',
    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',
    author: 'Author name',
  };
</script>
<script src="https://cdn.vuukle.com/platform.js" async></script>

The browser-side config is intentionally small — just article identity and metadata. Per-site behaviour (theme, login methods, character limit, moderation thresholds, emote images, translations) is managed from the Vuukle dashboard → Site Settings.

For the complete schema, see the VUUKLE_CONFIG reference.

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