QGIS project recovery

A QGIS project may be recoverable from its XML project and backup even when layers or auxiliary data are unavailable.

QGIS stores project configuration as QGS XML or inside a compressed QGZ package. A QGZ can also contain a QGD SQLite database for auxiliary data, while spatial layers remain external unless embedded in another container.

Understand the symptom

Project structure, auxiliary data, and spatial datasets are separate dependencies.

WHY

What is happening

QGIS documents QGS as XML and QGZ as a ZIP archive containing the project and optional QGD auxiliary database. QGS saves can create a same-folder QGS~ backup. A project can open while external layers remain broken or while auxiliary labels and properties are missing.

What you may see

Symptoms that change the recovery path.

01

QGZ will not open

The archive or embedded project XML may be incomplete or damaged.

02

Handle unavailable layers prompt

Layer paths, database connections, or mounted drives no longer resolve.

03

QGS backup exists

The prior saved project may be available as a QGS~ file.

04

Labels or overrides disappeared

The QGD auxiliary database may be absent or mismatched.

Protect the source

Actions that can make the situation worse.

01

Saving broken paths changes the project

Keep the original path evidence.

02

Extracting and editing the only QGZ can damage it

Operate on a duplicate archive.

03

Copying shapefile parts separately loses data

Preserve complete multi-file datasets.

Do this now

Safe steps before evaluation.

01

Copy every project candidate

Keep QGZ, QGS, QGS~, QGD, timestamps, and original folders.

02

Collect all layers and connections

Preserve GeoPackages, shapefiles, rasters, databases, credentials references, and mount paths.

03

Record QGIS context

Note version, plugins, CRS, profiles, path mode, and last successful open.

04

Pause synchronization

Prevent archive or dataset reconciliation while candidates are compared.

NEPFOSYS process

How a data-first evaluation proceeds.

01

Project-container assessment

NEPFOSYS compares QGZ contents, QGS XML, backup, QGD, and path definitions.

02

Controlled path reconstruction

Layers are relinked on a duplicate using verified sources and connection context.

03

Map validation

Layers, symbology, layouts, labels, joins, forms, scripts, and priority datasets are reviewed.

A clear next step

Preserve the original device before another repair or recovery attempt.

Start a case with the exact symptoms, incident timeline, prior attempts, encryption details, and the files that matter most. NEPFOSYS will route the case to the appropriate DFW intake or nationwide mail-in path.

Start with a case review

Questions, answered

What customers ask before starting.

What is inside a QGZ file?

It is a ZIP archive containing the QGS project and potentially a QGD SQLite database for auxiliary data.

What is a QGS~ file?

QGIS can create it as the previous backup of a saved QGS project.

Does the QGIS project contain all spatial data?

Usually no. Most layers are referenced externally and must be preserved separately.

DFW local · Nationwide mail-in

Protect the device. Start with the facts.

Start my recovery case