Really Simple CSV Importer
Alternative CSV Importer plugin. Simple and powerful, best for geeks.
Safe pick
Yes — Really Simple CSV Importer is a safe, well-maintained plugin to use in 2026. It runs on 40K+ sites, is rated 4.9/5 and was last updated 4 months ago, and scores 80/100 on our health check.
- Proven at scale on 40K+ active sites
- Loved by users — 4.9/5 from 107 reviews
- Momentum — downloads up 94.6% vs the previous 30 days
How does it stack up?
Side-by-side on installs, updates, ratings & supportDaily downloads
Download spikes usually follow a new release — each site that auto-updates counts as a download.
Rankings
Where Really Simple CSV Importer stands todayWordPress.org search rankings
Live position in the plugin search, top 100| Keyword | Position |
|---|---|
| acf | #66 |
| cfs | #1 |
| csv | #1 |
| importer | #3 |
| scf | #4 |
Version adoption
Share of active sites per release.
Rating breakdown
★★★★★★★★★★ 4.9 from 107 reviews
About Really Simple CSV Importer
From the official readme · v1.3.1Description
Alternative CSV Importer plugin. Simple and powerful, best for geeks.
- Category support
- Tag support
- Custom field support
- Smart Custom Fields support
- Custom Field Suite support
- Advanced Custom Fields support
- Custom Taxonomy support
- Custom Post Type support
- Filter hook for dry-run-testing
- Filter hooks for customized csv data importing to database
- Action hook for update post data after importing to database
You can get example CSV files in /wp-content/plugins/really-simple-csv-importer/sample directory.
Available column names and values:
IDorpost_id: (int) post id.
This value is not required. The post ID is already exists in your blog, importer will update that post data. If the ID is not exists, importer will trying to create a new post with suggested ID.post_author: (login or ID) The user name or user ID number of the author.post_author_login: The user name of the author.post_date: (string) The time of publish date.post_content: (string) The full text of the post.post_title: (string) The title of the post.post_excerpt: (string) For all your post excerpt needs.post_status: (‘draft’ or ‘publish’ or ‘pending’ or ‘future’ or ‘private’ or custom registered status) The status of the post. ‘draft’ is default.post_password: (string) The password to protect the post. The password is limited to 20 characters.post_name: (string) The slug of the post.post_parent: (int) The post parent id. Used for page or hierarchical post type.menu_order: (int)post_type: (‘post’ or ‘page’ or any other post type name) (required) The post type slug, not labels.post_thumbnail: (string) The uri or path of the post thumbnail.
E.g. http://example.com/example.jpg or /path/to/example.jpgpost_category: (string, comma separated) slug of post categoriespost_tags: (string, comma separated) name of post tagstax_{taxonomy}: (string, comma separated) Any field prefixed withtax_will be used as a custom taxonomy. Taxonomy must already exist. Entries are names or slugs of terms.{custom_field_key}: (string) Any other column labels used as custom fieldcfs_{field_name}: (string) If you would like to import data to custom fields set by Custom Field Suite, please add prefixcfs_to column header name.scf_{field_name}: (string) If you would like to import data to custom fields set by Smart Custom Fields, please add prefixscf_to column header name.comment_status: (‘closed’ or ‘open’) Default is the option ‘default_comment_status’, or ‘closed’.
Note: Empty cells in the csv file means “keep it”, not “delete it”.
Note: To set the page template of a page, use custom field key of _wp_page_template.
Note: If providing a post_status of ‘future’ you must specify the post_date in order for WordPress to know when to publish your post.
Note: If the post_type value is attachment, you can use post_thumbnail field to define media URL or path.
Advanced Custom Fields plugin integrate
If advanced custom field key is exists, importer will trying to use update_field function instead of built-in add_post_meta function.
How to find advanced custom field key: Finding the field key
Official public repository
This plugin is now maintained by websoudan, taking over from the original author Takuro Hishikawa (@hissy). Thank you hissy for all the years of work!
Add star and read future issues about rs-csv-importer on GitHub!
Thanks
Cover banner designed by @luchino__
How to debug import data
Really Simple CSV Importer Debugger add-on enables you to dry-run-testing and show more detailed post, meta, taxonomy data of each csv row.
Download from gist.
How to customize import post data
There are three filters available in the importer.
really_simple_csv_importer_save_post
This filter is applied to post data.
Parameters:
$post– (array)(required) post data$is_update– (bool) update existing post data, or insert new post data
Example:
function really_simple_csv_importer_save_post_filter( $post, $is_update ) {
// remove specific tag from import data
if (isset($post['post_tags'])) {
$_tags = array();
foreach ($post['post_tags'] as $tag) {
if ($tag != 'Apple') {
$_tags[] = $tag;
}
}
$post['post_tags'] = $_tags;
}
return $post;
}
add_filter( 'really_simple_csv_importer_save_post', 'really_simple_csv_importer_save_post_filter', 10, 2 );
really_simple_csv_importer_save_meta
This filter is applied to post meta data.
Parameters:
$meta– (array)(required) post meta data$post– (array) post data$is_update– (bool)
Example:
function really_simple_csv_importer_save_meta_filter( $meta, $post, $is_update ) {
// serialize metadata
$meta_array = array();
if (isset($meta['meta_key_1'])) $meta_array[] = $meta['meta_key_1'];
if (isset($meta['meta_key_2'])) $meta_array[] = $meta['meta_key_2'];
$meta = array( 'meta_key' => $meta_array );
return $meta;
}
add_filter( 'really_simple_csv_importer_save_meta', 'really_simple_csv_importer_save_meta_filter', 10, 3 );
really_simple_csv_importer_save_tax
This filter is applied to post taxonomy data (categories and tags are not included, these are post data).
Parameters:
$tax– (array)(required) post taxonomy data$post– (array) post data$is_update– (bool)
Example:
function really_simple_csv_importer_save_tax_filter( $tax, $post, $is_update ) {
// Fix misspelled taxonomy
if (isset($tax['actors'])) {
$_actors = array();
foreach ($tax['actors'] as $actor) {
if ($actor == 'Johnny Dep') {
$actor = 'Johnny Depp';
}
$_actors[] = $actor;
}
$tax['actors'] = $_actors;
}
return $tax;
}
add_filter( 'really_simple_csv_importer_save_tax', 'really_simple_csv_importer_save_tax_filter', 10, 3 );
really_simple_csv_importer_save_thumbnail
This filter is applied to thumbnail data.
Parameters:
$post_thumbnail– (string)(required) the thumbnail file path or distant URL$post– (array) post data$is_update– (bool)
Example:
function really_simple_csv_importer_save_thumbnail_filter( $post_thumbnail, $post, $is_update ) {
// Import a local file from an FTP directory
if (!empty($post_thumbnail) && file_exists($post_thumbnail)) {
$upload_dir = wp_upload_dir();
$target_path = $upload_dir['path'] . DIRECTORY_SEPARATOR . basename($post_thumbnail);
if (copy($post_thumbnail, $target_path)) {
$post_thumbnail = $target_path;
}
}
return $post_thumbnail;
}
add_filter( 'really_simple_csv_importer_save_thumbnail', 'really_simple_csv_importer_save_thumbnail_filter', 10, 3 );
How to customize the post data after importing to database
really_simple_csv_importer_post_saved
This action provides availability to run some tasks after importing.
Example: Download image from remote url to custom field (Download from gist)
How to customize the importing process entirely
really_simple_csv_importer_class
This filter provides availability to completely replace the RS_CSV_Importer#save_post method.
Example: Update row based on a custom field ID/key match (Download from gist)
Installation
- Upload All files to the
/wp-content/plugins/directory. - Activate the plugin through the ‘Plugins’ menu in WordPress.
- Go to the Import page under Tools menu.
- Click CSV link, read the notification, then just upload and import.
Changelog
wp_post_helper class is deprecated.
1.3.1
- Plugin maintenance handed over from @hissy to @websoudan
- Security fix: prevent arbitrary file upload via post_thumbnail/media_file (validate real file content against allowed mime types, restrict thumbnails to images, download remote files through WordPress core sideload)
- Bug fix: fatal error on PHP 8 when addMediaFile() is called without attachment data
1.3
- Some Enhancements (Thanks @piwi!)
- Attachment support
- Add “really_simple_csv_importer_save_thumbnail” Filter
- French translations
- Support post date GMT
- Support post password
1.2
- Enhancement: Smart Custom Fields support
- Check if the provided post status is already registered
1.1
- Enhancement: Support localization
- Bug fixes
1.0
- Enhancement: Replace a helper class to more better one
- Enhancement: Add action hook
- Bug fixes
0.6.3
- Enhancement: Remove Byte Order Mark automatically (Thanks lucianosantana!)
For developers
Is this your plugin? Show off the numbers.
Add a live badge to your site, docs or GitHub README. It updates on its own — no account needed.
Best Really Simple CSV Importer alternatives
All acf plugins →FAQ
Really Simple CSV Importer: quick answers
Straight answers, pulled from live WordPress.org data.
Live data from WordPress.org · checked Nov 17, 2026
Is Really Simple CSV Importer free?
Yes. Really Simple CSV Importer is free to download and use from the official WordPress.org plugin directory.
Is Really Simple CSV Importer safe to use in 2026?
Yes — Really Simple CSV Importer is a safe, well-maintained plugin to use in 2026. It runs on 40K+ sites, is rated 4.9/5 and was last updated 4 months ago, and scores 80/100 on our health check.
How many websites use Really Simple CSV Importer?
Really Simple CSV Importer is active on 40K+ WordPress websites and has been downloaded 337,186 times since it launched in September 2013. It was downloaded 7,320 times in the last 30 days.
Does Really Simple CSV Importer work with WordPress 7.1?
Really Simple CSV Importer is officially tested up to WordPress 7.0.8, while the latest release is 7.1.4. It may still work, but try it on a staging site first.
When was Really Simple CSV Importer last updated?
The latest version, 1.3.1, was released on July 16, 2026 (4 months ago).
Who makes Really Simple CSV Importer?
Really Simple CSV Importer is developed and maintained by Webの相談所.
What are the best alternatives to Really Simple CSV Importer?
The most popular alternatives to Really Simple CSV Importer are Advanced Custom Fields (ACF… (2M+ installs), ACF Content Analysis for Yo… (100K+ installs) and Advanced Custom Fields: Ext… (100K+ installs).
Powered by PageForge
Want thousands of pages that rank like these? Build them in an afternoon.
This directory runs on the same engine as PageForge. Turn any spreadsheet, CSV or API into thousands of fast, SEO-ready WordPress pages — with schema, internal links and AI-written copy baked in.
- CSV, Google Sheets & API data sources
- AI content, schema & internal links per page
- Works with Elementor, Gutenberg, Yoast & Rank Math
- Free on WordPress.org — no credit card