> For the complete documentation index, see [llms.txt](https://bubble.digital-bird.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bubble.digital-bird.com/plugins/users-online.md).

# Users Online 🙋‍♂️

## 🔗 Links

> [Demo](https://usersonline.bubbleapps.io/version-test/) | [Editor](https://bubble.io/page?type=page\&name=index\&id=usersonline\&tab=tabs-1)

> [Plugin page](https://bubble.io/plugin/users-online-🙋%E2%80%8D♂%EF%B8%8F-1618682033565x545077038187544600)

> [Forum](https://forum.bubble.io/t/plugin-relese-users-online/147206)

## ℹ️ Introduction

![Plugin used to track online visitors](/files/-MYXOVIAZVRlXz6iwWrz)

🔥 Some use cases:

* store visit analytics and statistics
* number of visitors online / rich info about online visitors
* visitors and opened pages
* get rich visitor info
* automatically logout user after X min of inactivity

## 🔥 Features

Plugin provides rich information about the user.

Based on IP address: 

* IP address
* internet provider
* timezone
* Location: city, area\_code, region, country, country\_code (2 and 3 symbols), continent\_code
* lat/lng
* accuracy (in km)
* asn

Based on website interaction:

* status: active; idle (inactive); hidden (browser is hidden or user is on another tab)
* is Idle: whether user is active or not
* Idle for (ms): time in ms of user inactivity
* Time left (ms): time left before user will be considered inactive (idle)

## 📚 Documentation

1. Add the element to a page. Setup "Time to idle" (in seconds): time of inactivity before user becomes idle.

![](/files/-MYXLHPISAsACQV5ZfZu)

2\. In workflow, use events "**Status changed**" and "**IP info ready**". Access plugin's shared states.