Upload Data to Create Hosted Tilesets
Upload MBTiles or PMTiles files through the Mappinest console and prepare them for hosted tile delivery.
Supported formats
The console currently supports MBTiles and PMTiles uploads in both raster and vector form. GeoJSON and Shapefile are planned, but they are not available yet in the current upload flow.
Accepted file types and upload limits
This table shows what the current console upload accepts and what limits are for each format.
| File type | Tilesets | Datasets | Transfer limits |
|---|---|---|---|
MBTiles | ✓ | 1 GB (raster or vector tileset) | |
PMTiles | ✓ | 1 GB (raster or vector tileset) | |
GeoJSON | ✓ | 10 MB | |
Shapefile | ✓ | 10 MB |
Upload workflow
Use the dashboard console to add a new tileset, choose the input format, and let Mappinest validate and prepare the dataset for delivery endpoints.
Step 1 - Select a tileset format
Choose the input format before the upload starts. The console currently supports MBTiles, PMTiles uploads.
Step 2 - Upload file
Select the file from your machine and start the upload from the console UI.
Step 3 - Processing
After upload completes, the dataset is validated and processed before tile delivery is enabled.
Step 4 - Dataset ready
Once processing finishes, the dataset appears in the tileset list and is ready to use through delivery endpoints.
Dataset naming
Filenames are sanitized and versioned so keys remain unique. The stable dataset id is username.dataset (no extension), e.g. mappinest.counties.
Dataset lifecycle
After upload, each dataset follows the same predictable lifecycle before it is ready to serve through the Tiles API.
- The dataset is validated and indexed.
- Tiles become available through standard delivery endpoints.
- Usage can be tracked in the dashboard.
Last updated: March 13, 2026