The Page Synonyms extension allows you to define synonyms for pages to allow for easier referencing between common terms. The name of the script is page-synonyms.


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("page-synonyms");
if (!existing) {
  var extension = document.createElement("script");
  extension.src = ""; = "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.

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.


Other Extensions