The User Import Manager Interface consist of a single page and provides all options to rapidly import a batch of users into the MODX user database. There is no limit for the count of users to import.

Screenshot: User Import Management Interface - Import Screen

User Interface Description

All interface fields should be pretty self-explanatory but for the sake of completeness here is a description of all fields:

  • CSV File
    Select a CSV file which holds the user-data in the required format from a local path. The selected file will be uploaded to the server and processed there.
  • First row holds column headers
    This option needs to be checked if the first line of your CSV file holds the name of the column headers.
  • Batch Size
    The number of records to import from the CSV file beginning at line 1. If set to 0, all records will be imported.
  • Field Delimiter Character
    Enter the specific delimiter character which is used in your CSV file to seperate the values in each row. Most commonly used delimiters are ; (semi-colon) and , (colon)
  • Field Enclosure Character
    Specifies the character which is used to enclose strings in your CSV file. Any field may be quoted. Fields containing a line-break, double-quote, and/or commas must be quoted otherwise the CSV file will likely be impossible to process correctly. Most commonly used enclosure character is the " (double quote)
  • Import Options / Set Email Address as Username
    If this option is checked, the username field of your CSV file is ignored and the value from the email address field is used instead. The username field can also be empty ("") in this case.
  • Create import-markers
  • Import Options / Create import-markers
    If this option is checked, the date/time of the import and a unique Import-Key is written to the extended fields of each imported user.
  • Assign MODX User Group(s) and Roles / The User Groups tree
    Check one or more MODX User Groups and the imported users will be automatically added to this Groups.
  • MODX User Roles
    Select a Role and it will be assigned to all imported users. Please note that at least the Role "Member" is used if no other Role is selected (this is a base requirement of the MODX ACL system!).

The Import Process

To start the import process, simply hit Start import button from the Action bar (top right). A MODX console log window opens and you can watch how your users are imported. The console will also show any errors which occure.

Screenshot: User Import Management Interface - Console

The date/time of the import and a unique Import-Key is written to the extended fields of each imported user. With this unique Import-Key it is easy to identify each batch of imported users for later reference.
One of the next versions of User Import will include a feature to completely roll back an import based on this Import-Key!