Content Linking and Mention System

Overview

Update by SoulLink
An integral part of worldbuilding is to create relationships between everything in the world. On World Anvil it is possible to link to any kind of resources with either the mention system or with a specific BBCode. The mention system also offers up a dropdown where suggestions are shown as you type.

Mentioning an Existing Article

This feature is available to everyone.
To link existing articles, just type an and then at least three letters of the title, of a tag or within the content of any article within the current world. Suggested articles with the word in the title or within a tag are ordered first. After that is a list of all the articles which contain these letters in the main content (vignette). The suggested list can display at most 100 articles, except in the legacy editor, which provides a much smaller list. Use a more specific word if your article does not appear at the top of the list.   The search for letters has some limitations.  
  • Spaces have to be replaced with an underscore ( _ ) character.
  • Characters that are not letters or numbers will not be matched.
  • It is not possible to match Cyrillic, Greek and other non-Latin characters.
  • Article with a title that only has one or two characters cannot be found via title (due to the three-letter minimum)
  Assign unique tags that you can search for in order to get around these limitations.  
Mentions

Mentioning a Non-Existing Article

This feature is available to everyone.
You can also link an article that hasn't been created yet. To do so, simply add the link as normal, typing the full name of the future article. After the article title, type its template name between (parenthesis). Like this:  
mentioning8.JPG
  The available templates are listed in the bbcode reference sidebar while editing an article, but they are:  
This only works for articles where you are the author. When someone else is the author, the link is not rendered and instead is just bold. Only the author can see and click on the article to create the corresponding article. The system does not take into consideration if you have the permission to do so.
 
  • Character (character) or (person)
  • Conflict (militaryconflict) or (conflict)
  • Document (document)
  • Ethnicity (ethnicity)
  • Military Formation (formation)
  • Geographic Location (location)
  • Generic Article (generic)
  • Item (item)
  • Language (language)
  • Law (law)
  • Settlement (settlement)
  • Building/Location (landmark)
  • Material (material)
  • Myth/Legend (myth) or (legend) or (prophecy)
  • Organization (organization)
  • Prose (prose)
  • Profession (profession)
  • Rank/Title (rank) or (title)
  • Spell (spell)
  • Species (species)
  • Technology (technology)
  • Tradition/Ritual (ritual) or (tradition)
  • Vehicle (vehicle)
 
This feature is available to all guild members.
  Note that when you save an article with a link that points to an uncreated article, the uncreated article will be added to the to-do list automatically.  

Linking Categories, Secrets, Maps, Images, Historical Events and Variables

This feature is available to all guild members.
  It is possible to get a suggestion for items other than articles by typing the character "[" instead of the . Then three or more letters of the title of the desired item. In this case, only the title is searched and not the content or the tags. The resources found are always listed grouped together by type in the following order: images, maps, events, categories (link & toc), secrets and variables.   The suggester returns 50 results at most.  
mention-system-guild-version.gif
 

Frequently Asked Questions

These are questions that come up regularly. If you feel something is missing please leave a comment or tell us on the Discord.

Can I change the display text of a link?

  Yes, the displayed text does not affect the actual link. Anything between the two square brackets can be changed to anything you wish.

Can I force a mention link to open in a new browser tab?

  No. You have to use the URL-BBCode with the open tab option
[url:https://link-to-article|tab]TEXT[/url]
However, in general the tab option should be avoided for internal links. This allows the user to decide whether to open a link in a new tab or not.

Can I make a mention link to target an anchor?

  No. You have to use the URL BBCode as well to do so:
[url:https://link-to-article#anchor-id]TEXT[/url]
Make sure to store these links in variables to make sure they can be updated.
Content

Other guides



Cover image: Photo by Gerd Altmann

Comments

Please Login in order to comment!
Dheran
Horatio Hornblower
30 Jul, 2019 18:28

Is there a way to provide alt name for article link? E.g. I want to link a character, but I want to use only the first name, or I want to link a organization (e.g. Kingdom of X) but I want to use X?

1 Aug, 2019 01:49

Yep, if you look at the first image you can see that I've written @world and gotten as a response at the top of the list "PatheticBarrel's World-Building Guide" Or did you mean something else?

Dheran
Horatio Hornblower
4 Aug, 2019 23:28

Hmm, what I mean is that I have an article about some Taric LeSample. But I want to mention him as Duke LeSample for example. How can I do that? Is it possible if the article is not created yet?

5 Aug, 2019 03:04

The mentioning system works on the title of the article. If you create an article for him and name it Taric LeSample and then when you want to link to him on his sister's article you write a @tar or @les and his article will appear in a list together with other articles with similar names. You click on his article and a string of text looking like this will appear:

tariclesample.JPG
and within the [ ] you can change it to anything. So you can change the Taric to Duke and then the link on his sister's article will say Duke LeSample and when a reader clicks the link it will still take the reader to the Taric LeSample article.   I hope I made sense and that this is what you wanted to know. Poke me again if it isn't XD;;

5 Aug, 2019 03:17

If you haven't created Taric's article yet but you are writing his sisters article and you want to mention him as Duke LeSample you just type (a)Duke LeSample(person) and this link will work when you create an article with that name. (if you click the link an you will automatically end up on an empty article with that name) If you are a Guild member the article will appear in the to-do-list and you can just change the title of the article later on when you have named him. If you aren't a guild member it's a lot easier to just create the article with the purple button and use the link that the button gives you and place it there and later rename the article. (it will still say Duke LeSample on his sister's article until you change it since the text within the [ ] is the name the article had when you linked it on that article. )

Dheran
Horatio Hornblower
6 Aug, 2019 20:06

Thanks mate, cheers!

7 Aug, 2019 03:53

Cheers :)

10 Oct, 2019 12:28

Is there a way to create a link in an article's title? For example, if I create an article with the title "Mr. Example goes for a walk", can I have Mr. Example be a link to that character?

11 Oct, 2019 18:44

Yes, if you write your article in the vignette.

warofgrimlink.PNG
(and if you mean the headers in the article)

18 Nov, 2019 17:30

Is it just me or Mentionning doesn't work anymore in the new Text Editor? I also tried to get back in Source code and didn't work either...

19 Nov, 2019 02:26

There can be bugs with the new text editor. If you're on the discord bring them up in the #alchemists-wysiswyg channel. Otherwise, you can take screencaps and report what browser you're using (the report a bug page can be reached on the bottom of all pages on the backend). If you don't mind using the old editor you can go to the Interface setting page and change to Legacy under the Editor selection header.

19 Dec, 2019 22:07

I believe we can't at-mention timelines, correct? Or at least not before the timeline exists? Do events in a timeline work in either case?

19 Dec, 2019 23:16

No, I don't think so. Articles and events (/timelines) run on different systems as far as I am aware.

Journeyman Tall Guy
Konstantinos Vasileiadis
11 May, 2021 10:44

Seems to be possible now via the "Links" section in the right part of the Historical Entry editing page, where you can copy and paste a url to include a link this event's page into any of your articles.

31 Dec, 2019 04:49

Is there a way to add links with the new update. Ever since they changed the layout of the type box I haven’t been able to link things by using the @ method. If someone could explain this it would be great :)

2 Jan, 2020 01:48

The new wysiwyg editor and the mentioning system isn't the best of friends yet. You can change it to the old editor if you would prefer the old ways. To change click on your avatar image in the top right corner, and then on "interface and accessibility" You'll get this page.

editor.jpg
Change to "Legacy" in the dropdown under "Editor Selection" and click save. Hope it helps :)

21 Jan, 2020 15:56

Hey all, I just joined, so apologies if this is covered somewhere else and I just haven't found it yet:   If you change that article name, will it update mentions of that article throughout your content? or does it break the links?   Thanks in advance!

22 Jan, 2020 02:47

Hey! Welcome! :)   The links will continue to work. However, if you change the name of an article the name won't change on the other pages. So for example; if you have an article Named "King Anvil" and have a mention on another article King Anvil ...If you change the name of the article to "Queen Anvil" then the link on the other pages will still say "King Anvil". It's like that so you can use different names for the same thing or make it fit more with what you are writing. ...I hope I made sense? XD   If you feel like it, you can also join the development discord https://discordapp.com/invite/WHuu4qH ...most of the community is over there and want to answer a lot of questions. :)

22 Jan, 2020 13:12

Thanks so much for the quick response!   Yes, that makes sense. Maybe one day we can get the option to update all mentions when you rename an article. For example, I have preliminary names for the continents of my world right now. It would awesome if in the future I decide to rename a continent and could just change the name of the article and it pushed that update to each mention.   I'll shoot on over to the discord and check that out soon. Thanks again!

22 Jan, 2020 13:12

Thanks so much for the quick response!   Yes, that makes sense. Maybe one day we can get the option to update all mentions when you rename an article. For example, I have preliminary names for the continents of my world right now. It would awesome if in the future I decide to rename a continent and could just change the name of the article and it pushed that update to each mention.   I'll shoot on over to the discord and check that out soon. Thanks again!

23 Jan, 2020 02:15

:)

27 Apr, 2020 19:15

Is there a way to put a hyperlink in an article to jump around the same article in different places

28 Apr, 2020 00:56

Do you mean anchors? Yes, there is, you'll have to use bbcode. While you're editing an article you can find the codes under the "WORLD ANVIL TAGS REFERENCE" tab in the right sidebar.  

anchorbbcode.jpg

Master Gandalfthe28th
Shayan Ghorbanian
7 Jun, 2020 16:47

Is there a way of combining Anchors and Hyperlinks? So a link to a specific header in another article?

8 Jun, 2020 01:02

Yes, but you'll have to do it manually. [url=WORLDURL/ArticleName#Header][h1]Header[/h1][/url]

Silent Seal
Set Saber
1 Jul, 2020 08:00

Hi there! I've got a question which I suspect might be quite foolish, but is necessary non the less: When using mentioning, the article sometimes shows a bold text instead of a link to the article. All articles are non-drafts WIPs, and most of those articles (if not all) possess working mentions in other articles, or sometimes even within the article itself. Does anyone have an idea what's going on? It's driving me mad

2 Jul, 2020 17:40

Hmmm~ weird, I think the bold text is only supposed to be for articles that aren't published. Might be some kind of a bug?

Silent Seal
Set Saber
3 Jul, 2020 10:32

maybe? it's fairly common though I mean, it happens in almost every article I'm trying to use mentions in. As far as I know the only case in which I could get this bug (?) to be fairly consistent is when mentioning the same article twice. Other than that, I got nothing. who should I go to if it is a bug? Because if it is, than probably more information is needed to solve it (at the very least links to articles as they are currently, the source code on my end and the mention link that is used, or at least so I would guess)

3 Jul, 2020 16:54

Yeah, but if the same mention link works in other articles I can't think of anything else that it can be. You can report the bug here; https://www.worldanvil.com/help/ Dimitris uses a third party program to sort and optimize his bugs and feature requests so you'll have to make a new account there.

Silent Seal
Set Saber
4 Jul, 2020 10:33

Will submit, thanks!

4 Jul, 2020 20:17

np! Thank you as well :)

22 Jul, 2020 10:26

Hey there, when I link an article in our world, no preview pops up when hovering with the mouse over the link. The linked article is published already. What could be the reason and how do I allow a linked article to be previewed?

22 Jul, 2020 15:19

You've added text in the excerpt?

22 Jul, 2020 22:17

No, I didn't, thank you so much. I thought, World Anvil would automatically show the first few sentences of my vignette. Anyway, now I know how to make it work!

22 Jul, 2020 23:54

Great! Nah, for the simple preview popups you can put any information that you want there. :)

24 Jul, 2020 23:00

Is it possible to get a list of articles which link to a given article? I've got some (duplicate) stubs I made by accident in early articles and want to track down where they were made.

24 Jul, 2020 23:27

No real way, but you can take the code (the string of code you get when you mention it) and go to your world's view page. Put the string of code in the search bar there and all articles that have that article mentioned in them will show up.

25 Jul, 2020 18:12

With the new article update today there is now a reference list on the editing of articles page so you can load all articles that reference the article that you are editing.

25 Jul, 2020 22:54

That's exactly what I wanted! Just a couple of days too early

25 Jul, 2020 23:07

:)

26 Jun, 2021 10:32

I'm looking for the reference list in article and am having no luck. Where at in the article do you see the the reference list? Does this feature requires a specific membership level?

26 Jun, 2021 22:42

Right sidebar, click "Open Advanced Tools & Options", and then click "Referenced in". I'm unsure if there is a specific membership level. I think it is available to all guild members but if you can't find it I'll ask.

27 Jun, 2021 10:09

Thanks for responding back so quickly. The only options I see under "Open Advanced Tools & Options" are: To-Do List Special Actions MetaData   I don't see the reference list in any of these dropdowns.

27 Jun, 2021 16:24

I've sent a dm to the developer. It's his day off today and tomorrow so we'll see when he has time to reply. :)

27 Jun, 2021 16:57

Got a reply, it's a Master+ feature. :/ ....I suppose it's because it pulls a lot of juice from the server to search through all articles in a world.

28 Jun, 2021 20:00

Thanks for following up.

29 Jun, 2021 00:21

np <3

4 Aug, 2020 01:48

Can I link a location article to one of my maps?

4 Aug, 2020 02:15

How do you mean? You can put a map in your location article by going to "Map settings" and copy-paste the bbcode in the "map embed snippet" dropdown in the right sidebar. While editing your maps you can also connect the article to the maps.

4 Aug, 2020 02:25

Okay, I discovered the latter. I will try the former. I'm not very computer savvy you see, most of my work is on thousands of hand-written pages. I will give it a shot. Thank you.

4 Aug, 2020 04:05

Okay :) I hope it works for you, if you have any other ideas for how you want it to be you can put in a feature request.

9 Aug, 2020 08:26

Hi.   My question is related to a function that is a mention between the map and the articles, but only this time the reverse way. Let me explain. Is it possible for a word to be linked to a pin on the map in the manner in which we use something but this creates and article, and what I need it to do is when this particular word is clicked, to take it up on the map to that exact Pin. Also it needs to stay on the same page, not open the map in a different one. I have my map as a background for the world and if that could be done it would be awesome.   Please share your opinion if it can be done and if yes, how exactly.   Thank you

9 Aug, 2020 22:07

Hello, As far as I know, it's not possible to link a word to a map pin since the pins only have locations on maps. You could ask Dimi to make it as a feature the next time he works on the map system.   You can suggest features over here: https://www.worldanvil.com/help/ It's a third party program so your WA login information won't work. You will have to get an account there. You'll only get emails from them if Dimi is asking about your request or if it's finished.   <3

15 Aug, 2020 01:12

Is there a way to link to a stat block WITHOUT the text being imported, ie, just a link to click to open in another window? I can't @ mention a statblock and when I copy the statblock ID to the article it pulls all the text.

15 Aug, 2020 02:57

I'm not good at the RPG side (I'm an author) but I think you should be able to do it like this

block.PNG

19 Aug, 2020 01:02

I don't seem to be able to link in articles that have diacritical marks in their name (example: Árdcnoc) while filling in the prompts on another article. Specifically, I am attempting to link a location article (Árdcnoc) to the 'current location' prompt on my new character article. Diacritics seems to be the issue. Is there a work-around?

22 Aug, 2020 01:26

Hello, sorry for the late reply, haven't had computer access for the last couple of days so haven't been able to try it out. But tested tonight and seems to work as well to type the last three letters. So for the example name Árdcnoc, it worked when I typed "noc". :)

22 Aug, 2020 16:39

Why did I not think of that? I feel very smart. Thank you.

22 Aug, 2020 22:43

<3 you were probably preoccupied with the worldbuilding. :3

29 Jan, 2021 03:12

If I'm running an RPG (D&D 5e), I'd like to create some links in my articles to player characters. Is that possible?

29 Jan, 2021 03:44

Yes, the mentioning system works in all articles.

29 Jan, 2021 23:45

Thank you!

30 Jan, 2021 04:08

No problem :)

Grandmaster nonplayer
N. Phillip Cole
6 Feb, 2021 21:14

Is it possible to link to Campaign components within a World? For example, something like "This event was fleshed out in the [Die Hard 37] campaign by the [Donner Party] during [Session 05]" or some such?

------ NPC of Breakfast Puppies / Alliterated Games (Bikers Dice & Bars, The Glitterbois, Have Movies Will Game, HAMMERCRAWL!, Motobushido)
8 Feb, 2021 02:53

I don't use the RPG features but people tell me that it's not possible. They say that campaigns do have a presentation page that you can link to, it's also possible to use session reports with the mentioning system.

10 May, 2021 11:22

I tried this but for some reason, it just doesn't work at all. What could be wrong?

11 May, 2021 00:35

What did you try?

14 May, 2021 20:15

How do i delete an map, timeline or generic link? I miss clicked and put the wrong mal, how do i erase?

14 May, 2021 22:05

What is a mal? With a regular link you just click backspace. If you’ve chosen something out of a drop down menu under the template specific prompts then just click the x next to it.

16 May, 2021 14:18

A wrong map* so i think i found a bug, on mobile i am unable to erase any type of link.

17 May, 2021 03:11

I don't know much about maps, you'll have to ask here: https://www.worldanvil.com/w/WorldAnvilCodex/a/maps Or on WorldAnvil's discord server: http://worldanvil.com/discord