Decorate tool
The Decorate tool is where you dress the map. Compass roses, titles, borders, illustrations, your own uploads — anything you want to sit on top of the map itself.
Its panel has three sections: Sheet (the title and compass, the legend, the border, the scale bar and the grid), Add (text and the library) and On the sheet (everything you’ve placed). On a world or region map a fourth, Places, moves, renames and adds its towns and roads (on a town map, it moves and renames them) — see Edit generated features.
Title & compass
Section titled “Title & compass”New world and region maps come finished in the style’s own hand: a title, a compass rose, a frame and a scale bar drawn into the map itself, so they appear in every save and export just as you see them. Each style has its own. Parchment, Light fantasy, Dark fantasy and Mistlands letter the title between engraved rules. The Sea chart puts it on a scroll, Watercolour on washes of colour and Pastel on a ribbon. Atlas puts the title, legend and scale bar together in one printed box beside the border, and Flat colour uses a card.
Under Sheet → Title & compass:
- Title — the map’s name. Type a new one to change it.
- Subtitle — a line under the title, such as The jewel of hope.
- Show the title and Title size.
- Compass — On the sea lays it on the water behind the land and its names. On top puts it over everything, and Hidden takes it off. Compass size sits below.
- At sea — ships and sea creatures in open water: as the style draws them, ships and creatures, ships only, creatures only, or none. They keep clear of the title, compass and sea names.
- Clouds — painted clouds, each casting its shadow on the map. Turn on any of Along the edges (gathered against the border, clear of the title, compass, legend and scale bar), Under the title and Drifting over the sea. Place names keep clear of them.
While Decorate is open, drag the title, compass, legend or scale bar on the map to move it. Names move out of its way when the map redraws. On Atlas, the box settles into the nearest corner against the border. Put them back in the quietest corners lets the Foundry place them again.
Turn off Drawn in the map’s style to go back to a title and compass you select and restyle like any other decoration (below).
Auto title & compass (town and village maps)
Section titled “Auto title & compass (town and village maps)”Town and village maps, and maps with Drawn in the map’s style off, come finished this way. Each time you generate, the map’s own name is lettered into a quiet corner as its title, and a compass rose goes into another. The Foundry picks spots over open sea or plain ground, away from towns, and clear of the scale bar. Place names on the map keep out of those corners, so nothing runs under the title.
The name depends on the kind of map. An archipelago becomes The … Isles, a coast The … Coast, a river valley The Vale of …. A regional map takes the name of the realm that covers most of it, and a mountain map takes the name of its main range. The compass matches the map style.
Both are ordinary decorations: select either one to move, resize or retype it. Once you change one, it’s yours. Generating again leaves it where you put it, and only the one you haven’t touched is re-placed. Delete the automatic title and add your own text, and your text is kept instead.
Turn Auto title & compass off under Sheet to remove the automatic pieces. Anything you’ve edited or added yourself stays. Maps saved before this feature existed start with it off.
Legend
Section titled “Legend”Turn on Legend to add a key in a quiet corner of the map. It lists only what your map uses: town sizes, ports, fortresses and other special towns, each road type, and kingdom, duchy and county borders. Each entry is drawn in the map’s own marks and line styles. The legend stays out of the title, compass and scale bar corners, and place names keep clear of it. It’s off unless you turn it on.
Working on the canvas
Section titled “Working on the canvas”While Decorate is open, every decoration on the map can be picked up: click one to select it, then drag, scale and rotate it right on the map. Close the tool and the map reads as a finished sheet again, with everything you placed still showing.
Undo and Redo in the toolbar step back and forward through your decorations (Cmd/Ctrl + Z and Cmd/Ctrl + Shift + Z also work).
Add text, at the top of Add, drops a fresh text decoration onto the map. Use it for titles, subtitles, region callouts.
Library
Section titled “Library”Under Add, below Add text. Four built-in categories:
- Compass roses — ornate north arrows in various styles.
- Title backdrops — paper / scroll / cartouche shapes meant to sit behind a title.
- Illustrations — your own artwork. Ships and sea creatures are drawn on world maps by the map itself (see At sea above).
- Settlements & landmarks — icons for cities, towers, ruins, etc.
Each category opens an accordion with a 3-column grid of thumbnails.
Search
Section titled “Search”The search box at the top of the Library filters across every category. Type “compass” to see only compass roses; type “tower” to surface landmark icons. The accordion auto-opens around matches.
Place an asset
Section titled “Place an asset”Two ways:
-
Drag an asset thumbnail onto the canvas — it lands where you drop it.
-
Click an asset thumbnail to place it at the centre of the map. Drag from there if you need to move it.
A newly placed decoration becomes the current selection, so its settings open on the right straight away.
Upload your own
Section titled “Upload your own”Every category has an Upload custom button. Two paths:
- SVG files are inlined into the chrome settings. Tint and shadow controls work normally.
- Raster files (PNG, JPG, WebP) are uploaded to your own storage on Postroll. Tint is disabled (you can’t recolour a raster losslessly); shadow still works.
Uploaded assets are scoped to your account.
On the sheet
Section titled “On the sheet”A list of every placed decoration, top of the stack first. Each row shows:
- A thumbnail.
- The asset’s name (you can rename in the Inspector).
- An opacity slider.
- Lock and Hide buttons.
- A Delete button.
Drag the rows to reorder front-to-back. Click a row to select that decoration. Select several with Cmd/Ctrl + click.
Find on the sheet filters the list by name, text or kind.
The decoration’s settings
Section titled “The decoration’s settings”When at least one decoration is selected, its settings open in the panel on the right of the screen:
- Position X / Y — pixel coordinates on the basemap.
- Scale / Rotation / Opacity — sliders.
- Tint — colour picker. Applied as
currentColoron SVG sources; disabled for raster sources. - Shadow — toggle plus colour / blur / offset X / offset Y / opacity controls.
- Flip H / Flip V — horizontal and vertical mirror.
Title decorations gain a few extras:
- Text — the title string.
- Font — the full font picker (the same faces the scene label editor uses), not a fixed handful. Older maps keep their original face until you choose a new one.
- Weight and Tracking — how heavy the letters are and how far apart they sit.
- Uppercase and Outline — force capitals, and add a halo behind the letters so a title stays legible over busy terrain.
- Curve — bend the baseline upward or downward.
Border
Section titled “Border”The line round the sheet, under Sheet.
- Border — Single line, Double line, or Hidden.
- Colour — a colour picker. Clear it to go back to the palette’s own.
- Width — up to 40 px. Left alone, it’s the palette’s own.
Scale bar
Section titled “Scale bar”Under Sheet.
- Scale bar — Segmented, Minimal, or Hidden.
- Position — Quietest corner (the default) lets the Foundry choose the calmest corner of the map, or pick a corner yourself.
- Total — the number the full bar represents (e.g. 1024 for cells, 200 for kilometres).
- Unit — a select with common presets (cells, hexes, km, mi, leagues, m, ft, yd) plus a custom option that opens a free-form field for anything else.
A town or village map’s bar is measured for you: it shows real metres or kilometres.
A hex or square grid over the map, for hexcrawls and travel. It sits under the place names so it never hides them, and it’s saved with the map and printed in its exports.
In a saved scene the grid is a layer of its own over the map, not part of the image. It stays sharp however far you zoom in, and anyone viewing the scene can hide it from Filters in the map’s controls.
- Shape — Hexes, Squares or None. Hexes are flat-topped in offset columns, the way hexcrawl maps are drawn.
- Cell — how big each cell is, in the scale bar’s unit: set the bar to 120 mi and the cell to 6 for 6-mile hexes. A hex is measured across its flat sides. The panel says about how many cells cross the map.
- Numbers — prints each cell’s number at its top, column then row (0101, 0102…), so you can say “the party is in 0708”.
- Ink — how strongly the grid is drawn.
- Download grid (HexJSON) — a file listing every cell by its number with its terrain, whether a river runs through it, and the towns and places in it, ready for a hexcrawl tool or your own notes. A cell counts as water only when nearly all of it is sea.
The grid isn’t offered on a town or village map.
Keyboard shortcuts
Section titled “Keyboard shortcuts”Active anywhere on the Foundry page:
Cmd / Ctrl + Z— undo.Cmd / Ctrl + Shift + Z— redo.Backspace / Delete— remove the selected decoration(s).Escape— deselect.Arrow keys— nudge one pixel;Shift + Arrownudges ten.Cmd / Ctrl + D— duplicate the selection.[ / ]— send back / bring forward by one z-step.Cmd / Ctrl + [ / ]— send to back / bring to front.
Related
Section titled “Related”- Edit generated features — the Decorate tool also hosts the editor for renaming, moving, adding, and deleting the map’s towns and kingdoms.
- Save as scene — what gets persisted and how decorations land in the resulting scene.