If the Maps viewer shows a gray or blank area, the region for that area has not been downloaded yet. Download it from the Maps Manager and refresh the viewer.
How to download a region
Browse available regions
Regions are organized geographically. You can select countries, US states, and other geographic areas.
Select the regions you need
Click a region to select it. You can select multiple regions before starting the download.
Start the download
Click Download. Progress is shown inline — you can continue using other features on your server while the download runs.
Available regions
The Maps Manager provides downloadable coverage for a wide range of regions, including:- Countries — individual country maps across all continents
- US states — all fifty states available as separate downloads
- Other geographic areas — territories, provinces, and sub-national regions depending on availability
Monitoring download progress
While a download is in progress, the Maps Manager displays a progress indicator for each active download. Larger regions take longer — US state files are approximately 2–3 GB each. You do not need to stay on the Maps Manager page while downloads run. Downloads continue in the background.Managing downloaded regions
Viewing storage usage
Each downloaded region in the Maps Manager shows its file size so you can see how much storage it occupies. For total server storage usage, go to Settings → System.Deleting a region
To remove a downloaded region and free up storage:Find the region to remove
Locate the downloaded region in the list. The storage size is shown next to each entry.
Storage requirements
Map files are stored in the PMTiles format. Size varies by region and level of detail:- US state maps: approximately 2–3 GB each
- Smaller regions (smaller countries, territories) are typically less
- Large countries or high-detail regions can be significantly larger
Related
Offline Maps
Learn how to use the offline map viewer.
System Health
Check available storage before downloading large regions.
Easy Setup
Select map regions to download during first-time setup.