Highly customizable and extensible user management, authentication, and authorization Yii2 extension

Installs: 198 003

Dependents: 21

Suggesters: 1

Security: 0

Stars: 290

Watchers: 49

Forks: 138

Open Issues: 107


1.6.3 2024-03-18 21:23 UTC


Documentation Status Join the chat at https://gitter.im/2amigos/yii2-usuario Packagist Version Latest Stable Version Total Downloads Build Status Latest Unstable Version
Scrutinizer Code Quality

Yii 2 usuario is a highly customizable and extensible user management, RBAC management, authentication, and authorization Yii2 module extension.

It works extensively with Yii's Container making it really easy to override absolutely anything within its core. The module is built to work out of the box with some minor config tweaks and it comes with the following features:

  • Backend user/profile/account management
  • Backend RBAC management
  • Login via username/email + password process
  • Login via social network process
  • Password recovery process
  • Two-Factor authentication process
  • Google reCaptcha

We considered that RBAC was essential to be included into any user management module, even if you simply use one user with admin role, its much better to actually work with RBAC just in case your application scales in the future.

Boostrap 4 and 5 support

With the release of 1.6, contributors started implementing changes for supporting newer versions of the Boostrap library, being Usuario stuck at 3.

Up until around May 2023, the master branch will remain stable, so devs who in these years relied on it for deployment can have time to migrate to a stable version. BS5 development is ongoing on branch 2.0.0-dev, which will eventually be merged in master around May.

You can check issues #476, #488, #500 for updates, or the branch itself.


You can read the latest docs on http://yii2-usuario.readthedocs.io/en/latest/

Need Help?

If you have issues, please use the Gitter room of this repository https://gitter.im/2amigos/yii2-usuario. Please, remember that we may not be online all the time. We expect that we can build a community around the users of this module


Please, read our CONTRIBUTION guidelines.


This module is highly inspired by the excellent work of Dektrium on both of its modules:

In fact, we have used some of its processes, commands, views, and some of its attribute names to somehow standardize the modules and make it easier for our developers to swap from Dektrium's modules to our own.

Beyond Software