D&D Beyond Importer in World Anvil Codex | World Anvil

D&D Beyond Importer

Restructuring the Codex

We are currently moving articles around and changing the general structure of the Codex. Please come back later if you get lost!
The D&D Beyond Importer lets you import D&D 5e character sheets from D&D Beyond to World Anvil.  

Before Importing a Character...

If you're proficient with using World Anvil, you can skip to the next section. Otherwise, this section explains how to set up your world for D&D 5e and how to get to the character sheet creation page.   First, you will need to choose Dungeons & Dragons 5e as the world's RPG system. To do so, go to the world settings by clicking the cog button at the bottom of the sidebar. Then, in the Role Playing Gaming System drop-down of the Basic tab, choose Dungeons & Dragons 5e. Save changes.   Then, go to the Statblocks section of the left sidebar. This page displays all statblocks in your world. On the right side of the screen, open the drop-down and pick Character Sheet (2020) (Dungeons & Dragons 5e). Then, click the Create a new sheet button. This will create a new blank character sheet and you'll be ready to import a character from D&D Beyond.  

How to Import Characters

In order to import a character sheet, your D&D Beyond character needs to be public—World Anvil can't import private articles. You can toggle character privacy in the character settings menu. Then, follow these steps:  
  1. Create a new character sheet on World Anvil. It should be a D&D 5e sheet, and, if you have multiple options, make sure it's the 2020 version (its full name is Character Sheet (2020) (Dungeons & Dragons 5e)).
  2. On your right, you'll see a button labelled "Import D&D Beyond Character". Click it—this will open a pop-up.
  3. On D&D Beyond, find the character sheet's ID. To do it, look at the URL of the character sheet: the ID will be the numbers at the end. For example, if the URL is https://www.dndbeyond.com/profile/username/characters/11111111, the ID will be 11111111.
  4. On World Anvil, paste the ID in the pop-up and click Summon my Character.
  5. Note that importing a character will replace the World Anvil sheet with the contents from D&D Beyond. So make sure you haven't opened the wrong sheet by accident.
  Importing a character will automatically save the sheet, so your character will now be fully integrated with World Anvil.  

Limitations of the importer

Due to technical limitations and incompatibilities, some fields won't be imported into your World Anvil sheet. Note that if you re-import a character on a filled-out sheet, fields that are not imported will be blanked out from the World Anvil sheet (but will remain on D&D Beyond). We recommend not using this method to level-up your characters. These are the fields that are not imported:
  • Features like class abilities and spells.
  • Movement speed.
  • Temporary HP.
  • Attribute, saving throw, and skill modifiers that are bonuses on top of the regular modifiers (for example due to magical items).
  • Initiative bonus (beyond the base bonus).
  • Senses (like darkvision, truesight, etc).
  • Armor and tool proficiencies.
  • Certain information about items (such as cost and weight)
  • Background feature, characterstics, and personality trait.
  • Notes




Are changes on D&D Beyond synced with World Anvil?
No, you'll need to re-import the character if you change it on D&D Beyond. Changes on the World Anvil sheet will not be reflected on D&D Beyond's sheet.
When I try to import a character, I get a 403 error. What does it mean?
It probably means that the D&D Beyond character is private. Make sure it's public before importing it—you can make it private again after importing.
It looks like my character is missing something. What's going on?
Our D&D Beyond Importer grabs your basic chartacter sheet. This does not yet include spells, class features, resources or walking speed. These would need to be imported manually.


Please Login in order to comment!
Mar 8, 2022 19:56

This is awesome!

Mar 9, 2022 08:58

You are awesome! :)

[they/them] Creator of Black Light, a science-fantasy universe.
Mar 13, 2022 18:28 by Toby

Great idea! I tried this, and the system gave me an error message: "0: undefined". Any fixes?

Mar 14, 2022 06:35 by Stephen Mayville

I had the same thing happen on one NPC. I ended up deleting the character on D&D Beyond and re-creating it. It worked them. I did leave off some gear on the second one. I wonder if maybe there was a homebrew item it didn't like or possibly I had too many items.

Mar 14, 2022 10:30

Hi! This seems to be a bug—can you report it in our bug reporter? Thanks!

[they/them] Creator of Black Light, a science-fantasy universe.
May 1, 2022 18:23 by Scott Sysol

A bit disappointed as I suggested a character import from fantasy grounds last year, but my feature request was closed with a very unsatisfying answer. I assume you will now build import features from the other online tools.

May 3, 2022 10:51

Priorities in the roadmap depend on several factors. The team is small and developing new features is not quick, so we appreciate your patience and understanding!

[they/them] Creator of Black Light, a science-fantasy universe.
May 17, 2022 15:36

It seems to get a little confused with multiclass characters.

Jul 16, 2022 20:25

Great idea! I tried it out, but it seems it didn't import everything. It ignored the notes, learned spells as well as walking speed and all features / ressources. Well I guess it's because you are supposed to use statblocks for these?

Jul 18, 2022 18:22

That's probably the reason. Can you give me the D&D Beyond character ID so I can pass it on to the dev?

[they/them] Creator of Black Light, a science-fantasy universe.
Aug 23, 2022 10:58

Sorry for the late reply. I deleted the original character I imported, so I just tried it again with a new one. Walking speed isnt filled, but viewing the sheet shows a speed of 30, so I guess thats the standard value. And because my d&d beyond character has 30 speed it wasn't filled. As far as I can see the import missed personality traits, notes, features & traits, spellcasting info as well as learned spells and feats. Some of these might be because you should use the worldanvil statblocks, but personality traits and notes should be imported in my opinion. (Even though copying them over is not such a big deal, so it's not high priority). The D&D Beyond character ID I used is 34020575.

Aug 23, 2022 13:26

Hi! No worries for the late reply.   So, I talked to the dev that made the importer. It looks like D&D Beyond doesn't actually give the walking speed as a calculated value, but instead calculates it internally based on the D&D rules. So essentially the only way to do that on World Anvil would be to code in all rules and effects that can potentially affect walking speed (which, as you know, it's a lot of them).   Currently, the importer works as intended, so not importing traits, notes, etc. is not considered a bug to be fixed. This could change in the future, but right now it's not a priority. I passed on your feedback though, as it's valuable to know what people want!

[they/them] Creator of Black Light, a science-fantasy universe.
Jan 24, 2023 02:57

no equipment imported.. just the basics..no spells no skills.. does this still work?

Jan 24, 2023 09:18

Hi! Unfortunately, due to how D&DBeyond's API works, we weren't able to create a system that imports everything.

[they/them] Creator of Black Light, a science-fantasy universe.
Jan 27, 2023 22:11 by Syogren

Thank you so much for both this feature and this guide. I just imported a character from D&D Beyond and there were no errors! However, I noticed it didn't import any of my character's spells. Is there a way to do that automatically, or do I have to add them myself?

Jan 27, 2023 23:04

You'll have to do it yourself, the importing process has some limitations because of technical incompatibilities between the two platforms.

[they/them] Creator of Black Light, a science-fantasy universe.
Aug 26, 2023 10:38

Just getting started and it looks like a great feature.   My primary question concerns where or how a character sheet has a primary key and whether re-importing from D&D Beyond does or does not break linkages or override   0. When re-importing from D&D Beyond, what has to remain constant to make sure the character remains connected to all other connections? (E.g., articles, inventories, party lists, etc.)? I.w.,   a. Is it the name or is there another unique attribute? - or is there a unique World Anvil character Id as well? b. E.g.: if I make a copy of a character, what changes? Is that copy also linked as the original is?     ======= The following are specific applications of Question 0 =========   1. Understanding that leveling happens in D&D Beyond, where is the best place for a player and/or DM to keep notes on the character, a log? If in World Anvil (WA), do notes/articles remain connected to the character every time one re-imports from D&D Beyond?   2. What is the best technique for organizing/managing characters in WA? E.g., when I import a character should I assign them to one campaign, and then this requires re-assigning to another campaign? (I assume that there is actually a central repository where they are kept).   3. Once within WA, are changes to a character global across campaigns? E.g., if a player makes a change (to a character's notes, inventory, and then re-imports, do all the linkages remain the same?

Aug 28, 2023 08:56

Hi! Thanks for the questions.   0. The importer only affects the sheet itself—the sheet is only one part of the character. So it will keep its connections and anything that is not within the character sheet (such as the profile/extended profile tabs). Please note that the importer will delete any of the fields that can't be imported (list above, in the guide).   World Anvil and D&D Beyond characters aren't linked at all. The importer is a one-time connection that happens when you click the import button, but the connection isn't permanent.   1. The Notebook on World Anvil isn't linked to the character sheet, so it will persist when you reimport.   2. I'm not sure I understand this one. Characters are not just the character sheet, so importing a character from D&D Beyond doesn't affect the character's connections whatsoever. You can create and import a character without it being assigned to a campaign.   3. When a character is assigned to a campaign, it isn't "copied" into the campaign, it simply becomes linked to it. So all changes the player makes to the character are automatically reflected everywhere. Yes, when you reimport, links remain—but again, I don't recommend reimporting when levelling up, because certain things can't be imported and they will be deleted from the World Anvil sheet.

[they/them] Creator of Black Light, a science-fantasy universe.
Aug 26, 2023 10:46

This relates to importing - I am just starting into World Anvil (about 2 hours, so still wandering around)   How can I set up or import the D&D 5E Sword Coast and Lost Mines of Phandelver start campaign into World Anvil in the most efficient and organized manner?   My thought is that I can learn World Anvil very speedily by application to this existing campaign.   I could not find any World Anvil store to buy or import the 'compendium' materials, similar to Roll20, so do I have to do it all manually? If so, how do I get the materials out of D&D Beyond and into World Anvil (I want to do this properly)   Thank you

Aug 28, 2023 09:02

Hi! Unfortunately, we don't have a license to distribute any of the official D&D materials, so it will have to be a manual process. We do have the SRD statblocks (as these are free to distribute) in our statblock library. From the editing side of World Anvil, click on "Discover" at the top right and select "Statblocks". There you can see all statblocks created and shared by the community.   You could manually copy over a campaign into World Anvil. However, doing so in public articles (note that free accounts don't have private articles) counts as distribution, which is against D&D's license.   Let me know if this helps!

[they/them] Creator of Black Light, a science-fantasy universe.
Sep 4, 2023 15:46

Sage Ondo,   This really helps - I was hoping for something like this. Thank you!!!   I'll need to dig into this to discover how to use it properly; e.g., I never heard of SRD before. Do you know of any tutorial videos in general, and on using community statblocks and/or the copyright issues in particular?   I.e., I'd like to know how to stay inside the lines of using source materials, and the example you mentioned is one: I was planning on copying the D&D 5E Lost Mines of Phandelver (LMoP) into WA to have one place to manage it and modify it, etc.   LMoP happens to be publicly available on their site, and I have a paid subscription to D&D Beyond as well, but I'd like to understand this in case I want to use other established campaigns.

Sep 5, 2023 07:54

SRD stands for System Reference Document, which, in D&D 5e, includes the free part of their rules. It's the rules you can see in D&D Beyond without paying for anything, for example. The copyright issue is simple: you need permission to use someone else's work, so if you don't have it, you'll be violating copyright. SRD has permission to use thanks to its license.   As for the Lost Mines of Phandelver—you'll have to check its license. Being available for free on D&D Beyond doesn't necessarily mean it has a free license. If somewhere in the book you see a license page that lets you distribute the content, you can copy it anywhere.   Otherwise, if you copy it on World Anvil in public, you'll be in violation of copyright. World Anvil will not do anything by default, but if we get a valid takedown request from the original content's owner, we'll comply with it. If the world or articles in which you copy content from the book is private, then it's ok (you can also add your players as subscribers so they can see some private information).   You can check our Copyright Policy too.

[they/them] Creator of Black Light, a science-fantasy universe.
Sep 5, 2023 21:46

Hi, I am having a significant issue I need help with: 1. I followed the steps to create a new character and then use the D&D Importer: a. Previously I had created an article for the character's background "Calder tar Sar-Gath" b. I received an error 403 that this character is not set to public. 2. All views show tha tthe character is set to public. - I tried further trouble-shooting to include removing the character from the campaigns/world: both are empty.   3. Nonetheless, I can't seem to delete the profile: even tough I accidentally created duplicate provides, I've also gone back multiple times to delete this; no luck.   Thank you,   A. Gamer b. Somewhere in this, the character still shows up in the left hand column, although I've tried every version to delete it.   3. Somwehwere in the trouble-shooting it looks like I created similar

Sep 6, 2023 08:15

Hello again! Have you checked that the D&D Beyond character is public too? The importer can't access it if it's private.   To delete a character on World Anvil, activate it from the left sidebar, edit its profile, and find the "Delete Character" at the bottom right of the page. The character can't be part of a campaign or it won't be deleted. If you aren't able to do it, please let me know what kind of error you're seeing exactly and I'll try to help!

[they/them] Creator of Black Light, a science-fantasy universe.
Sep 6, 2023 23:51

It's 2350 GMT, September 6, 2023 -- if you just heard a bunch of muffled cursing from the direction of the East Coast of the USA - that's me. - That was the problem. Thank you - great to be the HITL error.