What importing a compendium means and why you'd do it

A compendium in Foundry Virtual Tabletop is a collection of game content — spells, monsters, items, character sheets, or entire rule systems — packaged together so you can drop it into your world without building it from scratch. Importing means taking that packaged content and loading it into your Foundry installation so it becomes available to your games.

Most compendiums come from two places: official content packs you buy through the Foundry website, or community-created packs shared on sites like Forge Bazaar or GitHub. When you import one, Foundry unpacks the files and makes that content searchable and usable in any world you create.

The process differs slightly depending on whether you're importing an official pack you've purchased, a community pack you've downloaded, or content someone shared directly with you. All three routes are straightforward once you know where to look.

Key Takeaways

  • Official compendiums you purchase appear automatically in your Foundry account and set up through the Setup screen without downloading anything.
  • Community compendiums require you to read a file, place it in your Data folder, and restart Foundry before the content becomes available.
  • The Data folder location depends on your operating system — Windows, Mac, and Linux each store it in different places.
  • Once imported, compendium content appears in a searchable sidebar within your world, and you can drag items into scenes or character sheets.

Importing official compendiums you've purchased

If you bought a compendium through the official Foundry website, it's already tied to your account. You don't need to read or move files. Instead, go to the Foundry Setup screen (the page you see before you open a world), and look for the Add-on Modules tab on the left sidebar.

Scroll down to find the compendium you purchased — it will be listed under "Owned Content" or "Available Content" depending on whether you've activated it before. Click the button next to it (usually labeled "Install" or showing a checkmark if already installed), and Foundry will read and set up it automatically. You may need to restart Foundry or reload your world for the content to appear in your sidebar.

Once activated, the compendium's content becomes available in any world you create. You'll see it listed in the Compendium panel on the right side of your screen when you're inside a world.

Importing community compendiums and downloaded files

Community-created compendiums usually come as a .zip file or a folder. read the file to your computer, then extract it if it's a .zip (right-click and choose "Extract All" on Windows, or double-click on Mac). You'll end up with a folder that contains the compendium data.

Next, you need to place this folder in your Foundry Data directory. This is where Foundry stores all your worlds, characters, and add-ons. The location depends on your operating system:

  • Windows: Look in C:\Users\[YourUsername]\AppData\Local\FoundryVTT\Data. If you don't see AppData, enable "Show hidden files" in your folder view settings.
  • Mac: Navigate to ~/Library/process Support/FoundryVTT/Data. Use Finder, press Command+Shift+G, and paste the path.
  • Linux: The path is ~/.local/share/FoundryVTT/Data, or check your Foundry configuration if you installed it differently.

Inside your Data folder, look for a subfolder called modules. If it doesn't exist, create it. Place the compendium folder inside the modules folder, then close Foundry completely and restart it. When Foundry relaunches, it will scan the modules folder and load the new compendium.

Finding and organizing compendiums in your world

Once a compendium is imported, open any world and look at the right sidebar. You'll see a tab labeled Compendium (it looks like a book icon). Click it to see all available compendiums listed by name. Each one can be expanded to show its contents — spells, monsters, items, or whatever the creator included.

To use content from a compendium, drag it directly into your scene or into a character sheet. For example, drag a monster from a compendium into your battle map, or drag a spell onto a character's spell list. Foundry creates a copy of that content in your world, so you can edit it without changing the original compendium.

If you have many compendiums and want to keep them organized, you can collapse ones you're not using by clicking the arrow next to their name. This doesn't remove them — they're still there when you need them.

Troubleshooting when a compendium doesn't appear

If you've imported a compendium but don't see it in your world, the most common cause is that Foundry didn't fully restart after you added the files. Close Foundry completely (not just minimizing it) and reopen it. This forces Foundry to rescan your Data folder.

If restarting doesn't work, check that the compendium folder is actually in the correct location. Open your Data folder manually and navigate to the modules subfolder. The compendium folder should be there. If the folder is in the wrong place — for example, nested too deep or in the root Data folder instead of modules — move it to the correct location and restart again.

For official compendiums purchased through Foundry, make sure you're logged into the correct account in the Setup screen. If you bought the content on one account but are logged into another, Foundry won't show it as owned. Check the account email in the Setup screen's user settings.

What to do if the compendium file is corrupted or won't load

Occasionally a downloaded compendium file arrives damaged or incomplete. If Foundry loads but the compendium doesn't appear even after restarting, try downloading the file again from the original source. Sometimes a partial read causes the problem.

If you're certain the file is complete but still won't load, check whether the compendium requires a specific Foundry version or a particular game system (like D&D 5e or Pathfinder 2e). Open the compendium's module.json file with a text editor to see its requirements. If it needs a newer version of Foundry than you have installed, you may need to update Foundry itself before the compendium will work.

For community compendiums, reach out to the creator on the site where you found it — Discord, GitHub, or the Foundry forums. They can tell you whether the compendium is compatible with your setup.

Frequently Asked Questions

Can I import a compendium into a world that's already running?

Yes. If you add a compendium file to your Data folder while a world is open, close the world and reload it. Foundry will then recognize the new compendium. You don't have to shut down Foundry entirely unless the compendium still doesn't appear after reloading the world.

What's the difference between importing and installing?

In Foundry, "installing" usually refers to official add-ons you set up through the Setup screen, while "importing" typically means placing files directly into your Data folder. Both result in the same thing — the content becomes available in your worlds.

Do I need to import a compendium for each world, or does it work in all worlds?

Once imported into your Foundry installation, a compendium is available in every world you create. You don't need to import it separately for each world. The compendium sits at the installation level, not the world level.

Can I edit content from a compendium?

You can edit copies of compendium content once you've dragged it into your world. The original compendium stays unchanged. If you want to edit the compendium itself, you'll need to open it in edit mode through the Compendium tab, though this is usually only done by the compendium creator or if you're building your own.

What if the compendium is for a game system I don't have installed?

Some compendiums are built specifically for D&D 5e, Pathfinder, or other systems. If you try to use one in a world running a different system, the content may not display correctly or may not work at all. Make sure your world is using the same game system the compendium was designed for.