Token Features

Creating a New Token

Any image that is placed on the Objects and Tokens or the GM Info Overlay layer will automatically become a Token object. You can always scale the token image by right-clicking and selecting Advanced >> Set Dimensions; you can also make use of a grid that can influence other methods of changing image scale (i.e. Image Handles) to greatly simplify the process.

Resizing and Rotating Tokens

Every token is accompanied by image handles on each of the corners of the token and in the middle of each side. You can use these image handles in order to change the size of the token. Additionally, each token has a rotation handle that juts out from the token itself. The rotation handle represents the "front" of the token and can be used to orient the token to face any desired direction.

If you are using a grid for your play area, typically when resizing a token, it will snap to the grid. However, by holding the Alt key while using the image handles to resize you can temporarily disable this functionality. This can be very useful when aligning tokens that do not have identical dimensions.

Token Layout

Radial Bubbles

These three input bubbles can be used by players or the GM to keep track of health, turns, money, fuel, or any other useful metric for your game. By clicking on the bubble, you can change the value. You can enter a new value (i.e. "20" or "ABC") and for numerical values you can also enter relative values (i.e. "+5" will add 5 to the current value).

You can change the colored rims of the bubbles by going to the Token Bar Colors + Display Settings section of the My Settings tab located in the Sidebar.

Bar Overlay

If set to be visible, these are dynamic bars that will fill or empty depending on what is entered in its corresponding colored bubble. For more information, see Bars and Auras in the Token Settings section.


If set to be visible, this will display the name of the Token. For more information see Name in the Token Settings section.

Token Settings Button

Clicking on the Edit button brings up a new window where you can name the Token, set permissions on who can control the Token, set what bars/auras are visible to/editable by the players and keep storage of GM notes. You can also double-click on the token to open the same settings dialog.

This button is only visible to GMs within the game.

Token Markers

This button rolls out a menu that gives you a series of colored dots, a red X and over 40 different token markers that overlay over the Token image. You can use these to show status effects, ailments, or to differentiate multiples of the same Token type. You can have multiple Token Markers displaying simultaneously.

You can also add a numeral to individual Token Markers by mousing over the desired Token Marker in the roll-out menu and tapping "0" through to "9" on the keyboard or numpad. A red numeral will appear on the Token Marker. Tapping "0" will clear the numeral from the Token Marker (but the Token Marker remains until it is clicked again in the menu).

The default position for the Token Markers is across the top of the token, but you can choose to have them run along the bottom, right or left side by going to the Token Bar Colors + Display Settings section on the My settings tab on the Sidebar and selecting the layout from the Marker Position: drop-down menu.

Token Interface.jpg



Basic Token Settings

Basic and Advanced Settings

Token settings are split into Basic and Advanced Tabs, you can seamlessly switch between tabs while editing your token information. All changes update in real-time.

Represents Character

Tokens set to represent a Character will fetch the information found in the Can Be Edited & Controlled By settings in the selected character handout allowing for simple permission assignment. Furthermore, setting a token to represent a character allows the token to fetch information from the character handout's Attributes & Abilities for use in the Token Bars.

If a token represents a character you can open the Bio & Info Tab  of that character by holding Shift and double-clicking the token. Holding Alt while double-clicking the token will instead open the Character Sheet Tab if one is available, otherwise it will open the Attributes & Abilities Tab.

For more information on how to establish a link between tokens and characters, please see the Linking Tokens and Characters section.


Here you can set the name of the Token. If you choose to use the Turn Tracker in your game, the Token's name will appear next to its thumbnail picture in the turn list.

Token Settings Dialog.png

Controlled By

This is where you assign who in your game has permission to control the Token. If the Token represents None/Generic then clicking on the "Controlled By" field will bring up a list of all the players in the current game as well as being able to select the option "All Players". You can assign multiple players to a single Token. If the Token represents a specific Character, then the Token is controlled the player that has control of the Character which is set in the Journal. GM always has control over the Tokens in their Game.

If you are creating a brand new Game and your players have yet to join, their names will not yet be available for Token assignment. If you're setting your game up in advance of your first session, it's recommended to set your Tokens to "All Players" and later fine-tune the permissions when your players have joined.

Tint Color

Here you can add a color filter to the Token. The default tint color is transparent.


This is where you can set whether any of the three bar elements are either visible and/or editable to the players. You can also input numerical values for the Radial Bubbles directly from the Edit Token window. There are two input fields available for each Bar. The first field is for the Bar's current value and is what's featured in the Token's corresponding Radial Bubble. The second field is for the Bar's total value. If it is supplied, Roll20 will use the comparison between the two numbers to render how full or empty that corresponding Bar appears on the Tabletop. The fill will reflect whatever the Player plugs into their Bar Value Bubble while in-game.

Also note that if the Token has selected an option for Represents Character, you can choose to link each bar to specific Character Attributes. If you change the value in the bar (via the Token settings, radial bubbles, or in the Character settings) the value will update automatically.

In some modules/addons, the bars may be pre-set by the creator. You are free to assign these to fit your needs and the needs of your players should you so choose.


An Aura is a translucently filled circle or square that radiates from the center of a Token. You can have up to two Auras active at once on any given Token. To turn one on, make sure it's toggled on to See first and then enter a radius value for the Aura. Next to the Aura's radius input field is a palette button where you can choose the color for the Aura. You can set the Aura to a square instead of a circle by checking off the "Square" checkbox next to the color palette button.

GM Notes

This is a field where a GM can keep private notes on any given Token.

Advanced Token Setting Dialog.png

Advanced Token Settings

Player Permissions

There are two possible permissions for each setting: See or Edit. You can toggle the flag for each type by checking or un-checking the corresponding box.

Setting the See flag will allow all players in the game to view the current value of the bar, or see the aura drawn on the tabletop, regardless of whether or not they can control the Token. Setting the Edit flag will allow all players who can control the Token (based on the Controlled By field) to see and edit the values of the bar, or change the radius of the aura drawn on the tabletop.

So if you have a Token for which you want all players to see the bars (like a Player Character), set the See flag. If you also want to allow some players to modify their own bars/auras, set the Edit flag. If you only want players who can control the token to see and edit the bars, set only the Edit flag. If you set none of the flags then only the GM will be able to see or edit the bars and auras.

Emits Light

This section is relates to a feature exclusive to Plus and Pro subscribers, or to players in a Game created by a subscriber. If you'd like to use this feature, consider upgrading your account.

Here you can set how far light emits from the Token and if All Players can see the light emitted when Dynamic Lighting is enabled. This option allows you to enter a light radius amount and gives you a checkbox for All Players See Light. When the checkbox is left unchecked, the only player(s) who can see that token’s light emission are those who have assigned permission to that token.

In addition to emitting light, you can now customize the “angle” of lights and the line of sight of tokens. So you can specify, for example, that a player should only have a 140-degree field of view instead of 360-degrees.

The Multiplier feature allows you to adjust how effectively a token sees light. At a value of 1 the token sees light normally but at a value of 2 the token sees twice as far with the same light source.

Syncing Tokens and Characters

Syncing tokens and characters via the Token Settings can automate much of the book-keeping required in many games. Typically, once a character is dragged on to the Tabletop it will create a linked token using the same image from the Bio & Info Tab of that character. However, in cases where you wish to use a separate image or to assign values to the token bars, you will need to update the connections. Below outlines how to accomplish this task to ensure your game runs as smoothly as possible! 

Linking Tokens and Characters

  1. Ensure your Character is in the Journal
  2. Import the image you wish to use as your token by dragging it onto the Tabletop
  3. Open the Token Settings
  4. Select a character in the Represents Character drop-down menu
    1. Once a character is selected, the Name field will auto-populate. However, this can be changed at any time.
    2. If you have assigned who can control the Character in the Journal, then those settings will automatically apply themselves to the Token Settings.
  5. Assign desired attributes for bars (Health, Energy, Armor, etc.)
  6. Make sure to Save Changes
  7. Revisit the Character entry from the Journal
  8. Select Edit located in the top right
  9. Select the token you wish to use, and click the Use Selected Token button
    1. When a token is selected, you will see the image handles around the token.
  10. Make sure to Save Changes

If you need to make changes to the token, or you are noticing that the information you want is not accompanying the token when you drag it on to the Tabletop, then you will need to ensure that you make the necessary changes and re-do steps 7 through 10.

If you are looking to assign a token which have multiple copies on the Tabletop, ensure that you un-link the attributes associated with the bars prior to saving as the default token. If this is not done, values changed on one copy of the token will change values on all copies of the token.

Was this article helpful?
194 out of 270 found this helpful