Jump to navigation Jump to search
Available from version 1.5.0
Called after a user account is created
Define function:
public static function onAddNewAccount( User $user, $byEmail ) { ... }
Attach hook:

In extension.json:

	"Hooks": {
		"AddNewAccount": "MyExtensionHooks::onAddNewAccount"

For MediaWiki ≤1.25:

$wgHooks['AddNewAccount'][] = 'MyExtensionHooks::onAddNewAccount';
Called from:File(s): SpecialUserLogin.php

For more information about attaching hooks, see Manual:Hooks.
For examples of extensions using this hook, see Category:AddNewAccount extensions.


  • $user: the User object that was created. (Parameter added in 1.7)
  • $byEmail: true when account was created "by email" (added in 1.12)

This does not include accounts auto-created by authentication extensions like CentralAuth. For that, see Manual:Hooks/AuthPluginAutoCreate .


Inside a function called by the hook, you can grab user variables such as:

  • User's name: $user->mName
  • User's real name: $user->mRealName
  • User's email address: $user->mEmail


From MediaWiki 1.27 on, the hook is deprecated and superseded by LocalUserCreated , as part of the changes that introduced AuthManager . Logic that interacts with form fields or other request data should be moved into a provider.