WP Online Active Users Documentation

In this guide & related topics
Shortcodes

Show viewers on the current page

Use [wpoau_live_viewers] to place the live-viewer badge in your layout.

4 min read Product guide

Why use it?

Use the badge when you want an indication of recent viewers on the current public page, including the viewer types supported by your live-viewers configuration. It is an activity estimate, not proof that someone is looking at the screen at this exact moment.

Copy this shortcode

[wpoau_live_viewers]

Provided by: the live-viewers module in the Pro add-on. That module must be installed, enabled and permitted by the current license. A build without this module will not recognize the shortcode.

Where it can appear

  1. Enable Live Viewers in the plugin.
  2. Add a Shortcode block to a published public page or post.
  3. Paste the shortcode, save and open the actual frontend page.
  4. Check the badge with another browser session.

The verified module excludes administration screens, account pages, checkout, non-singular views, password-protected posts and unpublished/private content. The badge starts hidden until its frontend script updates it.

Live Page Viewers controls used to configure the badge shown by the shortcode.
Live Page Viewers controls used to configure the badge shown by the shortcode.

Configure the display

The handler does not accept shortcode attributes. Use Live Viewers settings for text, colors, minimum count, position, mobile display and timing. If automatic placement is enabled, decide whether you need that placement or a manual shortcode to avoid repeating the badge.

If it stays hidden, check the minimum-count setting, page eligibility, enabled module/license, frontend scripts and cached markup.