Description
The WordPress Importer will import the following content from a WordPress export file:
- Posts, pages and other custom post types
- Comments
- Custom fields and post meta
- Categories, tags and terms from custom taxonomies
- Authors
For further information and instructions please see the Codex page on Importing Content
Filters
The importer has a couple of filters to allow you to completely enable/block certain features:
import_allow_create_users: return false if you only want to allow mapping to existing usersimport_allow_fetch_attachments: return false if you do not wish to allow importing and downloading of attachmentsimport_attachment_size_limit: return an integer value for the maximum file size in bytes to save (default is 0, which is unlimited)
There are also a few actions available to hook into:
import_start: occurs after the export file has been uploaded and author import settings have been chosenimport_end: called after the last output from the importer
Installation
The quickest method for installing the importer is:
- Visit Tools -> Import in the WordPress dashboard
- Click on the WordPress link in the list of importers
- Click “Install Now”
- Finally click “Activate Plugin & Run Importer”
If you would prefer to do things manually then follow these instructions:
- Upload the
wordpress-importerfolder to the/wp-content/plugins/directory - Activate the plugin through the ‘Plugins’ menu in WordPress
- Go to the Tools -> Import screen, click on WordPress
FAQ
- Installation Instructions
-
The quickest method for installing the importer is:
- Visit Tools -> Import in the WordPress dashboard
- Click on the WordPress link in the list of importers
- Click “Install Now”
- Finally click “Activate Plugin & Run Importer”
If you would prefer to do things manually then follow these instructions:
- Upload the
wordpress-importerfolder to the/wp-content/plugins/directory - Activate the plugin through the ‘Plugins’ menu in WordPress
- Go to the Tools -> Import screen, click on WordPress
- Help! I’m getting out of memory errors or a blank screen.
-
If your exported file is very large, the import script may run into your host’s configured memory limit for PHP.
A message like “Fatal error: Allowed memory size of 8388608 bytes exhausted” indicates that the script can’t successfully import your XML file under the current PHP memory limit. If you have access to the php.ini file, you can manually increase the limit; if you do not (your WordPress installation is hosted on a shared server, for instance), you might have to break your exported XML file into several smaller pieces and run the import script one at a time.
For those with shared hosting, the best alternative may be to consult hosting support to determine the safest approach for running the import. A host may be willing to temporarily lift the memory limit and/or run the process directly from their end.
Reviews
Doesn’t work
Only imports posts. I tried to import images/media in every way: split the original import file in many files, fall back to default theme, disabled all plugins… nothing. It doesn’t work.
excellent Plugin
excellent Plugin
Importing is slow
Importing is very slow, as am typing this its been 7+ hrs and its still importing. i have about 5K images
Doesn’t work
“The file does not exist, please try again”
Fantastic!
Really straightforward and worked really well for me.
All images copied over.
I had a few minor errors that had a negligible impact on the import, but these are apparently due to not having plugins installed on my original site on my new site.
Thank you for this plugin! Wonderful!
not reliable
the export file is under 1mb. The first time I ran the importer, only users transferred, and the screen was forwarded to 404. Waited a day, made a new export file, then tried again. Nothing appeared to happen with this import, again forwarded to 404. The second time with new file, I got multiple notifications of repeat info. at least it didn’t show a 404 screen.
Contributors & Developers
“WordPress Importer” is open source software. The following people have contributed to this plugin.
Contributors
“WordPress Importer” has been translated into 47 locales. Thank you to the translators for their contributions.
Traducí “WordPress Importer” a tu idioma.
¿Interesado en el desarrollo?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
0.6.4
- Improve PHP7 compatibility.
- Fix bug that caused slashes to be stripped from imported comments.
- Fix for various deprecation notices including
wp_get_http()andscreen_icon(). - Fix for importing export files with multiline term meta data.
0.6.3
- Add support for import term metadata.
- Fix bug that caused slashes to be stripped from imported content.
- Fix bug that caused characters to be stripped inside of CDATA in some cases.
- Fix PHP notices.
0.6.2
- Add
wp_import_existing_postfilter, see Trac ticket #33721.
0.6
- Support for WXR 1.2 and multiple CDATA sections
- Post aren’t duplicates if their post_type’s are different
0.5.2
- Double check that the uploaded export file exists before processing it. This prevents incorrect error messages when
an export file is uploaded to a server with bad permissions and WordPress 3.3 or 3.3.1 is being used.
0.5
- Import comment meta (requires export from WordPress 3.2)
- Minor bugfixes and enhancements
0.4
- Map comment user_id where possible
- Import attachments from
wp:attachment_url - Upload attachments to correct directory
- Remap resized image URLs correctly
0.3
- Use an XML Parser if possible
- Proper import support for nav menus
- … and much more, see Trac ticket #15197
0.1
- Initial release
