Open main menu


< Manual:Hooks
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.