Skip to content

1. Loading & Editing Maps

The first step in creating your custom map is selecting and loading the base map data. PaintMyMap offers multiple ways to get started, whether you want to use our built-in maps or upload your own data.

Quick demo: Load a map, change projection and set color theme.

Built-in Maps

Use the menus in the top toolbar to choose from our collection of predefined maps. Open the File menu and pick “Choose a map…”. The lists are organized by region and detail level.

Toolbar menu to choose a built‑in map

World Maps

Explore world and continent maps, with different levels of detail. Note: detailed maps download more data and may load slower.

Choose a map from the menu

See the complete list in Maps.

Historical Maps

Paint and customize maps across different time periods (from deep prehistory to present day). Note: some datasets may be approximate; for authoritative data, see “Load your own data” below.

Historical map datasets

Fun Maps

Creative, fictional datasets (like the Smiley Face map) show you can load any data and paint it. It doesn’t have to be geographically accurate—perfect for demos and playful projects.

Fictional smiley face map

Load Your Own Data

For complete customization, upload your own geographic data files:

Supported Formats

  • GeoJSON (.json, .geojson) — most common and recommended
  • TopoJSON (.topojson) — compressed GeoJSON format
  • Shapefile (zipped) (.zip) — include .shp, .dbf, .prj, .shx inside the ZIP
  • KML/KMZ (.kml, .kmz) — Google Earth formats
  • CSV (.csv) — coordinates or region identifiers

How to Load a File

  1. Open the File menu and click Load map from file…
  2. Select a supported file from your computer
  3. PaintMyMap detects the format and loads your data
  4. Your custom map appears on the canvas

To show country/region labels, each feature should include a properties.name (or name_en). For an explicit label anchor include label_node_lat and label_node_lng.

Example (truncated geometry):

json
{
	"type": "FeatureCollection",
	"features": [
		{
			"type": "Feature",
			"geometry": { "type": "MultiPolygon", "coordinates": [[[ ...]]]},
			"properties": {
				"name": "Sri Lanka",
				"name_en": "Sri Lanka",
				"label_node_lat": 7.5554942,
				"label_node_lng": 80.7137847
			}
		}
	]
}

Best practices:

  • Use WGS84 (EPSG:4326) coordinates.
  • Prefer MultiPolygon / Polygon geometries. GeometryCollection is supported but each sub‑geometry is processed separately which can:
    • Fragment borders (hairline gaps or overlaps)
    • Produce duplicate / overlapping labels
    • Increase transform + export cost Merge related pieces into a single (Multi)Polygon beforehand when possible.
  • Merge fragmented geometry into a single MultiPolygon for cleaner labeling and simpler selection.

Map Editor Mode (Optional Structural Edits)

Most users won’t need to alter the base geometry. When you do, Map Editor Mode will let you manipulate features directly.

Move, rotate, resize and delete regions in Map Editor Mode

How to Edit a Map

  1. Open File → Map Editor Mode
  2. Click a country / region feature to select it (selection outline + handles appear).
  3. Move: drag the selected feature.
  4. Rotate: press R while selected or use the rotate handle / UI control.
  5. Resize: drag a corner handle (hold Shift to preserve aspect ratio where applicable).
  6. Delete: press Backspace / Delete or use the Delete button in the UI.
  7. Multi‑select: Shift+Click additional features (or drag a marquee while holding Shift) then delete as a group.

Notes & Performance

  • Transformations occur after projection; they do not “true size” normalize area (Mercator size exaggerations remain). If you drag Greenland over Africa in Mercator it will still look vastly larger (though it's ~14–16× smaller in reality).
  • Need accurate true‑size comparative layouts? Use a specialized true size country tool like: https://guesswhereyouare.com/guide/maps/true-country-size.html — it lets you move countries with preserved area and export GeoJSON; then import that GeoJSON here.
  • Exported state (Project JSON) includes these transforms so reloading reproduces your layout.
  • Excessive transforms on very high‑detail datasets (e.g. world‑detailed + many rotations) can increase export size and slow undo/redo; consider simplifying before heavy edits.

Map Projections

After loading your map, choose from popular cartographic projections:

Projection selector
  • Mercator — traditional rectangular projection (good for navigation)
  • Robinson — compromise projection balancing size and shape
  • Winkel Tripel — used by National Geographic (balanced distortion)
  • Natural Earth — minimal distortion for thematic maps

Projection examples:

Projection example 1Projection example 2Projection example 3

Changing Projections

  1. Open the Projection control in the toolbar
  2. Select your preferred projection
  3. The map updates to the new projection
  4. All your painting and customization remain intact

Color Themes

Explore color themes to jump‑start your design:

Theme selector

Applying Themes

  1. Use the Theme dropdown near the legend
  2. Select a theme to apply it instantly
  3. Themes set the background and provide starting colors for your legend

Available Themes (examples)

  • Classic — balanced and clean Classic theme example
  • Color‑blind safe — accessible palette Color‑blind safe theme example
  • Forest — earthy greens Forest theme example
  • Pastel — soft and friendly Pastel theme example
  • Retro — bold vintage tones Retro theme example ...and many more

Next Steps

Once your map is loaded, you're ready to start painting! Continue to the next section to learn about customizing and painting your map regions.