As your Foundry VTT campaign grows—whether it’s a sprawling sandbox, a multi-act epic, or even a one-shot with dense environments—you’ll likely find yourself juggling dozens (if not hundreds) of tokens, tiles, drawings, sounds, and other placeable objects. Searching for “that one door,” “that specific trap,” or “the token tied to a puzzle” can become a chore.
The Tagger module solves that problem in a simple and elegant way. It lets you attach custom tags to anything on your scene, and then find, reference, or manipulate those things later using automation, macros, or other modules.
In short: it brings a layer of structure and control to the chaos of a busy VTT.
What Is Tagger?
Tagger is a utility module that allows you to apply one or more tags—simple, searchable text labels—to almost any placeable object in a Foundry VTT scene. This includes:
- Tokens
- Tiles
- Drawings
- Sounds
- Notes
- Lights
- Templates
- Walls (with some limitations)
Once tagged, those elements can be easily identified, searched for, or referenced in macros, scripts, and modules like Sequencer, Monk's Active Tile Triggers, or Token Attacher.
Key Features
Custom Tagging for Any Placeable
You can add as many tags as you like to a placeable object. Tags can be anything: trap, door, trigger-area, puzzle-switch, enemy-group-a, loot-chest, etc.
Searchable Tags
Tagger adds a search bar to the Token Controls layer. You can instantly highlight all objects in the scene that match a specific tag.
Integration with Other Modules
Many advanced automation modules rely on tags to identify what to affect. Tagger is often required or strongly recommended for tools like:
- Sequencer: For triggering visual/audio effects on tagged elements
- Monk's Active Tile Triggers: For interactive tiles that respond to player actions
- Token Attacher: To manage complex groupings of tokens and objects
- Warpgate: For spawning and transforming tokens and props
Macro-Friendly
You can use Tagger in your macros to find and manipulate objects programmatically. For example, a macro could open all doors tagged with cell-door, or trigger all tiles tagged with trap-fire.
Why Use Tagger?
Tagger becomes increasingly useful the more complex your scenes become. Here’s where it really shines:
- Scene Organization: Identify and group objects without relying on their names or manually browsing the sidebar.
- Reusability: Create repeatable interactions. If you build a trap system using tagged tiles and triggers, you can reuse it in multiple maps.
- Automation: Instead of hardcoding UUIDs or object IDs, you can reference tags. This makes your macros and triggers more resilient and portable.
- Visual Management: Tags help you and your co-GMs remember what each object in a cluttered map is supposed to do.
How to Use Tagger
- Install and activate the Tagger module via the Foundry VTT module browser.
- Right-click any placeable object, open its configuration, and add tags in the “Tags” field (comma-separated).
- Use the tag search tool from the token controls panel to filter and highlight matching items.
- Leverage the tags in macros or other modules to dynamically affect specific elements.
For example, using Tagger in a macro:
const tiles = Tagger.getByTag('trap-fire');
tiles.forEach(tile => tile.document.update({ hidden: false }));
This will reveal all tiles tagged with trap-fire.
Best Practices
-
Use Consistent Naming: Create a simple tag naming convention for your campaign (e.g.,
trap-[type],door-[area],event-[scene]). - Tag Early, Tag Often: It’s easier to build and maintain scenes when tags are applied during creation.
- Combine with GM Notes: Use tags in conjunction with journal entries and notes for a modular, maintainable workflow.
- Document Your Tags: Keep a reference in a journal entry or GM screen to track what tags you’re using across maps.
Final Thoughts
Tagger doesn’t draw attention to itself—and that’s its strength. It quietly gives you a powerful organizational tool that integrates seamlessly with other modules and scales effortlessly with your campaign’s complexity.
Whether you’re building interactive environments, running complex battles, or just trying to stay sane while managing a huge scene, Tagger is a must-have for anyone who wants better control and cleaner workflows in Foundry VTT.