Admin tools: Merge user accounts

Maintained by Picture of Nicolas Dunand Nicolas Dunand, Picture of Jordi Pujol-Ahulló Jordi Pujol-Ahulló
This administration tool will merge two Moodle user accounts into one.
640 sites
36 fans
Moodle 2.2, 2.3, 2.4, 2.5, 2.6, 2.7, 2.8, 2.9, 3.0, 3.1, 3.2

The intent is to assign all activity & records from user A to user B. This will give the effect of user B seeming to have done everything both users have ever done in Moodle.

This tool replaces the old report_mergeusers, which is now obsolete.


Screenshot #0
Screenshot #1
Screenshot #2


Picture of Nicolas Dunand
Nicolas Dunand (Lead maintainer): author
Picture of Jordi Pujol-Ahulló
Jordi Pujol-Ahulló: author
Picture of Forrest Gaston
Forrest Gaston: contributor
Mike Holzer
Mike Holzer: contributor
Please login to view contributors details and/or to contact them

Comments RSS

Show comments
  • Picture of Nicolas Dunand
    Thu, 21 Jul 2016, 5:02 PM
    Hello Anna,

    Yes, indeed it should. Thanks for reporting back.

  • Picture of Austin Powell
    Wed, 7 Sep 2016, 12:43 AM
    We just updated to Moodle 3.1 and updated the code for the plugin from the github master branch as described.
    When trying to merge two users though, we're getting a "Coding error detected" message. The stacktrace is copied below. Any ideas? Let me know if I should post this on your Github as an issue instead.

    Coding error detected, it must be fixed by a programmer: moodle_database::update_record_raw() id field must be specified.
    More information about this error
    ×Debug info:
    Error code: codingerror
    ×Stack trace:
    line 1376 of /lib/dml/mysqli_native_moodle_database.php: coding_exception thrown
    line 1432 of /lib/dml/mysqli_native_moodle_database.php: call to mysqli_native_moodle_database->update_record_raw()
    line 57 of /admin/tool/mergeusers/lib/events/olduser.php: call to mysqli_native_moodle_database->update_record()
    line ? of unknownfile: call to tool_mergeusers_old_user_suspend()
    line 3955 of /lib/deprecatedlib.php: call to call_user_func()
    line 4216 of /lib/deprecatedlib.php: call to events_dispatch()
    line 809 of /lib/classes/event/base.php: call to events_trigger_legacy()
    line 231 of /admin/tool/mergeusers/lib/mergeusertool.php: call to core\event\base->trigger()
    line 135 of /admin/tool/mergeusers/index.php: call to MergeUserTool->merge()
  • Picture of James Todd
    Thu, 6 Oct 2016, 9:01 PM
    Sorry if this is already on the comments list.
    I added it but it either didn't save or I can't find it.

    I've just upgraded to Moodle 3.1 and I'm seeing this message in the Notifications:

    The following plugins in your system are using Events 1 API deprecated handlers: 'tool_mergeusers'. Please, update them to use Events 2 API.

    I downloaded the latest version from Git but made no difference.
  • Picture of Mehmet Sen
    Wed, 2 Nov 2016, 12:09 AM
    I guess the current zip version is not compatible with the 3.1 version when installing the with zip file?

    It gives the following error:

    Validating tool_mergeusers ... Error
    [Error] Extracted file not found [{"file":"mergeusers\/styles.css"}]
    Installation aborted due to validation failure
  • Picture of Nicolas Dunand
    Wed, 2 Nov 2016, 12:35 AM
    Hi Austin,

    Sorry about the delay. Yes, please post this issue to GitHub as I can't do it right now. There it should be reviewed and fixed eventually,
  • Picture of Nicolas Dunand
    Wed, 2 Nov 2016, 12:36 AM

    Indeed this is a lower priority issue. It does not alter functionality yet but will in future versions of Moodle. We're looking into it and this will be corrected to fully support upcoming Moodle version as they are released.
  • Picture of Nicolas Dunand
    Wed, 2 Nov 2016, 12:38 AM

    This should in fact work but hasn't been tester with Moodle's own plugin installer. You should be able to install copying files to the file system without any issues though.
  • Picture of Mehmet Sen
    Wed, 2 Nov 2016, 2:50 AM
    Thanks Nicolas, copy pasting the folder worked out!
    Hopefully "Events 1 API deprecated... " warning would be corrected in next release as you indicated above.
  • Picture of Jordi Pujol-Ahulló
    Thu, 3 Nov 2016, 11:39 PM
    Hi Adrian (,

    Could you please check the conversation at and say something with respect to your question?

    Thanks in advance!

  • Picture of David Cunningham
    Wed, 1 Feb 2017, 6:04 PM

    I have recently tried installing this Plug in on Moodle 2.8 and once I have installed the plug in and try to run it, I receive the following error message, Exception thrown when merging: 'Error reading from database".
    Unknown column 'id' in 'field list'
    #0 /var/www/html/moodle/lib/dml/mysqli_native_moodle_database.php(1080): moodle_database->query_end(false)
    #1 /var/www/html/moodle/admin/tool/mergeusers/lib/table/generictablemerger.php(75): mysqli_native_moodle_database->get_records_sql('SELECT id FROM ...')
    #2 /var/www/html/moodle/admin/tool/mergeusers/lib/mergeusertool.php(288): GenericTableMerger->merge(Array, Array, Array)
    #3 /var/www/html/moodle/admin/tool/mergeusers/lib/mergeusertool.php(216): MergeUserTool->_merge('3110', '11041')
    #4 /var/www/html/moodle/admin/tool/mergeusers/index.php(135): MergeUserTool->merge('3110', '11041')
    #5 {main}

    Can anybody lend a helping hand if they have any idea on what the problem could be?
  • Picture of Jordi Pujol-Ahulló
    Wed, 1 Feb 2017, 7:32 PM
    Hi David,

    I think this is due to some local plugin you have installed that does not follow the Moodle standards, and some table from your database does not have a column named "id". Is that possible? The pity is that the error does not show which is the specific table that the process is dealing with.

    Could you check that?


  • Picture of Jose Galindo
    Wed, 19 Apr 2017, 1:20 AM
    First of all, congratulations on the great plugin,
    I had 2 doubts:
    1. How can I do so that the user origin data is not deleted?
    2. How can I choose which data I want to merge?
    A greeting and thanks in advance.
  • Picture of Jordi Pujol-Ahulló
    Thu, 20 Apr 2017, 2:34 PM
    Hi Jose!

    Thanks for your comments.

    An overall idea (with few exceptions):

    * What this plugin does is just replace the origin user id by the targer user id, so that is reflects as if all activity into Moodle was performed by the target user.
    * There are only few exceptions where this plugin deletes useless records. See de from the plugin for more details.

    1. By now, only in certain cases records are deleted, and mainly only the value is replaced by the target So that, actually, the records remain the same. I insist, with few exceptions.
    2. There is no possibility to choose wich data to merge, except user_preferences, user_private_key and user_info_data, which you can say (from plugin settings) that those records remain linked to every separated user.

    Hoping that helps on clarifying your doubts.

    Regards and thanks for asking!

  • Picture of Lai Wei
    Tue, 25 Apr 2017, 4:37 PM
    Just to let you know, the latest version of the plugin doesn't work with Moodle versions before 2.5 inclusive despite it declares it does. The issue is with the event triggering. Before 2.5 are triggered using events_trigger(), while after 2.6 it's replaced by $event->trigger(). I know 2.5 is aged but it may be better if the version information can be fixed.
  • Picture of Jordi Pujol-Ahulló
    Tue, 25 Apr 2017, 6:21 PM

    Thanks for the feedback!

    We will update it, as you suggested!

1 2 3 4 5 6
Please login to post comments