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.

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

GeoHazardWatch