The Page Synonyms extension allows you to define synonyms for pages to allow for easier referencing between common terms.


You could use the Copy Extension button below to individually install this extension. To install, just paste anywhere in your Roam graph and click "Yes, I Know What I'm Doing".

Manual Installation

If instead you prefer to manually install, first create a block with the text {{[[roam/js]]}} on any page in your Roam DB. Then, copy and paste this code block as a child of the block.

var existing = document.getElementById("roamjs-page-synonyms");
if (!existing) {
  var extension = document.createElement("script");
  extension.src = ""; = "roamjs-page-synonyms";
  extension.async = true;
  extension.type = "text/javascript";


This extension adds a new option to block context menus that says "Alias Page Synonyms". Right click a block and click on the option to replace all text in the block with a reference to its defined alias. To define aliases, go to the page and add an Aliases attribute. All values should be comma delimited.

For example, to have Tasks and task alias back to Task, create an Aliases attribute on the Task page. The page should have a block that displays Aliases:: Tasks, task.

The extension also works for selecting multiple blocks. When you highlight and right click multiple selected blocks, the "Alias Page Synonyms" will appear and perform the same operation as described above.

Note that the extension does a simple search and replace. That means if aliases are nested in other words or already have links, it will still replace the instance with a new link.

PS! By default, the extensions replace synonyms using the [synonym](((page-uid))) format. To use tags instead, add a block that says "Use Tags" in the [[roam/js/page-synonyms]] page. Roam may crash for some using the [synonym](((page-uid))) format but will work through tags.



This extension is brought to you by RoamJS! If you are facing any issues reach out to or click on the chat button on the bottom right. If you get value from using this extension, consider sponsoring RoamJS by clicking on the button below!


Add your email below to stay up to date on all RoamJS features, fixes, and news!

Other Extensions