Importing a Project

You can import an existing GeoPackage (.gpkg) file into Mapit GIS as a new project. This is useful for restoring backups, receiving projects from colleagues, or loading datasets prepared in desktop GIS software.

There are two ways to import a project on Android: from the Projects screen or by opening a .gpkg file directly from a file manager or email attachment.

Android

Method 1: Import from the Projects Screen

1. Open the Projects screen from the main menu.
2. Tap the + button (floating action button) in the bottom-right corner.
3. A bottom sheet appears with options including Create New Project and Import Project.
4. Tap Import Project.
5. Choose an import source:

Source	Description
Device	Opens the Android file picker to select a .gpkg file from local storage
Dropbox	Browse and download .gpkg files from your Dropbox /Apps/Mapit GIS/ folder (see Export to Dropbox)

6. The file is copied into the app's internal storage and registered as a new project.
7. The project list refreshes and the imported project appears.

note

The Dropbox option only appears if your Dropbox account is connected in Settings → Remote Connections → Dropbox.

Method 2: Open from a File Manager

Mapit GIS registers itself as a handler for .gpkg files. When you tap a GeoPackage file in a file manager, email attachment, or download notification:

1. Android offers Mapit GIS as an app to open the file (or opens it directly if set as default).
2. The file is automatically imported as a new project.
3. The map screen opens with the imported project available.

This works with files received via email, messaging apps, cloud storage apps, or any file manager.

What Happens During Import

• The .gpkg file is copied into the app's internal data directory - the original file is not modified or moved.
• The project name is derived from the filename (without the .gpkg extension).
• All layers, attributes, styles, and metadata inside the GeoPackage are preserved.

Validation

Check	Behaviour
File is not a .gpkg	Import is rejected with a "file not supported" message
Project with the same name already exists	Import is rejected with an "already exists" message
File is corrupted or not a valid SQLite database	Import fails with an error message

tip

If you need to import a project that has the same name as an existing one, rename the .gpkg file before importing - the project name is taken from the filename.

note

Importing a project requires the Import/Export entitlement, available on Pro and Pro+ tiers.

iOS

Importing a Project

1. Open the Projects screen from the main menu.
2. Tap the + button.
3. Tap Import Project.
4. The iOS file picker opens, allowing you to select a .gpkg file from local storage, iCloud Drive, or other configured file providers.
5. The file is copied into the app's internal storage and registered as a new project.

You can also import a GeoPackage by opening a .gpkg file from the iOS Files app, an email attachment, or AirDrop - Mapit GIS will handle the file automatically.

iOS limitation

Dropbox import is not yet available on iOS (on the roadmap). Use the iOS Files app to access files from cloud storage providers instead.

note

Importing a project requires the Import/Export entitlement, available on Pro and Pro+ tiers.