Import Pages
The Import Pages feature (/admin/import) allows administrators to import content from external sources into the platform. It supports zip archives of existing pages, individual files, and multiple source formats.
| Format | Extensions | Notes |
|---|
| JSPWiki | .txt | Converts JSPWiki syntax to Markdown |
| HTML | .html, .htm | Extracts article content, converts to Markdown |
| Markdown | .md, .markdown | Pass-through; existing frontmatter is preserved as metadata — see jwilleke/ngdpbase#467 *(pending)* |
The format dropdown in the UI includes all registered converters. Select Auto-detect to let the system choose based on file extension and content.
When to Import
- Restoring pages after data loss
- Migrating content from another GeoHazardWatch instance
- Bulk-loading pages created outside the application
- Merging content from a backup archive
How to Import
- Go to Admin → Import Pages
- Click Choose File and select a
.zip archive
- Review the import options:
- Overwrite existing pages — if a page with the same slug already exists, replace it with the imported version
- Skip existing pages — leave existing pages unchanged and only add new ones
- Click Import to start the import
- The page shows a summary of pages added, updated, and skipped when complete
What Happens During Import
The import process:
- Extracts the archive to a temporary directory
- Reads each Markdown file and its frontmatter
- Writes the page to the data directory
- Rebuilds the page index to reflect the new content
Attachments included in the archive are also imported if present.
Caveats
- Very large archives (thousands of pages) may take several minutes to process
- UUIDs in the imported files are preserved — duplicate UUIDs will overwrite existing pages when the overwrite option is selected
- User accounts referenced as page authors are not created automatically
See also Export Data to create an archive suitable for importing.