Tutorials & Docs

Learn Mapimator

Video walkthroughs and written documentation for every feature — from your first animation to advanced export settings.

Video Tutorials

How to Make an Animated Travel Map Video

Plan a Paris → Rome → Florence trip with a guided travel template and export an MP4 in under two minutes.

Make a Map Animation from a Text Prompt (AI Director)

Describe a Norway road trip in one sentence and let the AI Director build the camera moves, routes and pins.

How to Animate a GPS Track (GPX, KML, GeoJSON)

Import a Big Sur road trip GPX, pick a vehicle, and get a ready-made animation with a stop for every waypoint.

How to Highlight Countries on an Animated Map

Outline France and Italy one after another, with custom colours and a Trace animation.

Getting Started with Mapimator

Learn the basics of creating your first map animation.

Mapimator Tutorial

Follow along with another step-by-step walkthrough for creating map animations in Mapimator.

Written Documentation

Detailed reference for every panel, tool, and setting in the Studio.

Section 1

Interface Overview

The Studio is divided into four primary zones.

A — Global Header

  • Logo & plan badge — Shows your current plan.
  • Project bar — Open a project, start a new one, rename the current one, and save.
  • Place search (center) — Type a city (e.g. "Paris") and pick a result. Choose New slide to add a camera stop there, or Drop a pin to mark it. Ctrl/Cmd + Enter only flies the camera there.
  • Command palette — Ctrl/Cmd + K lists every action in the Studio.
  • Sparkles menu — Opens the AI Director bar, or the Templates gallery.
  • Export Video — Opens the export dialog. It needs at least 2 slides, and turns into Cancel while rendering.

B — 3D Stage (Main Map)

  • Left-click + drag — Pan across the map.
  • Right-click + drag / Ctrl + drag — Orbit and pitch the camera for 3D depth.
  • Right-click (long-press on touch) — Opens a menu to add a pin, text, route or new slide exactly where you clicked.
  • Scroll wheel — Zoom in and out.
  • Map style square (bottom-left) — Hover or tap to open View (projection, atmosphere, 3D Terrain), Labels and Map Type.
  • Projections — Toggle between Globe (spherical) and Mercator (flat).
  • Map Type — Satellite, Classic, Streets, Light, Dark. Each slide can use its own map type.

C — Quick-Add Toolbar

Across the top of the stage. Most tools add content at the current center of your view; the arrow beside a tool opens its variants.

ToolWhat it does
PinMark a location. Styles: Standard, Dot, Bubble, Marker, Text only, Emoji. Press P to click several pins onto the map. Importing pins from a CSV or GeoJSON file is a Pro option under the arrow.
RouteDraw a travel leg. Modes: Direct, Air, Car, Moto, Train, Sea, Bike, Walk, or File (GPX, KML, GeoJSON). The arrow beside it adds a hub & spoke network (Pro).
TextAdd a title or label on the map. The arrow beside it adds a caption fixed on screen.
ImageUpload an image or GIF and place it on coordinates. The arrow beside it adds a Map overlay (Pro): line up a scanned, historical or fantasy map on the globe.
ShapeLine, Arrow, Circle, Rectangle. Supports dashed styles.
RegionHighlight countries, states or country groups: search, click on the map, draw your own area, or upload GeoJSON.
3DPlace a 3D model such as a plane, ship, vehicle or landmark from the model library.

D — Storyboard (Bottom Panel)

Your animation is a sequence of Slides. Each slide is a camera stop. The Slides / Timeline switch at the left of the panel swaps this view for the Timeline, where you set exact timing.

  • Rename — Click the label at the top of any card to rename it.
  • Easing icon — Controls camera speed between slides (see Camera & Easing section).
  • Retake Slide — Found in the "…" menu as "Retake Slide (use current camera)". Syncs the slide to your current map position. The same menu also has Duplicate Slide and Add Camera Shot.
  • Transition timing pill — The "X.Xs" pill between cards. Click to type a custom duration.

Section 2

Creating Your First Animation

Build a complete map animation from scratch in a few minutes.

  1. 1

    Set your first slide

    Open the Studio. A new project opens on the whole globe with a start panel: video templates, an AI Director bar, Animate a GPX track, and Start with an empty map. Choose Start with an empty map, then search for your starting location — for example, type "Tokyo" and pick New slide. The map flies to Tokyo and the first slide is added.

  2. 2

    Lock in the view

    Adjust the zoom, pitch and bearing you want. Then in the storyboard open the "..." menu on the first card and click Retake Slide (use current camera). This saves your current map position as that slide.

  3. 3

    Add a pin

    Click the Pin tool in the Quick-Add Toolbar. A pin appears at the center of your view. In the panel on the right, pick a style on the Style tab (Bubble adds a text label, Standard is a classic teardrop, Dot is minimal). The Timing tab sets when it appears and disappears.

  4. 4

    Add a second slide

    Search for your next destination and choose New slide, or click Add slide (shortcut N) at the end of the storyboard, move the map, and use Retake Slide to lock it.

  5. 5

    Add a route between them

    Click the Route tool. A route is added at the map center. Drag the blue start handle to your first pin and the red end handle to your second pin. Pick Air for a curved arc, or Car to snap to real roads.

  6. 6

    Set transition duration

    Click the timing pill between the two storyboard cards. Type a duration in seconds — 3s for a quick cut, 8s for a cinematic fly-over. The same popover sets the easing.

  7. 7

    Preview and export

    Press Spacebar to preview the animation. When you're happy, click Export Video in the header, choose aspect ratio, file type (MP4 or GIF), resolution and frame rate, then export. The studio will pre-warm (download all map tiles), then render and download the file.

Full step-by-step guide with screenshots →

Section 3

Storyboard & Timeline Mastery

Understand how slides and timing work together.

How slides work

Each slide stores a complete camera state: position (latitude/longitude), zoom level, pitch (tilt), and bearing (rotation). The animation smoothly interpolates between consecutive slides over the duration you set.

Retake Slide

Navigate the map to exactly the position you want, then open the "…" menu on a slide card and click Retake Slide (use current camera). This overwrites that slide's stored camera state with whatever is currently on screen.

Transition timing

The pill between two cards controls how long the camera takes to travel between them. Click it and type any value in seconds. Short durations (1–2s) feel like jump cuts. Longer durations (5–10s) feel like cinematic fly-overs.

Keyboard shortcuts

  • Space — Toggle play/pause preview
  • Delete / Backspace — Remove selected slide or element
  • Ctrl/Cmd + D — Duplicate the selected slide or element
  • Right-click drag — Pitch the map for 3D depth

Section 4

Drawing & Editing Routes

Everything about travel legs, path modes, and handle editing.

Air

Draws a smooth arc between two points, simulating a plane route. Great for intercontinental or long-distance travel.

Car, Moto, Bike, Walk

Fetches real road or path geometry from a routing engine. The path follows actual streets and highways. Moving a handle re-fetches the route automatically.

Direct, Train, Sea, File

Direct is a straight line between two points. Train and Sea use the matching vehicle, and File follows a GPX, KML or GeoJSON track you upload.

Editing route handles

Every route has a blue start handle and a red end handle. Select the route, then drag either handle to reposition that end of the route. For road routes, the Studio will automatically re-fetch the road path from the new position. Handles snap to pins when dragged close to them.

Full guide: Drawing & editing routes →

Section 5

Camera Speed & Easing

Control how the camera accelerates and decelerates between slides. Click the timing pill between two cards to pick one.

Smooth

Cinematic

Slow start, fast middle, slow end. The most natural-feeling movement for most animations.

Linear

Mechanical

Constant speed throughout. Useful for data-driven or technical presentations where consistent pacing matters.

Late brake

High speed → slow

The camera moves fast and decelerates sharply as it arrives. Good for emphasizing the destination.

Elastic

Bouncy

A slight overshoot and spring-back at the end. Adds personality and energy to short transitions.

Pro tip: The "Slow Reveal"

Set a short duration between Slide 1 and Slide 2, but apply Late brake easing. The camera rushes across the map and coasts to a satisfying halt on the destination — great for opening shots.

Section 6

Map Styles

Choose a visual theme that fits your content. Open Map Type from the map style square, or set a different style on any slide and let it dissolve in.

Satellite

Real-world aerial imagery, with optional place names and borders. Best for geography, travel, and nature content.

Classic

A modern, colorful street map. Good for city guides and urban routes.

Light

A clean, minimal light theme. Ideal for data overlays and corporate presentations.

Dark

An ink-dark background with subtle labels. Cinematic and modern.

Streets

A detailed map that draws 3D buildings when you tilt in close. Flat on its own: turn on 3D Terrain under View for real elevation.

Performance tip

If the Studio feels slow while editing, switch to Light or Dark — both load much faster than Satellite. Switch back to Satellite before you export for the best-looking result.

Full guide: Map styles & when to use each →

Section 7

Regions & Countries

Highlight geographic areas and control when they appear.

Clicking regions on the map

  1. Zoom out to show the region you want (e.g. Western Europe).
  2. Open the arrow beside Region in the Quick-Add Toolbar and choose Click on the map. The button changes to Done picking.
  3. Hover over a country — it glows to show it's selectable.
  4. Click to add it as a Region element. Shift + click keeps picking. Press Esc or click Done picking to stop.
  5. Zoom in further to select individual US states or Canadian provinces instead of whole countries.

Using the Highlight regions search

Click the Region tool to open Highlight regions. Search for a country, group (such as NATO or ASEAN) or continent, tick as many as you like, and add them all at once. You can also draw your own area or upload GeoJSON from the same dialog.

Once added, select the region element and use the Style tab for color, opacity, fill reveals, border animations, glow and Lift. The Timing tab sets when it appears. Combine a 50% opacity region with an image element (your logo) for a professional corporate look.

Full guide: Highlighting countries & regions →

Section 8

Elements: Pins, Text, Images & Shapes

Add and customize the elements on top of your map. Each one has a Style tab and a Timing tab in the side panel.

Pins

  • Bubble — Text label inside a rounded bubble. Good for city names.
  • Standard Pin — Classic teardrop marker.
  • Dot — Minimal circle. Good for dense maps with many locations.
  • Marker — Larger, more prominent icon.
  • Text only, Emoji — A label with no pin, or an emoji as the pin.

Images

Upload an image or GIF from your computer. The image is placed at the center of your current view and anchored to that coordinate. Use this for logos, photos, or custom icons. Resize and reposition after placing. To place a scanned or historical map on the globe instead, use Map overlay under the Image arrow (Pro).

Shapes

  • Line — A simple straight line.
  • Arrow — A line with a directional arrowhead.
  • Circle — Highlight a circular area.
  • Rectangle — Box selection or callout.

All shapes support dashed line styles and custom colors.

Full guide: Adding pins, images & shapes →

Section 9

Bring in your own geographic data to animate.

GeoJSON import

GeoJSON is an open standard for encoding geographic data. You can upload a .geojson file into the Studio to animate custom paths, country boundaries, district outlines, or flight corridors. Points import from the arrow next to Pin in the toolbar; lines and polygons load into a Route or Region you add first. Importing requires a Pro plan.

  1. LineString → route: add a Route, then set Travel Mode to File in the right panel and pick your file.
  2. Polygon → region: open the Region tool and click Upload GeoJSON.
  3. The geometry is placed on the map as an editable element.

Only the first LineString in a FeatureCollection is imported — split multiple lines into separate files. The route importer also accepts .gpx and .kml.

Location search

Use the place search at the top of the Studio (press / to focus it) to find any city, landmark, or address worldwide. Choose New slide to fly there and add a slide, or Drop a pin to mark it. No manual coordinate entry required.

Section 10

Templates & Travel Story Wizard

Start from a ready-made template, or build a multi-stop itinerary automatically.

  1. 1
    Open the Wizard — On a new project, pick a video template from the start panel at the bottom of the map (See all shows the full gallery). Otherwise open the sparkles menu in the header and choose Templates. Ready-made starters open a Make it yours step that asks for your places first; guided templates such as Flight, Road trip, City spotlight, Store map, Country border and Hub & spoke ask their own questions.
  2. 2
    Add stops — Use the search box inside the guided template to add locations in order — e.g. London → Paris → Rome.
  3. 3
    Choose transport modes — Between each stop, toggle the leg mode: the Plane icon draws a curved arc, the Car icon fetches real road data.
  4. 4
    Create — Click Create my video. The Studio automatically creates all slides, pins, and routes for you.

Section 11

Export & Render Settings

Understand the two-phase export process and how to get the best quality.

Phase 1 — Prewarming (0–30%)

The camera silently jumps through every frame of your animation to force the map engine to download and cache all tiles, buildings, and labels. This eliminates gray boxes or blurry textures that would otherwise appear in the final video.

Phase 2 — Rendering (30–100%)

The Studio captures frames one by one and sends them to the encoder. When complete, your browser automatically downloads the file as map-animation-[timestamp].mp4 (or .gif).

Aspect ratios

In the export dialog, also choose MP4 or GIF, a resolution (480p, 720p, 1080p, 4K) and 30 or 60 FPS. Free exports are 480p at 30 FPS; 4K and 60 FPS need Pro. GIF is limited to 30 FPS and below 4K.

Reels / Stories

9:16 vertical (1080 × 1920 px at 1080p) — Instagram Reels, TikTok, and YouTube Shorts.

Landscape

16:9 (1920 × 1080 px at 1080p) — YouTube, presentations, and TV.

Square

1:1 (1080 × 1080 px at 1080p) — Instagram feed, LinkedIn, and multi-platform posting.

Section 12

Rendering Troubleshooting

Common issues and how to fix them.

"Gray or blurry tiles appear in the export"

This usually means the prewarming phase was interrupted or network was slow. Try exporting again — the prewarm re-runs each time. If the issue persists, switch to a lighter map style (Classic or Light) which requires fewer tiles.

"The export button is disabled"

Export needs at least 2 slides, and is unavailable while a preview is playing. While a render runs, the button turns into Cancel; click it to stop and start fresh.

"Car route doesn't follow roads correctly"

The routing engine works best on major roads. For remote or unpaved areas, try switching the route to Direct (straight line) or Air (arc) mode instead.

"The Studio feels slow or laggy"

Switch your map style to Light or Dark while editing — they render much faster. Switch back to Satellite only for the final export.

"Watermark appears on the exported video"

Free exports carry a small mapimator.com watermark in the corner. It is removed on Pro and Agency plans; see the Pricing page.

Section 13

Teams & Collaboration

Work with your video editor or teammates in one shared workspace on the Agency plan.

The Agency plan includes 5 seats under a single subscription. Every member signs in with their own account — never share login credentials — and works in the same workspace: all projects are visible and editable by the whole team. Exports (300/month) and AI Director credits (150/month) are pooled across the team.

1. Create your team

As an Agency subscriber, open your account page (avatar menu → Account) and click Create team in the Team section.

2. Invite a teammate

Enter their email and click Invite. A private invite link is copied to your clipboard — send it to them directly. Each link is single-use and expires after 14 days.

3. They join with their own login

Opening the link, your teammate signs in with their own Google account and clicks Join team. They land in the Studio with the full Agency feature set and access to every project in the workspace.

4. Manage members and seats

The Team section lists all members and pending invites against your 5-seat limit. The owner can revoke invites or remove members at any time; members can leave from the same place.

Good to know

  • Only a project's creator can delete it — teammates can open and edit everything, but not delete each other's work.
  • Avoid editing the same project at the same time; the most recent save wins.
  • Removing a member takes effect immediately — they keep their own account but lose access to the workspace's projects.
Full guide: Invite your team or video editor →