Description
The WordPress Importer will import the following content from a WordPress export file:
- Posts, pages and other custom post types
- Comments and comment meta
- Custom fields and post meta
- Categories, tags and terms from custom taxonomies and term meta
- Authors
For further information and instructions please see the documention 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
wp plugin install wordpress-importer --activateFrequently Asked Questions
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 pr... [truncated]
Changelog
0.9.3
- Rewrite attachment URLs to the new URL structure
0.9.2
- Rewrite site URLs in block attributes.
0.9.1
- Add support for rewriting site URLs in post content and excerpts.
0.9.0
- Introduce a new XML parser class
WXR_Parser_XML_Processorthat replaces the
deprecatedWXR_Parser_Regexclass.
0.8.4
- Fix a bug on deserialization of untrusted input.
- Update compatibility tested-up-to to WordPress 6.7.2.
0.8.3
- Update compatibility tested-up-to to WordPress 6.7.
- Update call to
post_existsto includepost_typein the query - PHP 8.4 compatibility fixes.
0.8.2
- Update compatibility tested-up-to to WordPress 6.4.2.
- Update doc URL references.
- Adjust workflow triggers.
0.8.1
- Update comp... [truncated]