Overview of Battlemaps

In this guide we'll step through how to create a battlemap and use it for your RPG encounters.

Create a battlemap

After logging in or signing up, you'll be automatically directed to your Dashboard. From here you can create any kind of tool. Once you click to create a Battlemap and wait for the map to load, you'll see a (mostly) empty map.

Beta Note

The battlemap tool is currently in beta. Tools in beta are free to use for everyone, but may change drastically. While we really try not to compromise data, sometimes data loss (due to version changes and upgrades) is unavoidable. To stay up to date on development changes, follow our blog where we post changelogs and announcements.

Navigation Bar

When you open a battlemap you should see the left-side navigation bar. From here you can administrate the map itself or any of the entities you create. To the right of the site logo there's a small arrow icon. Clicking this will collapse the navigation bar showing you only a few icons and options.

Below the logo is a line of text that says "Beyond Tabletop Map." You can click on this text to edit the title of your battlemap. This title will show up on your dashboard and will help you distinguish your maps from one another.

Below the title are a series of icons. The circle adds a new token, the square adds a new shape, the gear opens up the map settings, the crosshairs moves your viewport to the center of the map, and the two magnifying glasses zoom in and out.

Map Settings

You can customize the background tile image for your map. Upload your image to a 3rd party site, such as imgur or cloudapp, and get the direct URL. Paste the direct URL into this field to have it replace the white and gray checkered pattern.

While an 80 pixel by 80 pixel image works best for setting a uniform grid, you can also use a large detailed map image instead. Just keep in mind the tiles will still lock into a 40 pixel by 40 pixel grid, so you may need to test the size of your background image a few times to get it right. You can also use shapes to serve as a background, for more information about this see the Shapes section below.

Here in the settings area, can also toggle whether you'd like to enable hotkeys while using this map.

Map Scenes

Lastly in the settings, map owners can create and switch scenes. Each scene has individual tokens and shapes, allowing you as a Game Master to customize and set up several encounters before a game session, and hide them from your players until you're ready.

Active Item

When you click on an entity (a shape or a token), the navigation bar will show you information about that entity below the icons described above. You can also delete or copy the active item. Active entities will be displayed with a blue glow around them so you can tell which entity you last selected.

Initiative Tracker

Every token that gets created is placed in a list below the Active Item information. In this list you can set each token's intiative for determining battle order. Once there are two tokens, new Prev and Next buttons will appear for setting the current turn. As you cycle through the tokens, the round number will increment so you can keep track of how many times everyone has acted.

Share button

Lastly in the navigation bar, there is a share button for inviting your friends to come play with you!

Context Menu

Right click on any token or shape on your map to bring up a context menu with many of the same options that are available in left navigation bar


A token represents a creature, either a player character, or an enemy. Every token that gets created is put into the initiative tracker, so for the most part you won't want to create tokens for NPCs or anyone not participating in a battle.

After you create a token, click on it to select it as the active item. In the navigation bar you should see the token's details. New tokens have "A" as their default name. You can change this to a full name, but the token will just show the first letter of the name.

If you have an image for your character, you can put the URL into the Image URL field, and that image will replace the token's default look. Follow the same steps for uploading an image to a third party site that is listed above. If you don't have an image prepared, you can still customize the color of each token with the background color field below.

Below that is the size field. Medium is currently the smallest token size available, but small characters take up the same space as medium ones, so if you need to create a token for a small character, just use Medium for its size.

Next is damage taken. This is the easiest way for DMs to keep track of how much damage enemies take. You can use this to keep track of player character damage as well, however most people find it's easier to keep track of that data on their actual character sheets instead.

The status field can be used to mark combatants that have a status or condition, so you remember when it comes to their turn if they should behave differently.

Clicking on the "Token Owner" text will reveal a dropdown select menu listing everyone the sheet has been shared with. You can use this to identify token owners. In the future, this may be used to alert players when it is their turn.

If you are the creator of the battlemap, then you will also see a checkbox that says "Hide for Players." This checkbox will make the token invisible to everyone except you. This is helpful if you want to set up traps or suprises in your battle, so you can keep track of tokens without anyone else seeing them.


A shape is much more abstract than a token. A shape can be used as a large background area, or it can represent a wall, or other structure on the battlefield. You can even use shapes as NPCs.

Shapes share many settings with tokens, including name, Image URL, background color, and Hide for Players. Shapes have an additional option when setting a background. Checking the "Tile BG?" checkbox will set the background at it's natural size and tile it throughout the shape. Without this checked the background will shrink to fit inside the shape.

Shapes share many settings with tokens, including name, Image URL, background color, and Hide for Players. Shapes have an additional option when setting a background. Checking the "Tile BG?" checkbox will set the background at it's natural size and tile it throughout the shape. Without this checked the background will shrink to fit inside the shape.

The "Round" checkbox will round the corners of your shape creating a circle or oval. The "Pinned" checkbox will prevent the shape from being moved, and is useful when using a shape as large background, or for set pieces that will not move during battle.

Finally you will see a series of four arrows. These arrows change the layering of shapes. From left to right the icons send a shape to the bottom of the stack, move a shape down one layer, move a shape up one layer, and send a shape to the top of the stack.


There are also a number of shortcuts you can use to speed up your usage of the Battlemap.

  • Holding the shift key while selecting entities of the same type, will select multiple entities at the same time.
  • While shapes or tokens are selected, you can press the delete key to delete the selected entity or entities.
  • Pressing the d key will duplicate any single item you have selected.
  • Pressing the c key will move your map to the center
  • Pressing shift + c will move a single selected entity to your current viewable area of the map (aka viewport).
  • Press the z key to undo your last action.
  • Press the shift + z keys to redo your last undo.
  • Press the t key to add a new token.
  • Press the s key to add a new shape.
  • Press the = key to zoom in.
  • Press the - key to zoom out.
  • As the owner of a map you can press the i key to when an entity is selected to toggle its visibility for other players.
  • With a single shape selected, press the p key to pin or unpin the shape.
  • Using the arrow keys, you can move a single selected entity up, down, left, or right one square. If you hold shift, the entity will move 5 squares.
  • Press the r key to rotate a single selected entity clockwise 90 degrees.

The End!

Thanks for reading, happy gaming! If you have any more questions, don't hesistate to visit our subreddit and ask us. Beyond Tabletop's dev (me) answers every question as best he can.