Diplomacy Webs in World Anvil Codex | World Anvil

Diplomacy Webs

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!

Guild Exclusive

This is a Master+ feature. To get access, Join the Worldbuilder's Guild!

A diplomacy web is an interactive diagram that visually displays relationships between several organizations in your world. Using them is pretty simple, so let's get right into it!  

Defining relations

First, you need to define at least one diplomatic relationship between two organizations. To do so, edit one of the two organizations and go to the Diplomacy tab. Click the Add a Diplomatic Relation button and use the modal window to fill in the details.   Use the Party 2 field to choose the other organization from your world's list of organization. The relations score, between -100 (terrible) and 100 (perfect) define how friendly that party is towards the other one —remember that Party 1 being friendly doesn't necessarily mean that Party 2 is friendly too!   The official diplomatic status is a free-form text (keep it short) that labels the kind of relationship they officially have —Allies, At war, Non-aggression pact, etc. Finally, you may use the Notes field for a more detailed explanation.  

Using the diplomacy webs

Once you have at least two related organizations, you are ready to use a Diplomacy Web! Choose which organization you want at the center of the web, then edit it and go to the bottom of its Diplomacy tab. In the Diplomacy histograms, copy the Diplomacy widget, which will look something like [diplomacy:ID], where ID is the organization's article ID. Simply paste this code to any article and it will display the web from presentation view:  
  If instead you want to display a massive web of all related organizations, you can also do that! First of all, add a unique tag to all organizations you want to display in the web (more information in the Guide to the Tagging System). Then, simply use the [diplomacy] tag, but instead of an article ID, add the tag you chose. For example, [diplomacy:mainorgs]. This is an example of a full diplomacy web in action:  



Please Login in order to comment!
Aug 19, 2020 18:53 by richard fraser

how do you know which line is for which organization in the second chart? can we get a pop up like in the single chart?

Aug 20, 2020 10:30

Good point! Feel free to add a feature request for that. The link to the bug tracker is in the help page.

[they/them] Creator of Black Light, a science-fantasy universe.
Aug 26, 2020 21:14

It looks like even if your organization article is set to draft or private, it will still show up in the chart for all users. This is a huge bummer, but I guess the workaround is to not tag private organization articles with the tag you're using to populate the chart until you're ready to make them public?

Aug 27, 2020 10:19

That's a good workaround! You can add a feature request too, if you want.

[they/them] Creator of Black Light, a science-fantasy universe.
Aug 28, 2020 13:24

Dimitris just added this as a feature! That was so fast!

Sep 27, 2020 19:07 by E. Christopher Clark

Just a minor point of confusion I ran into. When trying to create massive web, I thought I had to include the # symbol in front of my tag (based on seeing

above). But when I did that, it didn't work. Taking out the # symbol made it work. Not sure if anyone else will get confused, but wanted to mention it.

Check out my progress on the Cabinet of Curiosities
Sep 28, 2020 16:24

Whoops! Fixed. Quick tip for the future: when using BBCode tags in a comment use [noparse] tag goes here [/noparse] if you don't want the tags to display its result!

[they/them] Creator of Black Light, a science-fantasy universe.
Oct 1, 2020 02:00 by E. Christopher Clark

Oops! Thanks for the tip on the noparse tag.

Check out my progress on the Cabinet of Curiosities
Oct 10, 2020 07:18

Two comments: 1. the tag at the top talks about family trees, not diplomacy webs. 2. The article here and other articles on the blog call diplomacy webs and family trees a master feature. I was incredibly disappointed to spend so much time learning and researching about them only to find that when I went to use them they were a grandmaster+ feature. Please make this consistent.

Oct 10, 2020 17:30

1 has been fixed, thanks.   As for 2, these features are supposed to be Master+. Are you sure you don't see the Relationships/Diplomacy tabs specifically in the Character or Organization templates?

[they/them] Creator of Black Light, a science-fantasy universe.
Dec 21, 2020 17:44

I cannot find my diplomacy webs

Dec 21, 2020 22:18

What do you mean? You don't see a "Diplomacy" tab when editing an organization article?

[they/them] Creator of Black Light, a science-fantasy universe.
Dec 22, 2020 14:34

Yes, but I cannot find where the web is. I did all of the steps to make a web, but I can't find it.

Dec 22, 2020 18:55

To have the web display in the article you have to copy the BBCode tag you'll see in the "Diplomacy" tab. Paste it anywhere in the article and when you view it from the presentation view, it should be there.

[they/them] Creator of Black Light, a science-fantasy universe.
Dec 23, 2021 04:18

Is this Web also usable for character relationships instead of just diplmatic relationships?

Dec 23, 2021 22:17

It's integrated with the organization template, so only articles that use this template can use it.

[they/them] Creator of Black Light, a science-fantasy universe.
Aug 16, 2022 15:25 by Rachael Dixon


Sep 23, 2022 19:41

Could it be, that this feature doesnt work, when you save a custom template with the organization template as the base? I created two test organizations with the base template and it worked, but when I try it with my customs, I can manage the relations values etc., but nothing shows up after saving.

Sep 27, 2022 07:51

That is possible! Could you report this here: https://github.com/worldanvil/worldanvil-bug-tracker/issues? Thank you!

[they/them] Creator of Black Light, a science-fantasy universe.
Mar 19, 2023 19:40

In my Diplomacy Web, I can't get the articles to change to images of the Diplomatic units. They are all showing up as 'Worl Anvil' but with the Correct name of the organization

Mar 20, 2023 09:09

Images in a Diplomacy web are picked up from the organization article they link to. Use the Organization flag/crest field at the top right to select a representative image for that organization that will be displayed in the Diplomacy web.

[they/them] Creator of Black Light, a science-fantasy universe.
Sep 11, 2023 12:30

I saw that someone suggested adding the ability to include characters in diplomacy webs and that the suggestion was "accepted" last year. Has this functionality been added? If not, any idea as to when it will be?

Sep 12, 2023 08:33

Hi! I've found a suggestion for character webs, not for a web that can include both organizations and characters (I might have missed it though). In any case, the functionality has not been added and it will be a while until it is—it has very low priority compared to other projects we need to address first.

[they/them] Creator of Black Light, a science-fantasy universe.