Skip to main content

Page export from one Wagtail instance into another

Project description


Page export from one Wagtail instance into another.

A published page and its published descendants can be exported via API or file from a source site and imported into a destination site under an existing page.

The destination site should have the same page models as the source site, with compatible migrations.


pip install wagtail-import-export

Now add to your project's INSTALLED_APPS:

    # ...
    # ...

Add the following to your project's (note that the include(wagtailimportexport_urls) line must appear above the include(wagtail_urls) line that defines Wagtail's default routes):

from wagtailimportexport import urls as wagtailimportexport_urls

urlpatterns = [
    # ...
    url(r'', include(wagtailimportexport_urls)),
    url(r'', include(wagtail_urls)),

(wagtailimportexport.urls contains the export API endpoint. The admin urls are in wagtailimportexport.admin_urls and are automatically registered.)

You should now see an 'Import / Export' item in the Wagtail admin menu.


When importing via the API, only published pages are exported by default. If a descendant page is unpublished it and all its descendants are pruned (even if some of those descendants are themselves published).

It is possible to export all pages under a source page by adding a setting on the source site:


This should not be used in a public source site because the API is unauthenticated and would thus expose unpublished content to anyone.


If the imported content includes any foreign keys to page models, these will be updated to reflect the new page IDs if the target page is also part of the import, or left unchanged otherwise. If the target page is neither part of the import nor does it already exist on the destination site, this is likely to fail with a database integrity error.

Page references within rich text or StreamField content will not be rewritten to reflect new page IDs.

Imports are processed in tree path order; first the base Page records are imported, followed by the data for specific page subclasses. If a model is imported which includes a foreign key to a specific subclass of Page, and the target page of that foreign key appears in the import but later in tree path order, this will fail with an integrity error (as the relevant record will not have been created at that point).

Non-page data, such as images, documents or snippets, is not included in the import; the user is responsible for ensuring that any objects referenced from imported pages are already present on the destination site (with matching IDs).

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wagtail-import-export-0.2.tar.gz (8.3 kB view hashes)

Uploaded source

Built Distribution

wagtail_import_export-0.2-py2.py3-none-any.whl (12.9 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page