Interactive dice roll buttons are a great way to make your articles more engaging in an RPG setting! On World Anvil, you can easily add rollable dice with support for most systems. Here's how!
How to create a dice roller
With the Visual Editor
If you use the Visual Editor:
- Open the slash menu and look for the Dice Roller option (i.e. type "/dice roller").
- After clicking on the option, you'll see a Dice Roller block in your editor.
- Mouse over the Dice Roller block and click the edit button next to it.
- Use the pop-up to edit the dice roll formula (see below for details).
Within the Visual Editor, clicking on the Dice Roller will also roll the dice! The result will appear on the top right of your screen.
With the Advanced BBCode Editor
Use the [roll] BBCode tag followed by the dice roll formula. Here's a couple of examples:
As you can see, it's pretty simple. Just type the [roll:...] tag with the dice formula inside. And if you want to change the button label, just write it after a | pipe character.
Basic dice notation
World Anvil's dice system supports a large variety of formulas you can use to represent rolls in pretty much every RPG system. The basic dice notation is NdT, where N is the number of dice and T is the die type. Here are some examples:
| Code example | Description |
|---|---|
| [roll:3d8] | Rolls three 8-sided dice. It displays both the individual results and their sum. |
| [roll:1d%] | Rolls a percentile die (d100). |
| [roll:2dF] | Rolls a Fudge dice (6-sided dice whose values are 1, 1, -1, -1, 0 & 0). |
| [roll:3d4+5] or [roll:3d4-5] | Rolls the specified dice, then adds or subtracts the given modifier. |
| [roll:3d4!] | Exploding dice (dice that roll their maximum value are re-rolled). |
| [roll:3d8min3] | Results lower than 3 are raised to 3. |
| [roll:3d8max5] | Results higher than 5 are lowered to 5. |
World Anvil's dice roller uses GreenImp's Dice Roller system. Check out their guide for even more options!


