Skip to content
Page export from one Wagtail instance into another
Branch: master
Clone or download
Latest commit 4a4b0b0 Feb 4, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
wagtailimportexport Remove the "Edit This Page" button link after choosing the root page Feb 4, 2019
.gitignore Initial commit May 1, 2018
CHANGELOG.txt v0.2 release Feb 4, 2019
LICENSE v0.2 release Feb 4, 2019
MANIFEST.in Add MANIFEST.in May 2, 2018
README.md v0.2 release Feb 4, 2019
setup.py v0.2 release Feb 4, 2019

README.md

wagtail-import-export

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.

Installation

pip install wagtail-import-export

Now add to your project's INSTALLED_APPS:

INSTALLED_APPS = [
    # ...
    'wagtailimportexport',
    # ...
]

Add the following to your project's urls.py (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.

Configuration

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:

WAGTAILIMPORTEXPORT_EXPORT_UNPUBLISHED = True

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

Limitations

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).

You can’t perform that action at this time.