Sample Import Format

Sample CSV Format

Here's an example of a CSV file for importing users:

username,email,name,password,groups,block,profile_phone,profile_city
johndoe,john@example.com,John Doe,ChangeMe123!,Registered,0,+1234567890,New York
janedoe,jane@example.com,Jane Doe,SecurePass456!,"Registered, Author",0,+0987654321,Los Angeles
bobsmith,bob@example.com,Bob Smith,,Registered,0,,London

Field Explanations

Field	Description	Required
username	Unique login username	Yes
email	Unique email address	Yes
name	Full display name	Recommended
password	Plain text password (will be hashed)	Optional
groups	User group names (comma-separated)	Optional
block	Block status: 0=active, 1=blocked	Optional
profile_*	Profile fields (phone, city, etc.)	Optional

JSON Format

[
  {
    "username": "johndoe",
    "email": "john@example.com",
    "name": "John Doe",
    "groups": ["Registered"]
  },
  {
    "username": "janedoe",
    "email": "jane@example.com",
    "name": "Jane Doe",
    "groups": ["Registered", "Author"]
  }
]

XML Format

<users>
  <user>
    <username>johndoe</username>
    <email>john@example.com</email>
    <name>John Doe</name>
    <groups>Registered</groups>
  </user>
</users>

Download Sample Template

Click the Download Sample Template button on the Import page to get a pre-formatted CSV file with example data.

Tips for Successful Import

• Ensure usernames are unique (3-150 characters)
• Use valid email addresses
• For multiple groups, separate with commas
• Leave password empty to auto-generate
• Use UTF-8 encoding for special characters
• Test with a small batch first