# Discourse Who's Online

**URL:** https://meta.discourse.org/t/discourse-whos-online/52345
**Category:** Plugin
**Tags:** official, whos-online
**Created:** [November 2, 2016, 12:59am UTC](https://meta.discourse.org/t/discourse-whos-online/52345 "2016-11-02T00:59:53Z")
**Posts on this page:** 1
**Showing post:** 1

<div class="post-metadata">

### Author: ![Discourse](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/discourse/32/148734_2.png) [@Discourse](https://meta.discourse.org/u/Discourse)
#### Post date: [November 2, 2016, 12:59am UTC](https://meta.discourse.org/t/discourse-whos-online/52345/1 "2016-11-02T00:59:53Z")

</div>

| | | |
| --- | --- | --- |
| :discourse2: | **Summary** | **Discourse Who’s Online** displays a list of users currently active on the site |
| 🛠 | **Repository Link** | [https://github.com/discourse/discourse-whos-online](https://github.com/discourse/discourse-whos-online) |
| 📖 | **Install Guide** | [How to install plugins in Discourse](https://meta.discourse.org/t/install-plugins-in-discourse/19157) |

> [@](#):
>
> :discourse2: As this is an #official plugin maintained by the Discourse team, #Support, #Contribute > Bug, #Contribute > UX, and #Contribute > Feature requests can be made in the respective categories here on Meta, and tagged with the appropriate plugin tag. Click on a link below to get one started. 👍
> 
> [❓&nbsp; **Support**](https://meta.discourse.org/new-topic?category_id=6&body=%3E%20Before%20asking,%20did%20you%20search%20first%3F%20Press%20%F0%9F%94%8D%20at%20the%20upper%20right%20to%20search.&tags=whos-online "Ask for support on configuring and using Discourse Who's Online") [🐛&nbsp; **Bug**](https://meta.discourse.org/new-topic?category_id=1&tags=whos-online "A bug report means something is broken, preventing normal/typical use of the plugin") [👀&nbsp; **UX**](https://meta.discourse.org/new-topic?category_id=9&tags=whos-online "Discussion about the user interface of Discourse Who's Online, and how features are presented (including language and UI elements)") [💡&nbsp; **Feature**](https://meta.discourse.org/new-topic?category_id=2&tags=whos-online "Discussion about how existing Discourse Who's Online features can be improved or enhanced, and how proposed new features could work")

### Features

> ℹ Think carefully before installing this plugin. Discourse is designed for asynchronous discussion, and a list of online users can be harmful for some communities

> ℹ This plugin is built for communities with \<100 concurrent logged-in users. Installing on larger sites is possible, but is likely to negatively affect the performance of the whole forum.

[![](https://global.discourse-cdn.com/meta/original/3X/a/f/af9186cf7b6b694a8e00018fc67bce7f9f4e3660.gif) ](https://global.discourse-cdn.com/meta/original/3X/a/f/af9186cf7b6b694a8e00018fc67bce7f9f4e3660.gif)

It can also optionally display a user’s online status on their avatar. Either with a “ring”, “glow”, or with a “flair” icon in the top left.

 ![45](https://global.discourse-cdn.com/meta/original/3X/6/3/63dcb6b6caf02be27ffa7a01c0d492a5a3469f5e.png) ![39](https://global.discourse-cdn.com/meta/original/3X/d/4/d44e555de5f622f035bd1f85c9a0484bd4b66426.png) ![10](https://global.discourse-cdn.com/meta/original/3X/b/a/baf1159eea8cdb55d38fa3112dc92a0c15e37338.png)

The plugin uses the MessageBus to keep up-to-date, so user status is reflected in real-time. Users which have enabled the “hide profile and presence” setting will not be displayed. You can customize a number of things using the available site settings and language strings:

### Configuration

These are available in the “plugins” section of the admin settings panel.

- **whos\_online\_active\_timeago** : maximum “last seen” for which users are considered online (minutes)
- **whos\_online\_collapse\_threshold** : number of users before the avatars overlap each other (see gif above). Set very high to disable this feature
- **whos\_online\_maximum\_display** : the maximum number of avatars to display. The numeric counter will still count higher than this. The choice of who gets displayed is currently inconsistent
- **whos\_online minimum\_display** : the minimum number of avatars to display. Below this, a “no users online” message is displayed
- **whos\_online\_hide\_below\_minimum\_display** : if enabled, the widget will be entirely hidden when the number of users is less than minimum\_display
- **whos\_online\_display\_public** : should the plugin be displayed to people who aren’t logged in? Defaults to true.
- **whos\_online\_display\_min\_trust\_level** : the minimum trust level that this plugin is displayed to. Defaults to 0
- **whos\_online\_avatar\_indicator** : choose how to display online status on user avatars. Defaults to “ring”
- **whos\_online\_avatar\_indicator\_topic\_lists** : display avatar indicators in **mobile** topic lists, and the “Categories & Latest” view. Defaults to off.
- **whos\_online\_count\_only** : when enabled, only the count will be displayed. Online user identities will not be revealed

#### 💬 Frontend Language Strings

These are available in the admin panel under **Customize** → **Text Content** (search for _whos\_online_). These include:

- **js.whos\_online.no\_users** | “No users currently online”:The message displayed when the number of users \< **whos online minimum display** setting.
- **js.whos\_online.title** | “Online ({{count}})”: The text displayed before the list of avatars. {{count}} is the number of users online.
- **js.whos\_online.tooltip** | “Users seen in the last 5 minutes”: the text displayed on mouseover of the text.

> Last edited by @dax 2024-08-22T14:22:33Z
> 
> > **Check document**
> >
> > Perform check on document:

---

_[View the full topic](https://meta.discourse.org/t/discourse-whos-online/52345)._