Jump to main content Jump to doc navigation


Changes the password of a user. It first matches the oldPassword you specify to the current password using modUser->passwordMatches($oldPassword), then sets the password and finally it invokes the OnUserChangePassword event. Returns true if the password was changed, false if not.


API Doc: http://api.modx.com/revolution/2.2/db_core_model_modx_moduser.class.html#%5CmodUser::changePassword()

boolean changePassword (string $newPassword, string $oldPassword)


Change the password of the user 'foobar' from 'boo123' to 'b33r4me'

$user = $modx->getObject('modUser',array('username' => 'foobar'));
$user->changePassword('b33r4me', 'boo123');

Change the password of the user currently logged in from 'mypass' to 's3cur3d'.


See Also

Support the team building MODX with a monthly donation.

The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.


  • modmore
  • Jens Wittmann – Gestaltung & Entwicklung
  • Fabian Christen
  • Dannevang Digital
  • Digital Penguin
  • Sepia River Studios
  • CrewMark
  • Chris Fickling
  • deJaya
  • Following Sea
  • Anton Tarasov
  • eydolan
  • Raffy
  • Lefthandmedia
  • Murray Wood
  • Nick Clark
  • Snow Creative
  • Helen
  • JT Skaggs
  • krisznet
  • YJ
  • Yanni
  • Richard


$371 per month—let's make that $500!

Learn more