Import Joomla Users from Excel or CSV File
Migrate users with custom data fields as User-Profile plugin is supported

  • Imports new users & updates data of existing users in Joomla.
  • Supports custom "Users Fields" and User-Profile plugin fields.
  • Sends customized "Welcome" emails to imported users.
This remarkable extension allows you to import users from Excel or CSV file into Joomla. All users will be created as regular Joomla users, so you can manage them in the admin panel and new users get all benefits of registered accounts on your web-site!

User import extension supports wide range of fields:

  • Joomla core user data: Id, Name, Username, Password, Email, Params, Register Date and Group(s).
  • Joomla Users Fields: Any custom fields created by new Joomla 3.7+ Fields system, read more.
  • Preinstalled User-Profile plugin: Address 1, Address 2, City, Region, Country, Postal/ZIP Code, Phone, Website, Date of Birth, About, and any other custom fields.

Main features of user import:

  • Creates new users, update data of existing users or does both actions at the same time.
  • Columns order in Excel/CSV file is not essential.
  • Allows you to import users into one or a few Joomla groups.
  • Gives possibility to set new password for users (plain or already encrypted one).
  • If there are no passwords in your file - import can create passwords for new users automatically.
  • Notifies new users by email about registration and provides with login/password, read more.
  • "Email Sending Report" is available, so you can check if emails were sent to users.
  • Allows to save import settings into "Profile" for frequent import, read more.
  • Makes it possible to block users automatically that are no longer exist in Excel/CSV file.
  • Grants and revokes access to import extension for your coworkers.
  • Imports multiple checkbox values.
  • Provides auto user import by schedule(using Cron).
  • Imports into "Improved AJAX Import & Register" extension fields.
  • Supports most of the third party components like "K2" or "AcyMailing".

What people say about import extension:

Difference between "User-Profile Plugin" fields and "Joomla User Fields".

User-Profile plugin is a preinstalled Joomla extension which is disabled by default.
You can enable it here: Admin panel->Extensions->Plugins:

Plugin allows you to extend Joomla core user fields and adds one more tab with additional fields to user profile.
You can find these additional fields here: Admin panel->Users->Manage->Select any user:

Plugin also puts these fields for each registered user in his profile on the website, so he can edit data in these fields. Unfortunately there is no easy way to customize/add/remove these fields without additional extension or extra codding work (however if you're familiar with XML, you can do it). Our import extension supports all these fields and can import data from excel/csv file in these fields. Even if you customized or created new fields via XML - import extension will support them.

Joomla User Fields supported by Joomla 3.7 and later. These fields have a huge advantage compared to User-Profile plugin - you can customize/add/remove them as you need. The wide range of available fields include: text, dropdown, link, check box and much more. You can find these fields in Admin panel->Users->Fields

On the screenshot you can see that four fields have been created, three regular text fields (skype, Tax Id and Position) and one dropdown field with car models. These fields are available in the admin panel and in user's account on website, so admin and user can read and change this data.

All fields created with "Joomla User Fields" system supported by our user import extension.

Conclusion: User-Profile plugin is a much older and less flexible way to store users data. So if you are looking for a way to store more data about users then it is better to start with new "Joomla User Fields". However if your website uses "User-Profile" fields for a long time and it perfectly meets your needs then there is no necessity to stop using it.

Import "Profiles" for regular use.

"Profile" is like a template with stored import settings. It was developed to save your time by setting up import settings once instead of doing this for each import.

Let's see how to set it up. For example, we've got a file with users from a third-party website and we need to create accounts for those users in our Joomla website. Since we must update users every week - it's better to use "Profiles" feature.

How to create "Profile":
1. Upload excel/CSV file.
2. Select Joomla group, match file's columns with user fields and specify other settings you may need.
3. Click on "SAVE PROFILE" button and give "Profile" a name. That's it, a new "Profile" has been created.

How to use "Profiles":
1. Start a new import. On step 1 you will see recently created profile. Click on upload button and select excel/CSV file.
2. Click "Next" and on step 2 all settings we’ve chosen before are already pulled up from "Profile" and automatically applied. So we only need to check if everything is okay and go to the next step.

Here is some useful cases when "Profile" feature comes in handy:
- file with users information has to be imported regularly, e.g. each day or week;
- you have two or more different excel/CSV files and each file has its own columns’ order;
- you need to import all users from file #1 into e.g. "Managers" group and users from file #2 into "Editors" group.

That's all you need to know to start saving time now!

Sending emails to imported and/or updated users.

“Import Users” tool provides option to notify new and/or existing users. With this option you can send personalized messages along with users' data like Name, Address, Password, etc.

In the example, we’ll show how to set up email sending to newly imported users. Since the user mailing is turned off by default, let’s enable it by the following steps:

1. Go to 2nd step.

2. In "Email Settings" select "Notify..." options.

3. Write email message.

“Import Users” offers two types of variables:

  • “Default” – pre-defined variables list that includes commonly used variables, like Name, Username, Website;
  • “Dynamic” – they pull values from imported file on the fly.

You can use “Default” & “Dynamic” variables in the "Email Template" popup. Both types of variables can be put into email “Subject” and email “Body”. Using of "Default" variables is easy, just place in editor listed variables like %username% and it will be replaced with the real username.

Data for "Dynamic" variables are taken from uploaded excel or csv file. So, to use these variables it's required to have already matched columns to Joomla fields. For example if we match “Name”, “Username”, “Email”, “Address”, “Country” and “Postal code” on step 2 we will be able to use these variable in Email Template popup.

Then click at "Add Fields" button and we'll see dynamic variables of matched columns. To insert any of the above variables, just click on it. If list of variables is empty, that means that columns from the file haven’t been matched with Joomla fields, so match the columns first.

In case you want to use custom text colors, insert images or change sizes, please use “Source Code”. With it you can change HTML the way you need. To turn it on, go to “Tools” - > “Source Code”:

After finishing configuration of email template click “Save”.

In case you want to email the existing users as well, enable “Notify existing users” option and set it up as before.

  • By default Joomla has preinstalled plugin called "User - Profile".

    It allows to store more data about users like Address, City, Country, Website, etc.

    But this plugin is disabled by default. To enable it you need to go to:
    Admin Panel->Extensions->Plugins and use search to find "User - Profile" plugin.

    If plugin disabled - enable it, and you will be able to see additional information for each users here:
    Admin Panel->Users->Manage->Select Any User->User Profile Tab

  • “Welcome” mails are disabled by default, but you can enable them in advanced settings on Step 2. You can even create your own message and send login/password.

  • Yes, our import supports all characters from UTF-8, for example: Ü, ß, É, 字
    But your file should be in UTF-8

  • Don't match (using sandwich) the password column on step 2. The import will create password column automatically on step 3

  • You need to do next steps:
    1. You need to click on "Switch to Advanced mode".
    2. Then you need to check "Notify newly added users".
    3. At message dialog click "Tools" then click "Source code"
    4. In "Source code" editor you can use HTML to customize your email the way you need.

  • 1. Your file should contain column where Groups are separated by comma, e.g. "Editor, Manager, Administrator". So that one user can have any amount of Groups.
    2. On "Step 2 (Settings)" match the column with "Groups" field. Please note that you no longer need to use "Joomla group:" dropbox.

  • Fortunately, there is such possibility.
    Joomla has "Require Password Reset" option and when it's enabled user will be required to change his password on the first/next login.
    To enable this you will need to have column in excel/csv file with values "Yes" (to require password reset) and "No" to not require it. And match this column with Joomla "Require Password Reset" field.

  • Unfortunately Auto updater is not available for this extension.
    To get the latest version of import you need:
    1. Go to our website:
    2. Login and go to "My Products" menu.
    3. Here you will find all your extensions and can download them.

  • To find out the reason why some users can’t be imported - you just need to hover your mouse over the user in tab “Won’t be imported”.

  • Our extension is using standard Joomla functions to send emails, so actually we don't have much control on this process. Import extensions just gives email to Joomla and if Joomla's and Server's mail configurations are correct - email will be sent to inbox.

    So if users don't receive emails the problem might be in:

    1. Incorrect Joomla email configuration - ask your developer to check it out.
    2. Problems with mail service on the server - ask your system administrator to check it out.
    3. Some emails comes to spam/junk folder - ask user to check these folders too.
  • Our extension is using standard Joomla functions to send emails, so actually we don't have much control on this process.

    This issue is based on a few factors, which can be fixed/changed by server administrator and domain owner.

    1. Correct mail server configuration
    2. Server's IP might be black listed, you can check it here:
    3. You can use DKIM, SPF, DMARC to make your domains valid for mass mailing
    4. Keep valid reverse DNS records for the IP address(es).
  • Maximum file upload size is a global PHP setting (called upload_max_filesize), you need to increase this value. Most hosting providers allows to change this setting in your Hosting Control Panel. Also you can ask your system administrator or developer to change it.

  • You need to send email to us and provide us with details:

    1. How to reproduce bug
    2. Screenshots of bug
    3. Best way to describe the problem is to create video (you can use software like Jing)

    If you subscribed to support, you can count on fast update (1-2 work days)

  • Our extension doesn't support Joomla's auto updater.

    You need to login on our web-site and download last version:
    My Account -> My Products -> Select your product -> Download button
    After it you need to remove old version from your Joomla and install a new one.

  • If you need some additional features, there are 2 ways:

    1. Send us email about new feature, and we will try to implement it in next version. As we receiving a lot of suggestions some of them can be rejected.
    2. We can create special release for you, in a short time, with all improvements you need for separate payment. Please contact us to know more about it.
  • Contact form on our web-site:

Related plugins:

Export/Download Joomla users (+ User Profile) to Excel or CSV file

Export User Profile Users
Filter & Download users with all custom data that User-Profile plugin contains

1.6 1.7 2.5 3.x 4.x


Import Users to Joomla step 1 Import Users to Joomla step 2 Import Users to Joomla step 3 Import Users to Joomla step 4

Joomla versions:

1.6 1.7 2.5 3 4 5
payment security
payment security

Related plugins

Export User Profile Users

Export User Profile Users

Write your question or comment: