Character Vault
Any Concept / Any System
Your System Come To Life
Roll20 for Android
Streamlined for your Tablet
Roll20 for iPad
Streamlined for your Tablet

Personal tools

Token Actions

From Roll20 Wiki

(Redirected from Token Action)
Jump to: navigation, search

Attention: This page is community-maintained. For the official Roll20 version of this article, see the Help Center for assistance: Here .

Token Actions Interface.png

Token Actions are specially-designated macros and character abilities (with tokens representing a character) which appear whenever a token is selected on the screen. They appear in a bar along the top of your screen, and the contents of the bar are context-sensitive. When you select a token, all macro token actions will be shown, as well as ability token actions for the token's linked character (if applicable).


Token Actions

Token Actions Usage.png

This means, for example, if you designate that 3 abilities for the Character "Mr. Bearington" are token actions (1.), those actions will only show up for tokens that are linked to (2.) "Mr. Bearington", not for all tokens.

This allows you to easily setup abilities and macros to be used as token actions for both you and your players, without them needing to mess around with creating their own macros.

When creating Token Actions, you can also use the @{selected|tokenactionname} token variables along with token actions to great effect, creating macros for system-wide rolls (e.g. Bluff) that show up when a token is selected, and pull information from the selected token to perform the roll (3.).

You can also, for example, set up a monster's abilities in a Character for that monster type, and then have easy access as GM to those abilities whenever you select a token of that type, without cluttering your macro bar or hunting in the journal tab to use them. For example, create a Character called "Dire Bear", link all tokens that are dire bears to that character, and then set up abilities designated as token actions such as "Swipe" and "Roar". You can then just click a dire bear token, then click the button for "Swipe".

You'll find a new checkbox when editing Macros to designate it as a token action(4.), and you'll find a similar checkbox when editing an ability, below where you enter the name of the ability. Just check the respective box and save the macro/ability, and the next time you select a token you'll see it as an action.


You can either:

  1. Create macros on the l Collections-tab, then toggle "Show as Token Action?"
    • These token actions are visible on all tokens
  2. Create a character ability on a character, and then toggle "Show as Token Action".
    • These Token actions are only shown on token linked to the specific character.

See Macro Guide for more details

Turning a character ability into a Token Action.



By default, *Token Actions* are sorted alphabetically. Under the default, you can preface Token Actions (Macros or Abilities) with something to affect sorting.

Some options:

  • Numbers -- using numbers like 1, 2, 3 will get sorted as you would expect. If you have more than 9 macros, you'll want to zero-pad them to maintain the order: 01, 02, 03, 04, ...
  • Symbols -- There are various UTF-8 symbols you can use to categorize your Token Actions with icons. All Token Actions with the same symbol will be grouped together. This will require some trial and error as different operating systems have different symbols they support. Search Google for "UTF-8 Symbols" to start finding some. ☀, ☄, ★, ☯, ... These include " " in macro names (Alt+255).
  • Zero-width Spaces -- You can also use zero-width spaces, if you are concerned about the length of your Token Actions names growing. Simply put some number of them before the name of your Token Action, the more there are, the earlier it will be listed. You can use this code to represent one zero-width space: ​
  • Some Combination of the above -- You might decide to use zero-width spaces with UTF-8 symbols to get just the right iconography and sorting.


If you have grown accustom to the old way of ordering Token Actions, you can revert to the legacy behavior by disabling the alphabetical sorting of Token Actions. This is a per player setting which can be found in the My Settings-tab. Under this system, the order in which Token Actions are shown in the Abilities section of a Character determines the order they are shown in the Token Action menu bar.

Note: This only works for Abilities that are shown as Token Actions; If you have any Macros set as Token Actions, the order of the tokens will not be predictable.

Character Sheets

Main Page: Building Character Sheets

Tokens can be built into character sheets so they automatically appear in tokens using the sheet, but the drawback is that these can't be removed from tokens, so it's generally not done.


Main Page: API:Script Index

  • Token Action Maker(Forum) -- creates token actions on selected tokens for the D&D 5e by Roll20 sheet

Related Pages