Admin tools: User Restore

Maintained by Picture of Sebsoft PluginsSebsoft Plugins, Picture of Rogier van DongenRogier van Dongen
The Sebsoft User Restore Plugin offers you the possibility to restore user accounts that were deleted from moodle.
310 sites
23 fans
Current versions available: 4

The Sebsoft User Restore Plugin offers you the possibility to restore user accounts that were deleted from moodle.

When the plugin has been installed, you can select a number of user accounts to restore and optionally send an email informing them their accounts have been restored.

This plugin takes the following into account:

  • Users to be restored are checked on e-mail: if an e-mail address already exists for an active account, this user will not be restored.
  • Users to be restored are checked on username: if an username already exists for an active account, this user will not be restored.
  • Users to be restored are checked on MNET host: if the MNET host of the account to be restored is not the locally configured one, this user will not be restored.

Important note

Moodle removes ALL relevant data upon deleting a user account, and only the record in the user table itself remains. This utility can't do anything about this and is only capable of restoring the record from the user table.

Important note for moodle 2.7 and up

Before Moodle 2.7 there is NO way we can retrieve all information. However, with Moodle 2.7 and the new event logging tables, the original user information is stored in the event data. Therefore, from Moodle 2.7 onwards, this plugin will try and restore the original user information from there.

This effectively means, that from Moodle 2.7 onwards, we will have the correct original username, email, idnumber, picture and mnethostid. Before that, only the email could be restored, and even that method is not foolproof (due to the fact the username is cleaned with PARAM_USERNAME upon deletion).


Screenshot #0
Screenshot #1
Screenshot #2
Screenshot #3
Screenshot #4


Picture of Sebsoft Plugins
Sebsoft Plugins (Lead maintainer)
Picture of Rogier van Dongen
Rogier van Dongen: Project leader
Please login to view contributors details and/or to contact them

Comments RSS

Show comments
  • Picture of Sebsoft Plugins
    Mon, Sep 21, 2015, 10:30 PM
    Hello Santiago,
    I'm unable to reproduce your issue on a clean Moodle2.9.1 environment running MySQL.
    However I sent you a personal message on how to contact us with more information and possibly, screenshots.
  • Picture of David Eisaura
    Thu, Sep 24, 2015, 11:46 PM
    I just used this tool, and it seems to have performed flawlessly. Thank you!
  • Picture of Jarrod Miles
    Wed, Feb 15, 2017, 7:22 PM
    After attempting to load the restore.php page in admin tools in Moodle 2.9.1, it's hung (even after 30 minutes of waiting).
    Seems to be continually cycling through

    SELECT CONCAT(firstname, ' ', lastname) AS deletedby, AS deletedbyid, l.timecreated AS timedeletedby FROM mdl_logstore_standard_log l JOIN mdl_user u ON WHERE component = 'core' AND action= 'deleted' AND = 'user' AND l.objectid = 'XXXX' ORDER BY l.timecreated DESC LIMIT 1

    as well another query. There are almost 7000 users on the Moodle.
  • Picture of Sebsoft Plugins
    Thu, Feb 23, 2017, 5:36 AM
    Hi Jarrod,

    This seems to be the query to detect who deleted the user. It might be wiser to disable that field if the tables are too big...
    Did it work in the end?
  • Picture of Rogier van Dongen
    Fri, May 12, 2017, 7:44 PM
    New version is here!
    No real changes worth mentioning other than a code overhaul to comply to stricter Moodle Coding Standards.
    Functionality tested up to Moodle 3.3
    On the roadmap (Jarrod Miles, thanks for bringing up this issue): think of a better method of generating the lists for restoring users. Either by pagination or (preferred) a searchbox / user picklist.

  • Picture of Rogier van Dongen
    Mon, Sep 25, 2017, 10:20 PM
    New version is here!
    Changes for Version 3.3.0 (build 2017092500)
    * Fixed deprecated pix_url references (replaced by image_url)
    * Added setting for maximum number of users to display on restore.php / restore form
    * Added paging bar on restore.php
    * Minimum required Moodle version: 3.3

  • Ricardo Caiado
    Sat, Mar 17, 2018, 10:52 PM

    Any update to Moodle 3.4?

  • Picture of Premi Sivanesan
    Tue, May 29, 2018, 2:59 PM
    Hi there
    I installed the plugin on 3.3 and every time I tried to use it, the Moodle site goes down.
    Any help would be appreciated.

  • Picture of Christos Savva
    Thu, May 30, 2019, 6:49 PM
    When am trying to access /admin/tool/userrestore/view/restore.php the request times out. I think one of the queries take too long to finish. Is there a way to fix this? Maybe a CLI command?
  • Picture of Rogier van Dongen
    Mon, Jun 17, 2019, 5:16 PM
    New version!
    We've attempted to resolve the issues around timeouts and page load times.
    This means we're now using a caching mechanism, hoping to speed up the process. Please do note the cache must be filled before the restore page can work.
    Do note that caching the deleted user info can be a very lengthy process. If you run into any problems, please send me a note.
    Cheers & good luck!
  • Picture of Jinny Watson
    Wed, Jun 19, 2019, 5:35 PM
    I am really happy to say it’s an interesting tool
  • Picture of Gemma Lesterhuis
    Mon, Oct 21, 2019, 9:23 PM
    I just send an email, it took me awhile to figure out why deleting users took so long until someone pointed this change out.
    This change has a increasing impact on deleting users. You should be aware of a difference between a few seconds up until half an hour depending on the number of users your deleted at the same time. I delete batches of users between the 30 and 2000.
  • Picture of Glen MacPherson
    Thu, Nov 28, 2019, 2:43 AM
    Hi. When I try to restore deleted users, it detects 118 Users to restore, but the username and email fields are blank for all of them, and I get an "error writing to database" if I try to restore one or more of them. Any thoughts?
  • Picture of Rogier van Dongen
    Thu, Dec 5, 2019, 5:55 PM
    Hello Glen,
    I do have an idea, but this would have to be checked before I can be certain this assumption is correct.
    Assuming you run a newer Moodle version, I'm making the assumption Moodle's most recent record in the logstore for any of the deleted users might lack the correct information.
    This would be the information that should be available in the "other" field of the table.
    If you have access to the database you could try and see if my assumption is correct by filtering the logstore under the following conditions:
    component = 'core'
    action= 'deleted'
    target = 'user'
    objectid = Do note you should sort in descending order on the timecreated field of the logstore, then lookat the first record found (i.e. the most recent one for the specific user)

    I have tried to message you from's messaging system but I seem to be unable to send you a message at all.
    If you need/want more support, I advice you to contact me directly, you can send me a message on if needed so we can go from there.

    For everyone else reading along: the note Gemma added on Oct 21 is one of the side effects of a rewrite.
    Older version of this plugin worked directly on the logstore table. This caused an gigantic CPU load and in many cases, a timeout when trying to load the overview page.
    The newer version works by hooking in to Moodle's user_deleted event handler, which executes on a per user basis, directly after the user has been deleted.
    To speed up loading the information on the overview pages in this plugin, information is stored in a cache record (which of course is cleaned after a purge).
    While this does speed up the overview pages, it does have the side effect of potentially massively slowing down the process of batch-deleting 100s or 1000s of users.

    As soon as I have the time, I'm willing to look into a solution to resolve this new side effect. However, for the time being I cannot make any promises yet.

  • Picture of Rogier van Dongen
    Thu, Dec 5, 2019, 5:59 PM
    ^ for the message above: objectid = "ID of the moodle user".
    This information went missing. Apparently this message window cleans out anything resembling HTML tags (would be nice if Moodle would convert this to visible characters instead of completely cleaning it)
1 2
Please login to post comments