The Image Tagging extension extracts the text from an image and outputs it into Roam! The name of the script is image-tagging.


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("image-tagging");
if (!existing) {
  var extension = document.createElement("script");
  extension.src = ""; = "image-tagging";
  extension.async = true;
  extension.type = "text/javascript";


The script supports the following configuration attributes, to be added in the [[roam/js/image-tagging]] page:

  • Trigger - (Optional) The action to do on an image to extract a text. Valid values include DOUBLE CLICK, SHIFT CLICK, and ICON CLICK. By default, it uses DOUBLE CLICK.

Double click on an image in your database. The extension will use an OCR library to extract all the text found in an image. In the meantime, it will insert a "Loading..." text as a child block. Once the extension finishes, it will replace the Loading text with all the new text it parsed from the image.

If the text begins with a bullet or dash on a line, the bullet will be stripped, leaving the rest of the text content.


Other Extensions