Rolls the dice expression and sends the result.
d20 + 4
Repeats the grouped expression and sums the results.
2(d20+4)
Rolls a success check. The result is true or false.
d20 >= 10
Variables last for one submitted chat input or macro run.
x = 20 d20 + x
Changes the displayed speaker name for later lines in this submitted input.
name Jon This line is from Jon. name Goblin This line is from Goblin.
Sends text without trying to parse it as a roll. A leading backtick does the same thing.
say Roll d20 + str `Roll d20 + str
Runs only the lines under the matching branch.
x = 1 if x: d20 + 4 else: d20
Runs an indented block more than once, up to 20 times. loop and times also work.
repeat 3: d20 + 4
Open Help or jump directly to a tab.
/help /help macros /help sheets /help shortcuts
Picks one whitespace-separated option. Quotes keep words together.
choose goblin orc "gelatinous cube"
Randomizes the order of the options.
shuffle Alice Bob Carla
Rolls on a named table. Use mytable for a private table.
table rumors mytable secrets
Styles later lines in the same submitted input. Use /reset to clear styles.
/color red bold italic Danger! /reset This is plain.
Asks for a saved variable value and updates that variable before later lines run.
prompt power attack d20 + attack - power attack
Updates a saved variable without opening a prompt.
set power attack 3 d20 + attack - power attack
Uses a different spreadsheet for bare named cells and bracketed sheet expressions later in the same input.
sheet Garret d20 + attack d20 + [bab + str_mod]
Comments work in rolls, variables, control flow, choose, and shuffle. Raw text commands keep # as text.
bonus = 4 # favored terrain d20 + bonus
| create group | use the Macros section in the left panel |
| create macro | right click a macro group, then add a macro |
| run macro | click its button in the chat macro panel |
| edit macro | open it from the left panel to edit, test, or use it |
| macro body | runs as the same script you can type in chat, with saved variables added to scope |
| macro variable | attached to one saved macro; useful for per-button inputs |
| group variable | attached to a macro group; visible to that group |
| global variable | put it in global or globals |
| variable types | number, boolean, expression, ability score, choice |
| prompt variable | prompt power attack asks and updates that saved variable |
| set variable | set power attack 3 updates that saved variable directly |
| use group | use Yowa imports variables from another group |
| dotted name | Yowa.bab reads another group's variable |
| matching sheet | macro tab Yowa can read sheet Yowa |
| sheet command | sheet Garret changes sheet context for the rest of the input |
| named cell | d20 + attack uses named cell attack from that sheet |
| sheet formula | d20 + [str_mod + bab] evaluates a sheet expression |
| docs | Full macro docs |
| new sheet | click New Sheet... in the left panel |
| open sheet | click a sheet name in the left panel |
| edit cell | type text or a number directly into a cell |
| formula | start with =, like =str_mod + bab |
| cell refs | A1, a$, named columns, and named cells |
| name cell | right click a cell, then set or clear its name |
| rows/columns | right click headers to insert, delete, move, sort, or style |
| copy/paste | copy and paste tab-separated spreadsheet data |
| download | use the sheet menu to download TSV data |
| functions | use built-ins like sum, avg, round, and eval |
| docs | Full spreadsheet docs |
| Alt+. | Focus the next open window. |
|---|---|
| Alt+, | Focus the previous open window. |
| Alt+G | Move the front window. Arrows move 16 pixels. Hold Shift for 1 pixel. Enter places the window. Esc returns it to its starting position. |
| Alt+M | Minimize the front window. |
| Alt+X | Close the front window. |
| Alt+J | Focus the newest minimized window. Press again to focus the front open window. |
| ← / → | Move to the previous or next minimized window. |
| Enter or Space | Restore the focused minimized window. |
| X | Close the focused minimized window. |
| Ctrl+K | Open campaign search. |
|---|---|
| ↑ / ↓ | Select the previous or next result. |
| Enter | Open the selected result. |
| Shift+Enter | Open the result with the opposite of the current Keep open setting. |
| Alt+1–5 | Toggle Maps (1), Notes (2), Sheets (3), Macros (4), or Clocks (5). |
| Alt+Shift+1–5 | Search only that category. Repeat on the same category to enable all five. |
| Alt+C / Alt+R / Alt+K | Toggle Search contents, Regex, or Keep open, respectively. |
| Esc | Close search. |
| S / N / M | Select, Pan, or Measure. |
|---|---|
| W / D / F | Wall, Door, or Fixture. |
| L / R / E | Line, Rectangle, or Ellipse. |
| H / P / A | Shape, Polygon, or Arc. |
| T / O / I | Text, Token, or Image. |
| K / C / U | Tile, Coaching, or Spell. |
| 1–9 | Choose an option by its position in the active tool’s menu. With Select, 1–6 choose Map & Token, Map, Token, Background, Coaching, or Any. |
| B | Toggle BigFill. |
| Arrow keys | Move a single selected token by one snap step. Otherwise, pan the map. |
|---|---|
| Shift+click | Ping that point on the map. |
| Alt+drag | Pan temporarily. Dragging with the middle mouse button also pans. |
| Enter | Finish the current click-based tool, or open the map menu at the center of the canvas. |
| Esc | Dismiss a menu, finish a click-based tool, dismiss an open dialog, or clear the selection. |
| Space | Toggle Acted on each selected token. |
| Shift+Space | Clear all status flags on selected tokens. |
| Delete or Backspace | Delete selected objects. |
| Ctrl+X, C, V | Cut or copy map objects, or paste the copied objects at the pointer. |
| Ctrl+Z / Y | Undo or redo a map change. While drawing a polygon, Undo removes the last point. |
| Enter / Shift+Enter | Send the message or insert a new line. |
|---|---|
| ↑ / ↓ | Recall the previous or next message. |
| Esc | Leave the input field. |
| Ctrl+P / N / J | Recall the previous message, recall the next message, or send. |
| Arrow keys | Move between cells. Hold Shift to extend the selected range. |
|---|---|
| Esc | Collapse the range to the active cell, or cancel a cell or header edit. |
| Delete | Clear the selected cells. |
| Enter / Shift+Enter | While editing a cell, save and move down or right. At the edge, request a new row or column. |
| Ctrl+Enter | From a selected cell, insert a row below. From a column header, insert a row at the top. |
| Ctrl+Shift+Enter | Insert a column to the right. |
| Ctrl+Shift+arrows | Move the current row up or down, or the current column left or right. |
| Ctrl+B, I, U, D | Toggle bold, italic, underline, or strikethrough on the selection. |
| Ctrl+X, C, V | Cut, copy, or paste cells. |
| Ctrl+Z / Y | Undo or redo a sheet change. |
| Ctrl+P / N / B / F | Move up, down, left, or right. In cells, hold Shift to extend the range. |
| Ctrl+H | Start editing the cell or column header. |
| Arrow keys | Move between cells in the roll table. |
|---|---|
| Enter | Move down from a weight or value cell. While editing, Enter saves and Esc cancels. |
| Enter or Space | Toggle Table? when its checkbox cell is focused. |
| Ctrl+Enter | From a weight or value cell, insert a row below. |
| Ctrl+Shift+↑ / ↓ | Move the row up or down. |
| Ctrl+Delete | Delete the current row. |
| Ctrl+P / N / B / F | Move up, down, left, or right. Ctrl+H edits a weight or value. |
| →, ↓, or N | Advance the focused clock. |
|---|---|
| ←, ↑, or P | Move the focused clock back. |
| Enter / Esc | In the statblock filter, open the first match or clear the filter. |
| ↑ or K / ↓ or J | In statblock results, select the previous or next match. |
| Enter or Space | Show the focused statblock. Hold Shift to open it in a separate window. |
| Tab / Shift+Tab | In notes, macros, and the scratchpad, insert two spaces or remove two spaces immediately before the cursor. |
|---|---|
| Esc | Leave the editor. In an inline rename field, cancel the edit. |
| Enter | Save an inline rename or accept a single-line dialog field. |
| Shift+Enter | Accept a multiline text or Markdown dialog. |
| ↓, J, or Tab | Move to the next context menu item. ↑ or K moves to the previous item. |
| Enter or Space / Esc | Activate the focused menu item or dismiss the menu. |
| 0–9, Delete, Backspace | In a numeric menu item, focus the number field. Enter applies the value and closes the menu. |
| Alignment: | |
| Link To Map: | |
| Link To Note: | |
| This map can't be deleted. | |
You or your browser has restricted reading the clipboard so we have this crappy dialog instead.
Paste into the textbox then hit ok.