Page dimensions
Set the Roll20 page to the same number of squares as the exported map so resizing starts from a predictable frame.
Roll20 upload guide
How to Upload a Battle Map to Roll20
Create a PNG battle map in RPGMapEditor.com, upload it to Roll20, place it on the map layer, set page dimensions, and align the grid.
This is a manual PNG upload workflow, not a direct Roll20 integration. Add tokens, fog, dynamic lighting, and automation inside Roll20 after the map is placed.
Quick answer
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.
Account policy: new accounts need an active Studio subscription ($3/month) to use the editor. Accounts created before Aug 21, 2026 keep their free plan. Details on the pricing page.
RPGMapEditor.com is independent and is not affiliated with or endorsed by Roll20.
Create
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.
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.
Included in the editor
- 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.
Try it on a real map
Open the editor, make one focused encounter-scale map, save it, then export once to see whether the workflow fits your table.
Workflow
How it works
The same six steps whether you are building a dungeon, a wilderness ambush, or a tavern brawl. The details change by map type; the workflow does not.
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.
Start your map now
Pick a map size, block out the terrain, and you will have a playable layout in minutes. Save or export it when the tactical read looks right.
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
RPGMapEditor.com is built for playable encounter maps. If the job below is not yours, a different tool will serve you better.
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.
Test one export before game night
Export a PNG, import it into your usual table or VTT setup, and check grid readability before a session depends on it.
Related pages
Keep planning your map
FAQ
How to Upload a Battle Map to Roll20 FAQ
The questions DMs usually ask before starting a map like this.
How do I upload a battle map to Roll20?
Export a PNG from RPGMapEditor.com, create or open a Roll20 page, upload the image, place it on the map layer, set page dimensions, and align the grid.
Can RPGMapEditor.com send maps to Roll20 automatically?
No. There is no direct Roll20 upload workflow. Use PNG export and manual Roll20 setup.
What layer should the map use in Roll20?
Use the map/background layer for the exported PNG. Keep tokens, fog, and lighting separate inside Roll20.
Do I need to save the RPGMapEditor.com source map?
Yes if you want easy revisions. Save the source map before export so you can adjust props, terrain, labels, or grid choices later.
What export does RPGMapEditor.com support today?
The current VTT handoff is PNG export. Use the exported image as Roll20 map-layer art or a Foundry VTT scene background.
Does RPGMapEditor.com upload directly to Roll20?
No. Export a PNG from RPGMapEditor.com, then upload and align the image inside Roll20.
Does RPGMapEditor.com export Foundry walls or doors?
No. Add walls, doors, lights, regions, tokens, and automation manually inside Foundry after PNG import.
Can I use the map as a Foundry scene background?
Yes. Export PNG, create a Foundry scene, set the image as the background, then configure grid size and origin.
Can I use the map in Roll20?
Yes. Upload the PNG to the map layer, set the Roll20 page dimensions, and align the Roll20 grid to the image.
What grid size should I use?
Choose square count first, then export at a consistent pixels-per-square value so the VTT grid can match the image.
Does Universal VTT export work today?
No. Treat Universal VTT, walls, doors, and lighting export as planned unless the shipped editor exposes those options.
Is PNG enough for VTT play?
PNG is enough for the visual map background. Tokens, fog, lighting, walls, and automation remain in the VTT.
Can I print the exported map?
Yes. Export PNG and print at the size your table needs after checking grid scale and image readability.
What should I test before a session?
Import one exported PNG into your actual VTT, check grid alignment at multiple corners, and verify text and props remain readable.
Make the map
Open the editor, build the encounter you were planning, save it, and export a PNG when it is ready for your table.