Feature: Import by Category

From 5etools Community Wiki
Jump to: navigation, search


Import by Category.gif

Import by Category

This feature retrieves 5eTools website data and converts it for use within Roll20.

Instructions (How to use it)

Go to the settings tab and choose Import by Category
Choose the category of content you wish to import
Please note that Map Import and Import -> Adventure have been replaced by Module Importer/Exporter
After choosing the Catgory (Depending upon the category) choose either:
  • Import <category_type> from 5etools
(see below)
  • Custom
This is for loading an JSON not hosted or provided by the 5etools website, or the tools (affectionate name for the user community)
You will need to provide the specific URL for the file (please see best practices below for more detailed steps on how to import from custom URLs.

Once that has been chosen you will choose which source/content you'll be importing.



Currently, the adventure importing loads the text of the adventure booklet, not the map, nor monsters and their locations on the maps or any NPCs
These are not Drag and Drop. You can modify these without loss of function.


These are character creation backgrounds, there are more which you can import the 5eTools Website Homebrew Repository.
Background Feature is brought over via Drag and Drop, the Suggested Characteristics -- Personality Trait, Ideals, Bonds, & Flaws are not - those will need to be manually chosen and either cut and paste on the character sheet from the Background's player facing Description & Notes or manually typed. 


This is the core (base) class such as "Fighter" or "Warlock", Subclasses are handled separately.


Feats are 
When Drag-n-Dropped this doesn't automatically update the Attributes or prompt for choices when the Feat offers two choices.


This includes Adventuring Gear, Ammunition, Weapons, Firearms, Armor, Magical Items, Spellcasting Foci, Shield, Instruments, Tools, Vehicles, Machines, Mounts, Gaming Set, Artisan Tools, Poisons, etc.


Monsters bring over the character sheets (NPC) for the monsters in Roll20's 5e / OGL Character Sheet format.
Importing Monsters through this tool can include configuration of token settings/token action macros and some settings related to the default character sheet behavior, you modify these in the Configuration Editor
NOTE:' modifying these settings AFTER importing doesn't change what has already been imported.
Shaped Character Sheet should be able to automatically migrate such information when opened for the first time, 


 These are mostly siege weaponry


 The UA listing of Psionic Powers and Talents.


Regretfully to make the Drag and Drop feature work, each subrace is a separate Handout.


These are the spells. You add these by clicking and dragging them upon the character sheet.
NOTE: the more spells a character sheet has, the larger and more cumbersome it is to work with, its a best practice to include the spells you are using, and remove ''that ones' you do not, and even perhaps not listing the ones that more 'effect' than combative/contested. 
Fireball requires saves and rolling damage, and so is an obvious and worthwhile choice,'Skywrite is a ritual that doesn't require significant interaction mechanically to manage - so it would not be.)  

NOTE ALSO: There is no category for 'handouts' separately, nor one for Maps (Roll20 designation as Pages).

Maps - the graphics are handled through External Art Tools, and Handouts are through Adventures, Items, Classes, Spells/Powers - those categories define what and how handouts are imported.




Check the Config Editor's into the πŸ—‚οΈ Import tab.
Each of the entries in the config editor modifies elements of the import; from timeoutdelay to what token actions are or are included.
For more information please see Config Editor's Import Tab features.

Feature Support

Known Issues/Limitations

Where is the dynamic Lighting and tokens for the maps?

You're likely wanting to use the Module Importer/Exporter. As the page says, Import by Category Adventure; is a bit dated.

Why are my spells only showing blank cards/boxes?

This is a known issue, you will need to go in and edit the spell card; often just re-saving will solve that issue, but you may need to define the card as an attack.


Monster Importer isn't working, or hangs?

You likely aren't at the current release - check the chat log in Roll20 for the notification that you are using an out of date version and that there has been a newer release.

Best Practices

None as yet (Do you have any suggestions?)

Related Features

Did that answer your question(s)?

If not please check the under Support; Troubleshooting or the Known Issues page for further guidance, or go to the Discord community and leave a comment in the issues channel.

If you enjoy the project, please follow this link to see how you can contribute and help make it even better.