How to Upload a Battle Map to Roll20

Direct answer

What this page answers

Export a PNG battle map from RPGMapEditor.com, upload it to Roll20, place it on the map layer, set page dimensions, and align Roll20's grid manually.

Create a Roll20 PNG Map Roll20 Grid Alignment

Battle map preview for uploading a PNG map to Roll20 — Product preview: browser battle map workflow with terrain, grid, props, saves, and PNG export.

RPGMapEditor.com is independent and is not affiliated with or endorsed by Roll20.

Product output

What you can create

Use RPGMapEditor.com when the result needs to become an actual tabletop map: opened in the editor, edited around play, saved for later, exported as PNG, and reused when the campaign changes direction.

Page dimensions

Set the Roll20 page to the same number of squares as the exported map so resizing starts from a predictable frame.

Corner checks

Check grid alignment near all four corners instead of trusting the center of the map only.

No direct upload

RPGMapEditor.com exports the PNG. Upload and grid setup happen manually in Roll20.

Readable art

Keep walls, cover, doors, paths, and hazards visually clear at normal Roll20 zoom levels.

Feature facts

Current VTT output: PNG image export.
Roll20 workflow: upload the PNG as map-layer art and align Roll20's grid.
Foundry workflow: use the PNG as a scene background and set grid size/origin.
VTT automation: walls, doors, lighting, fog, tokens, and automation are configured in the VTT.
Universal VTT status: planned or not shipped unless exposed in the editor.

Current limitations

PNG export is current; structured VTT package export is not shipped.
Roll20 use means manual PNG upload and grid alignment, not direct API upload.
Foundry use means PNG scene background setup, not exported walls, doors, lighting, or tokens.
Always verify grid alignment in the actual VTT before session day.

Build one map before comparing tools

Open the editor, make a focused encounter-scale map, save the source, then export once to see whether the workflow fits.

Open Editor Roll20 Grid Alignment

Workflow

How it works

This is the same practical sequence for core pages, comparison pages, VTT workflows, and template-style pages. The details change by map type, but the activation path stays measurable.

Choose map size

Pick columns, rows, and grid scale from the encounter footprint before decorating.

Paint terrain

Block walkable ground, walls, roads, rooms, water, caves, or outdoor edges first.

Add props and stamps

Place cover, furniture, trees, rocks, doors, hazards, and landmarks only where they help play.

Add grid and text

Keep movement readable and add labels only when they clarify the session.

Save map

Save the editable source map to return later. Free accounts can save up to 3 maps.

Export PNG

Export a PNG for Roll20, Foundry VTT, print, projection, or campaign notes.

Mid-page action

Move from research to a concrete map. A saved or exported map is the useful validation point.

Create a Roll20 PNG Map Export a PNG Map

Tradeoffs

Comparison and tradeoffs

Use this table to decide whether the current RPGMapEditor.com workflow matches the map job before investing more prep time.

Factor	RPGMapEditor.com	Tradeoff
Map art	Creates visual map art and exports PNG	The VTT runs tokens, sheets, fog, lighting, walls, and automation
Grid setup	Helps plan square count and visual grid readability	Roll20 or Foundry handles final grid alignment after image upload
Advanced export	Universal VTT, walls, doors, and lighting are not shipped today	Some tools may offer richer packages; verify official support before switching

Fit

Best for / Not best for

The goal is trust, not overclaiming. Use RPGMapEditor.com when the current browser and PNG workflow matches the job; choose another workflow when it does not.

Best for

Game masters who need a clean PNG scene background for a virtual tabletop.
Maps where grid math, square count, and import alignment matter more than automation.
Teams comfortable configuring platform-specific tokens, walls, lights, and fog in the VTT.

Not best for

One-click Roll20 upload or native Foundry scene JSON export.
Dynamic lighting, walls, doors, tokens, or actor data generated by the map editor.
Replacing the VTT itself; RPGMapEditor.com creates the map image.

Export

Export and use workflow

Upload PNG to Roll20 The shortest reliable path is save source, export PNG, upload to Roll20, place on map layer, and align grid.

Save the RPGMapEditor.com source map, then export the finished battle map as PNG.
Upload the PNG in Roll20, place it on the map layer, and set page dimensions to the map square count.
Resize and align the image, then add tokens, fog, dynamic lighting, and other Roll20-only setup in Roll20.

Export proof beats feature guessing

Export one PNG, import it into your actual table workflow, and check grid readability before a session depends on it.

Export a PNG Map Pricing

Internal links