How to Keep Token Sizes Consistent With Grid Squares in a Virtual Tabletop
A token fits its grid squares consistently when the map’s grid is aligned first and the token is sized in grid units, rather than judged by how large its artwork looks on screen. Set or confirm the map grid, test a one-square token, then configure larger tokens by the number of cells they occupy. This workflow helps prevent miniature-looking tokens, oversized portraits and movement that snaps incorrectly.
What “token size” means
Separate three things that are easy to confuse: the map image’s pixel dimensions, the virtual tabletop’s grid size, and the token’s footprint in grid cells. A map might contain squares 140 pixels wide, while the VTT displays those squares at a different zoom. Zoom changes how large everything looks on your screen; it does not change the intended number of squares a token occupies.
Foundry VTT makes this distinction explicit: token dimensions are measured in grid units, while artwork scale changes how the image appears relative to that footprint. A one-square token has width and height of 1; changing its artwork scale does not change its base grid dimensions. Foundry VTT: Tokens
Use the token’s footprint to answer “how many squares does it occupy?” Use artwork scale to answer “how much of that footprint does the picture fill?” A circular portrait with transparent margins may need artwork adjustment to look visually balanced, but that does not automatically mean its grid footprint is wrong.
Set the map grid before sizing tokens
If the map has a printed grid, align the VTT grid to it before placing tokens or adding other scene details. In Foundry, the grid governs where tokens are placed and how distance is measured; changing the grid later can affect alignment of other scene elements. Its scene guide recommends setting the grid before adding details. Foundry VTT: Scenes
When the map’s grid dimensions are known, use them instead of estimating by eye. For a pixel-based workflow, divide the image width by the number of columns and the height by the number of rows. For example, a 3,080-by-2,520-pixel map with 22 columns and 18 rows has 140 pixels per square in both directions. If the two results differ substantially, check that you counted the full grid and that the map has not been stretched. Foundry documents this calculation and provides a grid-alignment tool for maps with drawn grids. Foundry VTT: Scenes
Other VTTs may provide grid alignment controls rather than asking you to calculate pixel size. Owlbear Rodeo lets you enter known row and column counts, or align with visual rulers when those counts are unknown. Roll20’s described Align to Grid workflow uses an anchor point, a scale adjustment and a fine-tuning step. Owlbear Rodeo: Aligning a Map, Roll20: Explore the New Align to Grid Feature in Beta
Align across the map, not just in one corner
A grid can appear aligned near its starting point and still drift at the far edge. This usually means the map’s scale is slightly off: the error repeats from square to square. After rough alignment, inspect a distant corner or the opposite edge. If the grid lines increasingly diverge, refine the scale rather than shifting the map alone.
For maps with known dimensions, compare the entered row and column counts with the actual visible squares. For maps without known dimensions, use the VTT’s alignment tool and check both a near and far part of the map. Owlbear Rodeo’s guide specifically advises checking for accumulated drift after scaling and using precision controls to refine it. Its guide also notes that hex maps can have axis-specific drift, so a square-grid fix may not transfer directly. Owlbear Rodeo: Aligning a Map
Set token footprints in grid units
Once the map grid is correct, configure tokens according to their intended footprint. A creature or marker that occupies one square should use a 1-by-1 footprint; one intended to occupy two squares across and two down should use 2-by-2. Use the game’s rules for the creature’s footprint where relevant; the artwork’s shape alone does not determine it.
In Foundry, set the token’s Dimensions (Grid Units) for the footprint. Then use its Scale setting only if the artwork needs to appear larger or smaller within that footprint. A scale value above 1 enlarges the artwork relative to its base size, while a value below 1 reduces it. Foundry VTT: Tokens
For a platform that exposes only drag handles, use a temporary test token: resize it until its edges or center align with the intended number of cells, then verify after moving it. If the platform supports snap-to-grid, move the test token across several cells and check that it lands predictably. Avoid using a tiny token as proof that the map grid is correct; map alignment and token footprint are separate settings.
Use a short calibration check
Before the session, run this sequence on the actual scene:
- Confirm the grid type and size match the map, including square versus hex orientation.
- Place a token intended to occupy one cell and check its footprint at normal zoom.
- Move it several cells in different directions to check snapping and placement.
- Place a larger token and confirm that its footprint covers the intended number of cells.
- Inspect the map’s far edge for grid drift, then recheck the tokens after any alignment change.
The check separates common causes of mismatch. If every token looks too large or small relative to the map, inspect map alignment and grid settings. If one token is wrong while others fit, inspect that token’s grid dimensions or artwork scale. If placement behaves oddly only for a particular map, confirm the scene’s grid type and orientation.
Adjust the right setting when something looks wrong
A portrait that visually spills beyond a square does not always have an oversized footprint; transparent padding, a decorative border or scale settings can make the image appear different from its grid dimensions. Conversely, an image that looks close to one square may still have a larger configured footprint. Check the footprint setting and the visible artwork separately.
If the map grid must be changed after scene setup, recheck objects tied to the grid. Foundry warns that changing grid size can affect alignment of walls, lights, notes and tiles. For a map with a pre-drawn grid, its alignment tool can help match the overlay to the image. Foundry VTT: Scenes
Keep a repeatable setup for future scenes
Record the grid type, map columns and rows, and any nonstandard token footprints in the scene notes or your prep checklist. If you reuse a map, save its corrected alignment where your VTT supports reusable map settings; Owlbear Rodeo’s image editor, for example, applies saved alignment values to future uses of that map. Owlbear Rodeo: Aligning a Map
The dependable order is: align the map, verify the grid at distant points, set token footprints in cells, and tune artwork scale only for appearance. A one-token calibration check before play catches most sizing inconsistencies while leaving the map’s movement and measurement grid intact.