{"id":312780,"date":"2026-06-26T09:53:50","date_gmt":"2026-06-26T09:53:50","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/simpleimporter\/"},"modified":"2026-06-26T10:33:39","modified_gmt":"2026-06-26T10:33:39","slug":"smacks-simple-importer","status":"publish","type":"plugin","link":"https:\/\/mlt.wordpress.org\/plugins\/smacks-simple-importer\/","author":23499250,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"0.1.3","stable_tag":"0.1.3","tested":"7.0","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"Smacks! Simple Importer","header_author":"Smacks","header_description":"Bulk import and export products, posts, pages, custom post types, and media into WordPress and WooCommerce from CSV, XLSX, XML, or JSON files. Drag-and-drop column mapping with live preview.","assets_banners_color":"f0e5d5","last_updated":"2026-06-26 10:33:39","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/simpleimporter.com","header_author_uri":"https:\/\/profiles.wordpress.org\/simpleimporter\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":74,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"0.1.0":{"tag":"0.1.0","author":"simpleimporter","date":"2026-06-26 09:53:46"},"0.1.1":{"tag":"0.1.1","author":"simpleimporter","date":"2026-06-26 10:16:06"},"0.1.2":{"tag":"0.1.2","author":"simpleimporter","date":"2026-06-26 10:28:45"},"0.1.3":{"tag":"0.1.3","author":"simpleimporter","date":"2026-06-26 10:33:39"}},"upgrade_notice":{"0.1.3":"<p>Documentation update only. No code changes.<\/p>","0.1.2":"<p>Documentation and listing update only. No code changes.<\/p>","0.1.1":"<p>Security hardening for REST permissions and a friendlier message when WooCommerce is inactive.<\/p>","0.1.0":"<p>Initial release.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3587065,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3587065,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3587065,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3587065,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.1.0","0.1.1","0.1.2","0.1.3"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Content type picker: import WooCommerce products, posts, pages, a custom post type, or media","2":"Drag-and-drop column mapping with a live preview of how each CSV or Excel row will import","3":"Import progress with row-by-row logs for every record"}},"plugin_section":[],"plugin_tags":[567,6590,87,6606,286],"plugin_category":[45,59],"plugin_contributors":[268985],"plugin_business_model":[],"class_list":["post-312780","plugin","type-plugin","status-publish","hentry","plugin_tags-csv","plugin_tags-excel","plugin_tags-import","plugin_tags-importer","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_category-utilities-and-tools","plugin_contributors-simpleimporter","plugin_committers-simpleimporter"],"banners":{"banner":"https:\/\/ps.w.org\/smacks-simple-importer\/assets\/banner-772x250.png?rev=3587065","banner_2x":"https:\/\/ps.w.org\/smacks-simple-importer\/assets\/banner-1544x500.png?rev=3587065","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/smacks-simple-importer\/assets\/icon-128x128.png?rev=3587065","icon_2x":"https:\/\/ps.w.org\/smacks-simple-importer\/assets\/icon-256x256.png?rev=3587065","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Smacks! Simple Importer is a bulk importer for WordPress and WooCommerce. Upload a CSV, Excel (XLSX), XML, or JSON file, drag your spreadsheet columns onto the target fields, and run the import. It handles WooCommerce products, posts, pages, custom post types, and media library items, with drag-and-drop column mapping and a live preview of how rows will land.<\/p>\n\n<h4>What you can import into WordPress and WooCommerce<\/h4>\n\n<ul>\n<li>Simple WooCommerce products (SKU, name, prices, stock, categories, tags, brands, images, status, custom attributes)<\/li>\n<li>WordPress posts (title, content, excerpt, author, date, categories, tags, featured image)<\/li>\n<li>WordPress pages (with parent\/child hierarchy, page templates, menu order)<\/li>\n<li>Any registered custom post type<\/li>\n<li>Media library items (images and files from URLs with titles, alt text, captions)<\/li>\n<li>Custom post meta via the <code>meta:<\/code> prefix syntax<\/li>\n<li>Custom taxonomies via the <code>tax:<\/code> prefix syntax<\/li>\n<li>Yoast SEO fields (when Yoast is active), including title, meta description, focus keyword, canonical URL, and Open Graph fields<\/li>\n<\/ul>\n\n<h4>Supported file formats: CSV, Excel, XML, JSON<\/h4>\n\n<ul>\n<li>CSV (comma, semicolon, or tab, auto-detected)<\/li>\n<li>XLSX (Microsoft Excel)<\/li>\n<li>XML (with auto-detection of the repeating element)<\/li>\n<li>JSON (top-level array, NDJSON, or wrapped in a single \"items\" key)<\/li>\n<\/ul>\n\n<h4>How to import a CSV or Excel file<\/h4>\n\n<ol>\n<li>Choose your content type (products, posts, pages, custom post type, or media).<\/li>\n<li>Upload your CSV \/ XLSX \/ XML \/ JSON file.<\/li>\n<li>Map columns onto target fields. Auto-mapping suggests matches based on common header names.<\/li>\n<li>Pick an update mode (insert, update existing, update only) and a match key (SKU, slug, title, ID).<\/li>\n<li>Watch the import run in the background. Cancel any time. Logs show what happened for every row.<\/li>\n<\/ol>\n\n<h4>Idempotent re-imports<\/h4>\n\n<p>Each content type has a sensible match key by default (SKU for products, slug for posts\/pages\/CPTs, URL for media). When a row matches an existing record, the importer updates it instead of creating a duplicate.<\/p>\n\n<h4>Background processing<\/h4>\n\n<p>Imports run through Action Scheduler (bundled with WooCommerce, or available as a standalone plugin). Large files are processed in batches so PHP timeouts don't break the import. You can close the tab and come back later.<\/p>\n\n<h4>Templates<\/h4>\n\n<p>The plugin includes downloadable starter templates for each content type, generated in CSV, XLSX, XML, and JSON formats so you can see the expected column shape.<\/p>\n\n<h4>Privacy<\/h4>\n\n<p>The plugin does not send any data to external services. All imports are processed locally on your WordPress installation. No tracking, no analytics, no callouts.<\/p>\n\n<h4>Simple Importer Pro<\/h4>\n\n<p>This free version handles everyday imports. Simple Importer Pro adds the heavier lifting for large catalogs and awkward source files:<\/p>\n\n<ul>\n<li>Advanced character-encoding and delimiter handling for international and exported files<\/li>\n<li>Priority support, ahead of the free queue<\/li>\n<li>Use it across your own and client sites, updates included<\/li>\n<\/ul>\n\n<p>See features and pricing at https:\/\/simpleimporter.com. The free version stays fully functional on its own; Pro is optional.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin files to <code>\/wp-content\/plugins\/smacks-simple-importer\/<\/code>, or install through the WordPress Plugins screen.<\/li>\n<li>Activate the plugin through the Plugins screen in WordPress.<\/li>\n<li>Go to <strong>Smacks! Importer<\/strong> in the admin menu.<\/li>\n<li>WooCommerce is optional. If you have it active, you can import products. If you don't, you can still import posts, pages, custom post types, and media.<\/li>\n<\/ol>\n\n<p>Action Scheduler is required for background processing. It ships with WooCommerce. If you don't have WooCommerce installed, you can install the standalone Action Scheduler plugin instead.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"how%20do%20i%20import%20products%20into%20woocommerce%20from%20a%20csv%3F\"><h3>How do I import products into WooCommerce from a CSV?<\/h3><\/dt>\n<dd><p>Choose Products as the content type, upload your CSV (or Excel, XML, or JSON) file, drag your columns onto the WooCommerce product fields, and run the import. SKU, name, price, stock, categories, tags, images, and custom attributes are all supported. WooCommerce must be active for product imports.<\/p><\/dd>\n<dt id=\"can%20i%20import%20from%20an%20excel%20%28xlsx%29%20spreadsheet%3F\"><h3>Can I import from an Excel (XLSX) spreadsheet?<\/h3><\/dt>\n<dd><p>Yes. Export or save your spreadsheet as .xlsx, or as a .csv, and upload it. The importer reads Excel workbooks directly, so there is no need to convert anything by hand first.<\/p><\/dd>\n<dt id=\"is%20this%20a%20free%20alternative%20to%20paid%20importers%3F\"><h3>Is this a free alternative to paid importers?<\/h3><\/dt>\n<dd><p>Yes. The free version imports products, posts, pages, custom post types, and media from CSV, Excel, XML, and JSON with no row limits set by the plugin. A paid Pro version adds advanced file handling and priority support, but the free version stands on its own.<\/p><\/dd>\n<dt id=\"does%20it%20require%20woocommerce%3F\"><h3>Does it require WooCommerce?<\/h3><\/dt>\n<dd><p>No. WooCommerce is only needed for product imports. Posts, pages, custom post types, and media work on any WordPress site.<\/p><\/dd>\n<dt id=\"how%20big%20a%20file%20can%20i%20import%3F\"><h3>How big a file can I import?<\/h3><\/dt>\n<dd><p>There's no hard limit set by the plugin. Practical limits depend on your hosting (PHP memory, max execution time, file upload size). Files are processed in batches, so large imports work even on shared hosting \u2014 they just take longer.<\/p><\/dd>\n<dt id=\"can%20i%20re-import%20the%20same%20file%20to%20update%20records%3F\"><h3>Can I re-import the same file to update records?<\/h3><\/dt>\n<dd><p>Yes. By default, rows match against existing records by SKU (products), slug (posts\/pages\/CPTs), or URL (media). Matching rows update in place rather than creating duplicates.<\/p><\/dd>\n<dt id=\"what%20about%20json%20files%3F\"><h3>What about JSON files?<\/h3><\/dt>\n<dd><p>The plugin reads JSON files in three shapes: a top-level array of objects, an object with one array property (e.g. <code>{\"products\": [...]}<\/code>), or NDJSON (one JSON object per line). The MIME-type sniffer in WordPress sometimes rejects JSON files; the plugin handles that automatically.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20custom%20fields%20and%20acf%3F\"><h3>Does it work with custom fields and ACF?<\/h3><\/dt>\n<dd><p>Custom fields work via the <code>meta:fieldname<\/code> mapping syntax. Direct ACF field-type awareness (with proper coercion for repeaters, galleries, etc.) is not in this version.<\/p><\/dd>\n<dt id=\"what%20if%20my%20import%20fails%20partway%20through%3F\"><h3>What if my import fails partway through?<\/h3><\/dt>\n<dd><p>You'll see exactly which row caused the error in the logs panel, and the import can be resumed from where it stopped. Successful rows are not re-processed.<\/p><\/dd>\n<dt id=\"where%20do%20i%20get%20support%3F\"><h3>Where do I get support?<\/h3><\/dt>\n<dd><p>Use the WordPress.org support forum for this plugin, or visit https:\/\/simpleimporter.com.<\/p><\/dd>\n<dt id=\"is%20there%20a%20pro%20version%3F\"><h3>Is there a Pro version?<\/h3><\/dt>\n<dd><p>Yes. Simple Importer Pro adds advanced character-encoding handling for awkward source files and priority support. The free version here is complete on its own. See https:\/\/simpleimporter.com.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>0.1.3<\/h4>\n\n<ul>\n<li>Readme and in-plugin copy cleanup. No functional changes.<\/li>\n<\/ul>\n\n<h4>0.1.2<\/h4>\n\n<ul>\n<li>Listing and readme updates: clearer title, description, and FAQ. No functional changes.<\/li>\n<\/ul>\n\n<h4>0.1.1<\/h4>\n\n<ul>\n<li>Per-content-type permission checks on all REST endpoints.<\/li>\n<li>Guards product imports when WooCommerce is inactive, with a clear message instead of an error.<\/li>\n<li>Added a Go Pro page and listing details for Simple Importer Pro.<\/li>\n<\/ul>\n\n<h4>0.1.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<li>Simple product, post, page, custom post type, and media imports.<\/li>\n<li>CSV, XLSX, XML, and JSON source files.<\/li>\n<li>Drag-and-drop column mapping with auto-detection.<\/li>\n<li>Background processing via Action Scheduler.<\/li>\n<li>Yoast SEO field support (when Yoast is active).<\/li>\n<\/ul>","raw_excerpt":"Bulk import CSV, Excel, XML and JSON into WooCommerce products, posts, pages and custom post types. Drag-and-drop mapping with live preview.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/mlt.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/312780","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/mlt.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/mlt.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/mlt.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=312780"}],"author":[{"embeddable":true,"href":"https:\/\/mlt.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/simpleimporter"}],"wp:attachment":[{"href":"https:\/\/mlt.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=312780"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/mlt.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=312780"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/mlt.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=312780"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/mlt.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=312780"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/mlt.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=312780"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/mlt.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=312780"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}