Title: User Login History
Author: Faiyaz Alam
Published: <strong>7. Mai 2016</strong>
Last modified: 17. März 2026

---

Search plugins

![](https://ps.w.org/user-login-history/assets/banner-772x250.jpg?rev=1886722)

![](https://ps.w.org/user-login-history/assets/icon-128x128.jpg?rev=1886722)

# User Login History

 By [Faiyaz Alam](https://profiles.wordpress.org/faiyazalam/)

[Download](https://downloads.wordpress.org/plugin/user-login-history.2.1.8.zip)

 * [Details](https://de-ch.wordpress.org/plugins/user-login-history/#description)
 * [Reviews](https://de-ch.wordpress.org/plugins/user-login-history/#reviews)
 *  [Installation](https://de-ch.wordpress.org/plugins/user-login-history/#installation)
 * [Development](https://de-ch.wordpress.org/plugins/user-login-history/#developers)

 [Support](https://wordpress.org/support/plugin/user-login-history/)

## Description

The plugin helps you to track any visitor’s login details with the following attributes:

 1.  **Login** – Login Date-Time
 2.  **Logout** – Logout Date-Time
 3.  **Last Seen** – Last Seen Date-Time
 4.  **Login Status** – Logged in/Logged out/Failed
 5.  **Online Status** – Online/Offline/Idle
 6.  **Session Duration** – How long the user stayed on your website per session.
 7.  **User ID**
 8.  **Username**
 9.  **Current Role**
 10. **Old Role** – The role while user gets logged in into your website.
 11. **Browser**
 12. **Operating System**
 13. **IP Address**
 14. **Country Name and Country Code** (Based on IP Address)
 15. **Timezone** (Based on IP Address)
 16. **Mobile [(Pro Feature)](https://userloginhistory.com/features)** – Whether the
     user loggedin with a mobile (e.g. tablet and mobile phone) device.
 17. **Proxy IP [(Pro Feature)](https://userloginhistory.com/features)** – Whether 
     the user loggedin from a proxy IP.

#### Features

The [User Login History Free Version](https://userloginhistory.com/) plugin has 
all the basic features that will help you to know your website visitors. The [User Login History Pro Version](https://userloginhistory.com/features)
plugin has some more premium and useful features along with all the basic features.

 1.  **AUTO LOGOUT [(Pro Feature)](https://userloginhistory.com/features)** – Automatically
     logout idle users every ‚X‘ minute.
      You can also specify roles. This feature 
     is built on WordPress Cron Job.
 2.  **IP ADDRESS CONTROL [(Pro Feature)](https://userloginhistory.com/features)** –
     Allows you to control of masking and hiding of user’s IP address.
 3.  **EMAIL ALERT [(Pro Feature)](https://userloginhistory.com/features)** – Allows
     you to get notified via email for success/failed login.
      You can also specify 
     roles and modify email templates.
 4.  **AUTO DELETE OLD RECORDS [(Pro Feature)](https://userloginhistory.com/features)**–
     Automatically delete the records older than ‚X‘ days.
      You can also specify the
     roles. This feature is built on WordPress Cron Job.
 5.  **TRACK SPECIFIC ROLES [(Pro Feature)](https://userloginhistory.com/features)**–
     Allows you to track specific roles only.
 6.  **CSV SEPARATOR [(Pro Feature)](https://userloginhistory.com/features)** – Allows
     you to enter a CSV separator for CSV export.
 7.  **REPORT – TIMESHEET [(Pro Feature)](https://userloginhistory.com/features)** –
     Generate a timesheet report
 8.  **REPORT – NO LOGIN LIST [(Pro Feature)](https://userloginhistory.com/features)**–
     Generate a report of users who have not login for a given date range
 9.  **REPORT – LOGIN DEVICE [(Pro Feature)](https://userloginhistory.com/features)**–
     Generate report of login count based on IP address
 10. **LOGIN TIME TRACKER** – Tracks the date and time of user’s login, logout, last
     seen, etc.
 11. **LOGIN STATUS TRACKER** – Tracks user’s login status to check if the user is 
     logged in, logged out, failed, etc.
 12. **ONLINE STATUS TRACKER** – Tracks user’s online status to check if the user is
     online, idle or offline.
 13. **USER INFORMATION TRACKER** – Tracks user’s old role, current role, username,
     etc.
 14. **DEVICE INFORMATION TRACKER** – Tracks user’s operating system and browser.
 15. **GEO LOCATION TRACKER** – Tracks user’s timezone and country based on IP address.
 16. **ADVANCED SEARCH FILTER** – Filters the records.
 17. **CSV EXPORTER** – Exports the records in csv format.
 18. **CUSTOMIZABLE SHORTCODE** – Renders the records on front-end.
 19. **PREFERABLE TIMEZONE (DEPRECATED! Will be removed in 3.0)** – You can select 
     your preferred timezone to be used for the listing table.
 20. **MULTISITE NETWORK** – On the network admin area, you can see the listing table
     which shows all the records fetched from all the blogs of the current network.

#### Translations

You can download the language files from [here](https://translate.WordPress.org/projects/wp-plugins/user-login-history).

Do you want to translate this plugin to another language?

I recommend using [POEdit](http://poedit.net/) or if you prefer to do it straight
from the WordPress admin interface use [Loco Translate](https://WordPress.org/plugins/loco-translate/).

When you’re done, post your file on this [issue](https://github.com/faiyazalam/WordPress-plugin-user-login-history/issues/6)..
You can also translate the plugin [online](https://translate.WordPress.org/projects/wp-plugins/user-login-history).

#### How to use the plugin?

 1. To see all the tracked records in admin, click on the plugin menu shown in the 
    left sidebar.
 2. To see all the tracked records of current logged in users in frontend, use the 
    following shortcode:

**Basic Usage of Shortcode**:

In your template file:

    ```
    <?php echo do_shortcode('[user_login_history]'); ?>
    ```

In your content:

    ```
    [user_login_history]
    ```

**Advanced Usage of Shortcode**:

In your template file:

    ```
    <?php echo do_shortcode("[user_login_history limit='20' reset_link='custom-uri' columns='ip_address,time_login' date_format='Y-m-d' time_format='H:i:s']"); ?>
    ```

In your content:

    ```
    [user_login_history limit='20' reset_link='custom-uri' columns='ip_address,time_login' date_format='Y-m-d' time_format='H:i:s']
    ```

#### Shortcode Parameters

You can use the shortcode to display the login list of the current user. It does
not display the login list of other users.
 Here is the list of all the parameters
that you can use in the shortcode. All the parameters are optional.

 1.  title – Title of the listing table. Default is: empty string
 2.  limit – Number of records per page. Default is: 20
 3.  reset_link – Custom URI of the listing page. For the input «my-login-history»,
     it will render a reset link with the following URL:
      www.example.com/my-login-
     history Default is the full permalink of the current post or page.
 4.  date_format – A valid date format. Default is:
 5.  Y-m-d
 6.  time_format – A valid time format. Default is:
 7.  H:i:s
 8.  show_timezone_selector – Whether you want to show timezone selector or not. Any
     value other than «true» will be treated as «false». Default is:
      true
 9.  roles [(Pro Feature)](https://userloginhistory.com/features):
      It allows you to
     set role(s) in the shortcode parameter so that you can see the login list of other
     users who belong to the role(s).
 10. [user_login_history roles=’administrator, editor‘]
 11. columns – List of column keys used to render columns on the listing table. Default
     keys are:
 12. operating_system, browser, time_login, time_logout
 13. Available Column Keys:
 14. user_id, username, role, old_role, ip_address, country_name, browser, operating_system,
     timezone, user_agent, duration, time_last_seen, time_login, time_logout, login_status

#### Geo Tracking

The plugin uses [a free third party service](https://tools.keycdn.com/geo) to detect
country and timezone based on IP address. Many projects are using this free service
due to which sometimes the server of the service provider becomes slow. This may
affect the login functionality of your website. Hence it is recommended that you
do not enable this functionality unless you have paid service or reliable service.
If you have a paid service, you can [contact us](https://userloginhistory.com/contact/)
to integrate it.

#### Login Statuses

 1. Logged in – If the user gets logged in successfully.
 2. Logged out – If the user clicks on logout button and gets logged out successfully.
 3. Failed – If the user enters invalid credentials.
 4. Blocked (DEPRECATED! Will be removed in 3.0) – This is used for the multisite network.
    By default, a user can login to any blog and then WordPress redirects to the blog
    on which the user is associated. The plugin saves login info at the blog on which
    the user logged in but cannot not save the information of the blog on which WordPress
    redirects the user. You can prevent this behavior by using the plugin setting. 
    Please note that we already removed this status from the pro version plugin but
    not from the free version yet.
 5. Unknown (DEPRECATED! Will be removed in 3.0) – Since we have added a new column«
    Login Status» in the version 1.7.0, its value will be empty in the database table
    after upgrading to 1.7.0. To filter such records, you can use this status.

**Note** – In case, a user log in with «Remember Me» and then closes his browser
without doing logout, it will show the login status as «Logged in».

#### Bug Fixes

If you find any bug, please create a topic with a step by step description to reproduce
the bug.
 Please search the forum before creating a new topic.

#### Keywords

user log, log, logger, detector, tracker, membership,
 register, sign up, admin,
subscriber, editor, contributor, geo location, profile, front end registration, 
manager, report, statistics, activity, user role editor

## Screenshots

[⌊User login list table for backend⌉⌊User login list table for backend⌉[

User login list table for backend

[⌊Screen options to customize the user login list table⌉⌊Screen options to customize
the user login list table⌉[

Screen options to customize the user login list table

[⌊Advanced search form to filter the records of user logins⌉⌊Advanced search form
to filter the records of user logins⌉[

Advanced search form to filter the records of user logins

[⌊Settings - Basics settings⌉⌊Settings - Basics settings⌉[

Settings – Basics settings

[⌊Settings - Advanced settings⌉⌊Settings - Advanced settings⌉[

Settings – Advanced settings

[⌊Settings - Preferred timezone setting on user profile page⌉⌊Settings - Preferred
timezone setting on user profile page⌉[

Settings – Preferred timezone setting on user profile page

[⌊Shortcode - User login list table for frontend⌉⌊Shortcode - User login list table
for frontend⌉[

Shortcode – User login list table for frontend

## Installation

 1. Upload the plugin files to the `/wp-content/plugins/user-login-history` directory,
    or install the plugin through the WordPress plugins screen directly.
 2. Activate the plugin through the ‚Plugins‘ screen in WordPress.
 3. (Optional) Use the Settings->User Login History screen to configure the plugin.

## FAQ

### Can this plugin track the info of guest users?

No.

### Is it compatible with WordPress multisite network?

Yes.

### Where to see login list in admin?

After activating the plugin, just re-login and then click on «User Login History»
menu on the left sidebar to see the login list.

### What does the setting «online/idle minutes» actually do?

There is a «Last Seen» column in the admin listing page.
 There you will see a circle
with different colors: red is for offline users grey is for idle users green is 
for online users

You can change its settings.

The default setting is as follows:

online: 2 min
 idle: 30 min

It means that:
 1)the column «last seen» will show green color for the users who
are active for 0-2 minutes. 2)the column «last seen» will show grey color for the
users who are inactive for 2-30 minutes. 3)the column «last seen» will show red 
color for the users who are inactive for at-least 30 minutes.

## Reviews

![](https://secure.gravatar.com/avatar/3f304b9361a2742d90a3793c3c23ee020743bb296d659b5b67b829490f6ab5d0?
s=60&d=retro&r=g)

### 󠀁[Poorly optimized for long-running sites](https://wordpress.org/support/topic/poorly-optimized-for-long-running-sites/)󠁿

 [fabiancz](https://profiles.wordpress.org/fabiancz/) 25. August 2026

This plugin is not optimized for long-running sites. There is no built-in retention
setting to automatically delete old login records, so the log table just keeps growing
over time. On my installation, this plugin is currently the #1 source of slow queries
in the database. With millions of accumulated records, it has become a noticeable
performance problem.

![](https://secure.gravatar.com/avatar/4bf5d1ca71e16ce7e94a464d6483df26570f6a305774983fc7b1ab42e6adc46f?
s=60&d=retro&r=g)

### 󠀁[Recomendado](https://wordpress.org/support/topic/recomendado-62/)󠁿

 [Alvaro Canteiro](https://profiles.wordpress.org/lordman/) 6. November 2025

Excelente plugin, fácil de manejar y muy recomendado para tener un control de los
logeos que se producen.

![](https://secure.gravatar.com/avatar/98151c556b80cfef28b2747dc76bd6fe5f05692404c1e30743aba69e70841b17?
s=60&d=retro&r=g)

### 󠀁[Best Plugin For User Login History](https://wordpress.org/support/topic/best-plugin-for-user-login-history/)󠁿

 [rushikeshraut](https://profiles.wordpress.org/rushikeshraut/) 8. August 2024

One Of The Best Plugin For User Login History

![](https://secure.gravatar.com/avatar/89a02aeebc4c3dac960c5f798d717836cc9eff44571032d3eabab8359b7e21ba?
s=60&d=retro&r=g)

### 󠀁[I don’t see the list immediately after installation](https://wordpress.org/support/topic/i-dont-see-the-list-immediately-after-installation/)󠁿

 [lp85d](https://profiles.wordpress.org/lp85d/) 21. Mai 2024 1 reply

On my site, all users and visitors are logged in, but after a person logs on to 
the site via wptelgram_login, your faulh-login-listing plugin does not show him 
in the list of visitors /wp-admin/admin.php?page=faulh-login-listing

![](https://secure.gravatar.com/avatar/3edf4968a160b79033472009fca8737dbadc8704b1c35967242d5dbbbb3dc199?
s=60&d=retro&r=g)

### 󠀁[Crashes web server!](https://wordpress.org/support/topic/crashes-web-server/)󠁿

 [wd69](https://profiles.wordpress.org/wd69/) 29. November 2022 1 reply

Have thousands of users on my website, it is not optimised for large members website.
Cannot get list of users without it crashing the database then have to restart it
and the web server to get things back online!

![](https://secure.gravatar.com/avatar/4cd20c1e31e5aea34905835950f1c12785a074c246b04848ab7950922f6d90c0?
s=60&d=retro&r=g)

### 󠀁[Free Version works GREAT!](https://wordpress.org/support/topic/free-version-works-great-6/)󠁿

 [Anonymous User](https://profiles.wordpress.org/anonymized-10974915/) 16. Oktober
2021

The Free Version works GREAT! Straight out the box! All the time and zones are correct.(
minor config to my setting) but Shazam! It worked. I uninstalled other login tools
for this tool and just use this one now. Thanks!

 [ Read all 29 reviews ](https://wordpress.org/support/plugin/user-login-history/reviews/)

## Contributors & Developers

“User Login History” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ Faiyaz Alam ](https://profiles.wordpress.org/faiyazalam/)
 *   [ w3reign ](https://profiles.wordpress.org/w3reign/)
 *   [ Leonardo Gandini ](https://profiles.wordpress.org/nekokun/)
 *   [ Harm10 ](https://profiles.wordpress.org/harm10/)

“User Login History” has been translated into 7 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/user-login-history/contributors)
for their contributions.

[Translate “User Login History” into your language.](https://translate.wordpress.org/projects/wp-plugins/user-login-history)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/user-login-history/),
check out the [SVN repository](https://plugins.svn.wordpress.org/user-login-history/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/user-login-history/)
by [RSS](https://plugins.trac.wordpress.org/log/user-login-history/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 2.1.8 (14th March 2026)

 * Improved CSV export feature.
 * Removed external CSV League library dependency.
 * Improved UI for frontend login list page (shortcode).
 * Improved UI for login list page in admin.
 * Improved SQL queries.
 * Updated text domain.
 * Renamed hook manage_faulh_admin_custom_column to faulh_manage_admin_custom_column.
 * Renamed hook manage_faulh_public_custom_column to faulh_manage_public_custom_column.
 * General plugin check improvements and cleanup.

#### 2.1.7 (15th June 2025)

 * Fixed potential security issues by properly escaping all dynamic output.
 * Code refactoring.

#### 2.1.6 (1st October 2024)

 * Improvements in external links.

#### 2.1.5 (10th July 2024)

 * Added a new submenu for more plugins.

#### 2.1.4 (5th May 2024)

 * Implemented a new php library for csv export – https://csv.thephpleague.com

#### 2.1.3 (10th November 2023)

 * Fixed a few PHP 8.2 deprecation notices like Creation of dynamic property ExampleNamespace\
   ExampleClass::$exampleVariable is deprecated

#### 2.1.2 (05th October 2023)

 * Code refactoring for the settings page
 * Removed the role filter to improve the sql query performance

#### 2.1.1 (21st May 2023)

 * Fixed error [issue](https://wordpress.org/support/topic/plugin-error-2-1-0/)

#### 2.1.0 (17th February 2021)

 * Fixed geo location [issue](https://wordpress.org/support/topic/no-geo-location-user-agent-not-properly-defined/)

#### 2.0.1 (10th February 2021)

 * Code refactoring.
 * Added Buy Pro Version link.

#### 2.0.0 (10th June 2020)

 * Improved UI/UX of the listing table in admin panel.
 * Code refactoring.
 * Minor bugs fixes.

#### 1.7.4(3rd April, 2020)

 * Fixed some permission issue on dashboard menu
 * Implemented horizontal scroll bar on the listing table in backend
 * Replaced role key with role name on the listing table

#### 1.7.3(25th August, 2019)

 * Fixed index size limit issue

#### 1.7.2(18th August, 2019)

 * Fixed some performance issues

#### 1.7.1(16th March, 2019)

 * Fixed SQL bug in order by clause

#### 1.7.0(4th June, 2018)

 * Compatible with **Multisite Network** – Now this plugin supports WordPress Multisite
   with multi-networks and multi-blogs.
 * Added the column **Login Status** – This is used to check whether the user is
   logged in, logged out, failed login or blocked login.
 * Added the option **Last Seen Time** in the filter forms.
 * Added the column **Super Admin** – This is used only for multisite network.
 * Deprecated the shortcode [user-login-history].
 * Added new shortcode [user_login_history] with customizable parameters.
 * Date range validation on the filter forms.
 * Date and Time format of the user login listing table can be changed from the 
   general settings.
 * Improved design of the listing tables.

## Meta

 *  Version **2.1.8**
 *  Last updated **7 Monaten ago**
 *  Active installations **10'000+**
 *  WordPress version ** 6.2 or higher **
 *  Tested up to **6.9.10**
 *  PHP version ** 7.4 or higher **
 *  Languages
 * [English (US)](https://wordpress.org/plugins/user-login-history/), [Italian](https://it.wordpress.org/plugins/user-login-history/),
   [Japanese](https://ja.wordpress.org/plugins/user-login-history/), [Korean](https://ko.wordpress.org/plugins/user-login-history/),
   [Russian](https://ru.wordpress.org/plugins/user-login-history/), [Spanish (Chile)](https://cl.wordpress.org/plugins/user-login-history/),
   [Spanish (Spain)](https://es.wordpress.org/plugins/user-login-history/) und [Swedish](https://sv.wordpress.org/plugins/user-login-history/).
 *  [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/user-login-history)
 * Tags
 * [Brute Force](https://de-ch.wordpress.org/plugins/tags/brute-force/)[history](https://de-ch.wordpress.org/plugins/tags/history/)
   [login activity](https://de-ch.wordpress.org/plugins/tags/login-activity/)[login log](https://de-ch.wordpress.org/plugins/tags/login-log/)
 *  [Advanced View](https://de-ch.wordpress.org/plugins/user-login-history/advanced/)

## Ratings

 4.6 von 5 Sternen.

 *  [  24 5-Sterne-Rezensionen     ](https://wordpress.org/support/plugin/user-login-history/reviews/?filter=5)
 *  [  2 4-Sterne-Rezensionen     ](https://wordpress.org/support/plugin/user-login-history/reviews/?filter=4)
 *  [  0 3-Sterne-Rezensionen     ](https://wordpress.org/support/plugin/user-login-history/reviews/?filter=3)
 *  [  1 2-Sterne-Rezension     ](https://wordpress.org/support/plugin/user-login-history/reviews/?filter=2)
 *  [  2 1-Sterne-Rezensionen     ](https://wordpress.org/support/plugin/user-login-history/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/user-login-history/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/user-login-history/reviews/)

## Contributors

 *   [ Faiyaz Alam ](https://profiles.wordpress.org/faiyazalam/)
 *   [ w3reign ](https://profiles.wordpress.org/w3reign/)
 *   [ Leonardo Gandini ](https://profiles.wordpress.org/nekokun/)
 *   [ Harm10 ](https://profiles.wordpress.org/harm10/)

## Support

Issues resolved in last two months:

     1 out of 1

 [View support forum](https://wordpress.org/support/plugin/user-login-history/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://www.paypal.me/erfaiyazalam/)