{"id":13356,"date":"2011-05-23T16:04:39","date_gmt":"2011-05-23T16:04:39","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/import-users-from-csv\/"},"modified":"2025-12-05T21:11:55","modified_gmt":"2025-12-05T21:11:55","slug":"import-users-from-csv","status":"publish","type":"plugin","link":"https:\/\/bel.wordpress.org\/plugins\/import-users-from-csv\/","author":14230356,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.3.1","stable_tag":"1.3.1","tested":"6.9.4","requires":"3.1","requires_php":"7.0","requires_plugins":null,"header_name":"Import Users from CSV","header_author":"WP All Import","header_description":"","assets_banners_color":"306c7c","last_updated":"2025-12-05 21:11:55","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/wordpress.org\/plugins\/import-users-from-csv\/","header_author_uri":"https:\/\/www.wpallimport.com\/","rating":4.1,"author_block_rating":5,"active_installs":10000,"downloads":285020,"num_ratings":44,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"0.5.1":{"tag":"0.5.1","author":"sorich87","date":"2012-02-20 10:27:10"},"1.0.0":{"tag":"1.0.0","author":"sorich87","date":"2013-03-14 10:27:00"},"1.0.1":{"tag":"1.0.1","author":"andrewza","date":"2022-01-28 09:40:15"},"1.1":{"tag":"1.1","author":"WPAllImport","date":"2023-11-08 18:55:20"},"1.2":{"tag":"1.2","author":"WPAllImport","date":"2024-02-23 09:00:48"},"1.3":{"tag":"1.3","author":"WPAllImport","date":"2024-04-11 19:01:47"},"1.3.1":{"tag":"1.3.1","author":"ix3","date":"2025-12-05 21:11:55"}},"upgrade_notice":{"1.0.1":"<ul>\n<li>Security and performance improvements.<\/li>\n<\/ul>","0.5.1":"<ul>\n<li>Installation error fix.<\/li>\n<\/ul>","0.5":"<ul>\n<li>Code improvement for easier integration with another plugin.<\/li>\n<\/ul>","0.4":"<ul>\n<li>RFC 4180 compliance, performance improvement and bug fix.<\/li>\n<\/ul>","0.3":"<ul>\n<li>Bug fix, performance improvement and internationalization.<\/li>\n<\/ul>","0.2.2":"<ul>\n<li>Fix bug with users import when no user meta is set.<\/li>\n<\/ul>","0.2.1":"<ul>\n<li>Various bug fixes and documentation improvements.<\/li>\n<\/ul>","0.2":"<ul>\n<li>Code cleanup. Added readme.txt.<\/li>\n<\/ul>","0.1":"<ul>\n<li>First release.<\/li>\n<\/ul>"},"ratings":{"1":7,"2":1,"3":1,"4":7,"5":28},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":2320381,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":2320381,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":2320381,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":2320381,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.5.1","1.0.0","1.0.1","1.1","1.2","1.3","1.3.1"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3412633,"resolution":"1","location":"plugin"}},"screenshots":{"1":"User import screen"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[567,11817,28271,224628,1917],"plugin_category":[59],"plugin_contributors":[87248,189393,78299,79105,78300],"plugin_business_model":[],"class_list":["post-13356","plugin","type-plugin","status-publish","hentry","plugin_tags-csv","plugin_tags-import-csv","plugin_tags-import-users","plugin_tags-import-users-from-csv","plugin_tags-users","plugin_category-utilities-and-tools","plugin_contributors-andrewza","plugin_contributors-paidmembershipspro","plugin_contributors-soflyy","plugin_contributors-sorich87","plugin_contributors-wpallimport","plugin_committers-ix3","plugin_committers-joeguilmette","plugin_committers-soflyy","plugin_committers-solideiglor","plugin_committers-wpallimport","plugin_support_reps-ix3"],"banners":{"banner":"https:\/\/ps.w.org\/import-users-from-csv\/assets\/banner-772x250.png?rev=2320381","banner_2x":"https:\/\/ps.w.org\/import-users-from-csv\/assets\/banner-1544x500.png?rev=2320381","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/import-users-from-csv\/assets\/icon-128x128.png?rev=2320381","icon_2x":"https:\/\/ps.w.org\/import-users-from-csv\/assets\/icon-256x256.png?rev=2320381","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/import-users-from-csv\/trunk\/screenshot-1.png?rev=3412633","caption":"User import screen"}],"raw_content":"<!--section=description-->\n<p>This plugin allows you to import users from an uploaded CSV file. It will add users with basic information as well as meta fields and user role.<\/p>\n\n<p>You can also choose to send a notification to the new users and to display password nag on user login.<\/p>\n\n<p><a href=\"https:\/\/profiles.wordpress.org\/wpallimport\/#content-plugins\">Check out our other free plugins.<\/a><\/p>\n\n<h4>Features<\/h4>\n\n<ul>\n<li>Imports all users fields<\/li>\n<li>Imports user meta<\/li>\n<li>Update existing users by specifying ID field<\/li>\n<li>Allows setting user role<\/li>\n<li>Sends new user notification (if the option is selected)<\/li>\n<li>Shows password nag on user login (if the option is selected)<\/li>\n<\/ul>\n\n<p>For feature request and bug reports, <a href=\"https:\/\/wordpress.org\/support\/plugin\/import-users-from-csv\">please use the forums<\/a>.\nCode contributions are welcome <a href=\"https:\/\/github.com\/soflyy\/import-users-from-csv\/\">on Github<\/a>.<\/p>\n\n<h4>Import Users From Any CSV\/Excel\/XML with WP All Import Pro<\/h4>\n\n<p>[youtube https:\/\/www.youtube.com\/watch?v=OrMzPw0p-EU \/]<\/p>\n\n<p><strong>WP All Import Pro<\/strong> can import WordPress users, WooCommerce products, ACF, custom post types, custom fields, taxonomies, and everything else:<\/p>\n\n<ul>\n<li><strong>Drag &amp; Drop to Import Any File:<\/strong> Give any CSV or XML to WP All Import, then drag and drop to map data from your file into WordPress.<\/li>\n<li><strong>Any Custom Post Type, Every Data Type:<\/strong> Import data to custom post types, with support for WooCommerce, ACF, custom fields, taxonomies, and everything else.<\/li>\n<li><strong>Import Images &amp; Galleries:<\/strong> Images can be uploaded, downloaded, or matched to media already in WordPress. Full support for WooCommerce product images and variation galleries.<\/li>\n<li><strong>Import Files from URL:<\/strong> Download and import files from external websites, even if they are password protected. URL imports are can be re-run to add, edit, and delete posts.<\/li>\n<li><strong>Scheduled Imports:<\/strong> WP All Import Pro can check periodically check a file for updates and then add, update, or delete to the imported posts accordingly.<\/li>\n<li><strong>Developer Friendly:<\/strong> Pass data through custom PHP functions. For example, use something like [my_function( {user_email[1]} )] in your template, to pass the value of {user_email[1]} to my_function and display whatever it returns.<\/li>\n<li><strong>Priority Support:<\/strong> Personal support from our team of expert developers with over a decade of experience importing and exporting WordPress data.<\/li>\n<li><strong>90 Day Money Back Guarantee:<\/strong> Not 100% happy? Let us know, and we\u2019ll promptly send you a refund. No questions asked.<\/li>\n<\/ul>\n\n<p>Check out <a href=\"https:\/\/www.wpallimport.com\/?utm_source=import-plugin-free&amp;utm_medium=readme&amp;utm_campaign=upgrade-to-pro\">WP All Import<\/a> today.<\/p>\n\n<ul>\n<li><strong><a href=\"https:\/\/www.wpallimport.com\/import-wordpress-users\/?utm_source=import-plugin-free&amp;utm_medium=readme&amp;utm_campaign=upgrade-to-pro\">Import users with WP All Import Pro<\/a>.<\/strong><\/li>\n<li>Need to <a href=\"http:\/\/www.wpallimport.com\/woocommerce-product-import\/?utm_source=import-plugin-free&amp;utm_medium=readme&amp;utm_campaign=upgrade-to-pro\">import XML and CSV to WooCommerce<\/a>? Check out our WooCommerce add-on.<\/li>\n<li>How to export WordPress users? Drag &amp; drop to <a href=\"http:\/\/www.wpallimport.com\/export-wordpress\/?utm_source=import-plugin-free&amp;utm_medium=readme&amp;utm_campaign=upgrade-to-pro\">export WordPress users<\/a> (and everything else) to a custom CSV, Excel, or XML with WP All Export Pro.<\/li>\n<\/ul>\n\n<!--section=installation-->\n<p>For an automatic installation through WordPress:<\/p>\n\n<ol>\n<li>Go to the 'Add New' plugins screen in your WordPress admin area<\/li>\n<li>Search for 'Import Users from CSV'<\/li>\n<li>Click 'Install Now' and activate the plugin<\/li>\n<li>Upload your CSV file in the 'Users' menu, under 'Import From CSV'<\/li>\n<\/ol>\n\n<p>For a manual installation via FTP:<\/p>\n\n<ol>\n<li>Upload the <code>import-users-from-csv<\/code> directory to the <code>\/wp-content\/plugins\/<\/code> directory<\/li>\n<li>Activate the plugin through the 'Plugins' screen in your WordPress admin area<\/li>\n<li>Upload your CSV file in the 'Users' menu, under 'Import From CSV'<\/li>\n<\/ol>\n\n<p>To upload the plugin through WordPress, instead of FTP:<\/p>\n\n<ol>\n<li>Upload the downloaded zip file on the 'Add New' plugins screen (see the 'Upload' tab) in your WordPress admin area and activate.<\/li>\n<li>Upload your CSV file in the 'Users' menu, under 'Import From CSV'<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id='how%20to%20use%3F'><h3>How to use?<\/h3><\/dt>\n<dd><p>Click on the 'Import From CSV' link in the 'Users' menu, choose your CSV file, choose if you want to send a notification email to new users and if you want the password nag to be displayed when they login, then click 'Import'.<\/p>\n\n<p>Each row in your CSV file should represent a user; each column identifies user data or meta data.<\/p>\n\n<p>If a column name matches a field in the user table, data from this column is imported in that field; if not, data is imported in a user meta field with the name of the column.<\/p>\n\n<p>Look at the example.csv file in the plugin directory to have a better understanding of how the your CSV file should be organized.<\/p>\n\n<p>You can try importing that file and look at the result.<\/p><\/dd>\n<dt id='credits'><h3>Credits<\/h3><\/dt>\n<dd><p>Thanks to Ulrich Sossou for initially creating this plugin. Be sure to <a href=\"https:\/\/profiles.wordpress.org\/sorich87\/\">check out his other WordPress plugins<\/a> or <a href=\"https:\/\/github.com\/sorich87\">GitHub profile<\/a>.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.3.1<\/h4>\n\n<ul>\n<li>bug fix: restore missing notice file<\/li>\n<\/ul>\n\n<h4>1.3<\/h4>\n\n<ul>\n<li>bug fix: don't instantiate serialized objects<\/li>\n<\/ul>\n\n<h4>1.2<\/h4>\n\n<ul>\n<li>BUG FIX: Ensure user running import has the ability to add users<\/li>\n<li>Update tested to<\/li>\n<li>minor UI update<\/li>\n<\/ul>\n\n<h4>1.1<\/h4>\n\n<ul>\n<li>ENHANCEMENT: Added support for WPCLI (@mircobabini)<\/li>\n<li>ENHANCEMENT: Added support for multiple roles during import, use comma-separated value for multiple roles (@mircobabini)<\/li>\n<li>ENHANCEMENT: Removed password nag option as this is no longer supported.<\/li>\n<li>ENHANCEMENT: New filter added 'is_iu_errors_filter' for throwing error messages. Helpful for third party developers extending onto IUCSV functionality.<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Fixed timeout bug on import.<\/li>\n<li>Improved settings area layout.<\/li>\n<li>General code refactor and improved security.<\/li>\n<li>Screenshot update.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Fixed bug where importing fields with \"0\" value doesn't work<\/li>\n<li>Added option to update existing users by username or email<\/li>\n<\/ul>\n\n<h4>0.5.1<\/h4>\n\n<ul>\n<li>Removed example plugin file to avoid invalid header error on\ninstallation<\/li>\n<\/ul>\n\n<h4>0.5<\/h4>\n\n<ul>\n<li>Changed code to allow running import from another plugin<\/li>\n<\/ul>\n\n<h4>0.4<\/h4>\n\n<ul>\n<li>Switched to RFC 4180 compliant library for CSV parsing<\/li>\n<li>Introduced IS_IU_CSV_DELIMITER constant to allow changing the CSV delimiter<\/li>\n<li>Improved memory usage by reading the CSV file line by line<\/li>\n<li>Fixed bug where any serialized CSV column content is serialized again\non import<\/li>\n<\/ul>\n\n<h4>0.3.2<\/h4>\n\n<ul>\n<li>Fixed php notice when importing<\/li>\n<\/ul>\n\n<h4>0.3.1<\/h4>\n\n<ul>\n<li>Don't process empty columns in the csv file<\/li>\n<\/ul>\n\n<h4>0.3<\/h4>\n\n<ul>\n<li>Fixed bug where password field was overwritten for existing users<\/li>\n<li>Use fgetcsv instead of str_getcsv<\/li>\n<li>Don't run insert or update user function when only user ID was\nprovided (performance improvement)<\/li>\n<li>Internationalization<\/li>\n<li>Added display name to example csv file<\/li>\n<\/ul>\n\n<h4>0.2.2<\/h4>\n\n<ul>\n<li>Added role to example file<\/li>\n<li>Fixed bug with users not imported when no user meta is set<\/li>\n<\/ul>\n\n<h4>0.2.1<\/h4>\n\n<ul>\n<li>Added missing example file<\/li>\n<li>Fixed bug with redirection after csv processing<\/li>\n<li>Fixed error logging<\/li>\n<li>Fixed typos in documentation<\/li>\n<li>Other bug fixes<\/li>\n<\/ul>\n\n<h4>0.2<\/h4>\n\n<ul>\n<li>First public release.<\/li>\n<li>Code cleanup.<\/li>\n<li>Added readme.txt.<\/li>\n<\/ul>\n\n<h4>0.1<\/h4>\n\n<ul>\n<li>First release.<\/li>\n<\/ul>","raw_excerpt":"Import users from a CSV into WordPress","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/bel.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/13356","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/bel.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/bel.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/bel.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=13356"}],"author":[{"embeddable":true,"href":"https:\/\/bel.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/wpallimport"}],"wp:attachment":[{"href":"https:\/\/bel.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=13356"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/bel.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=13356"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/bel.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=13356"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/bel.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=13356"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/bel.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=13356"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/bel.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=13356"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}