Map Pins are now available in Open Beta for all users (including free accounts) in games using the latest version of the Roll20 tabletop engine. This highly requested feature gives Game Masters powerful new tools to connect lore, maps, and gameplay directly on the tabletop - no subscription required.
Please report any issues that arise in your games during the ongoing beta so our team can address them, and let us know if you have specific thoughts about the direction you’d like to see Map Pins continue to develop via our direct feedback form.
Map Pins allow GMs to pin information and link handouts to specific map locations, creating a richer, more interactive storytelling experience. Pins can be visible or hidden, allowing for dramatic reveals during play like unveiling a quest or NPC backstory, shedding light on a found location, or springing a trap on an unsuspecting party.
How to Use Map Pins
Map Pins are handout-linked markers that appear directly on the map and are connected to handouts in your journal. They can be created and configured in just a few clicks.
Creating a Map Pin (GMs)
Create pins by:
- Dragging handouts from the Journal to the map
- Dragging an anchor (heading) from within a handout
- This creates the “Go to Pin” button within the handout
- Or, create a pin from scratch
- Place Pin tool now found in the left toolbar
- Right-click on the map > Place Pin in the menu
Tooltips
- Dragged pins autofill (as available) image, title, player notes, GM notes.
- Pins created from scratch require the GM to fill out or link a handout in Edit Pin settings.
- Pins can now override the image and GM notes (previously only player notes) even when linked to a handout using the “Custom” tab instead of “From Handout” in tooltip settings.
- Player and GM notes are separated into tabs within the tooltip
Interacting with Pins
- Click a pin to view its tooltip
- Click an image to open it in a larger view.
- Press Shift + z, or Shift + Click, to show a Pin image to players.
- Double-click the pin to open the linked handout.
- Players see a pop-out icon on pins when they have permission to view a linked handout.
Visibility
When created, pins default to a hidden state and are only visible to the GM. A hidden pin has a dashed border and appears translucent, and a visible pin has a solid border and appears opaque. Each pin has a visibility toggle on the pin mini menu and can also be updated in pin settings.
Nameplates can be set to only appear upon hover (check “Hover to display nameplate and bar overlay” in VTT Settings > Graphics) or disabled altogether in pin settings.
Pin Settings
Pin Settings can be accessed from the pin mini-menu. You can change the name, visibility, linking, and display of the pin, down to choosing exactly which information players will see. You can even set a custom Tooltip with unique images, player notes, and GM notes if you don’t want to use the actual text from your handout.
Additional Features
Go To Pin (Anchor Pins)
Need to find a pin you’ve placed from an anchor? From the handout itself, use the “go to pin” button. This will center your view on the pin location, even if you’re on a different page at the time, and is a great feature to pair with “Place Party” tools to quickly bring your players to their next location.
“Drag to add Pin to Board” and “Copy Header Link” buttons appear on hover (or tap on mobile). This can be changed to always display in VTT Settings > Accessibility > Show Pin Controls in Handouts.
Layerless Interaction
Pins can be accessed and edited from any layer (no switching required), and not only help you organize information as a GM, but also allow your players access to notes and pictures without you having to actually share handouts to their journals.
Using Blockquotes for Player Flavor Text (Anchor Pins Only)
Map Pins support a way to separate player-facing and GM-only information when Handouts include blockquote formatting within GM Notes (common in D&D official adventure Modules to indicate information to share with players).
When editing a Map Pin created from an Anchor (header within a Handout), there is a new option in the Tooltip section of Edit Pin Settings:
- Use blockquote as player flavor text
When checked, this setting automatically designates the first blockquoted section under that header as information to share with players, and displays it in the pin’s tooltip. Any remaining text under that header is treated as GM Notes.
Notes:
- This option only appears on pins created from an Anchor (header within a Handout).
- Anchor Pins created from GM Notes default to flavor text ON
- Anchor Pins from Player Notes default to OFF
- If you edit a pin and change which header it links to, the behavior updates automatically based on the rules above.
- This feature does not apply to Map Pins created by dragging Handouts to the tabletop. Those continue to work exactly as they did before.
Resizing Map Pins
GMs can customize the size of Map Pins based on map style, grid scale, and personal preference. This is especially useful for visually representing:
- Discreet Pins: Default-sized pins sometimes cover too much map artwork, especially on smaller or half-scale grids.
- Emphasis & Hierarchy: Some GMs want to visually emphasize certain pins while keeping others more subtle.
How to Resize a Pin
- Select a Pin on your map
- Open Edit Pin
- Go to the Customization tab
- Choose a size from the available options:
- Teeny
- Tiny
- Small
- Medium (default)
- Large
- Huge
- Gigantic
Frequently Asked Questions
Will Map Pins be available to everybody when they're out of beta?
Yes! All users (including free) will have access to Map Pins when they come out of beta. We may release advanced features requested by subscribers in the future, but that information isn’t available at this time.
Can I create a pin that isn’t linked to a handout?
Yes! Use the Place Pin button from the left toolbar or the right-click menu to make a pin from scratch. You may also unlink a pin created by dragging a handout/anchor.
How do I customize pins?
You can currently customize the size of pins and their tooltips. We’re currently developing more customization options. In the meantime, let us know what types of customization you’d like to see here.
Can I navigate from a handout to the pin I created by dragging it to the map or from scratch?
The “Go to Map” button currently works only for pins created from anchors.
Does making my pin visible automatically share the handout?
No. Making a pin visible only allows players to see a preview excerpt of the handout content via its tooltip. If you want to give players full access to the handout, you’ll need to share it with their journals separately. You retain full control over what’s revealed and when.
Can I use Mod Scripts (API) with Map Pins?
Support for this is in development and coming VERY soon! Follow our social media for updates.