How to import a JSON rBook into Roam

If you are importing an EDN, please see this instead: How to import an EDN rBook into Roam

JSON vs EDN

You can import a JSON file to an existing graph. EDN will overwrite a graph.

If you import another JSON in the future with identical blocks as a previously imported one (eg, an update of the rBook) all blocks from the old JSON must be deleted for the new import to work.

With JSON, diagrams that use {{diagram}} will lose their spatial ordering (eg, in Appendix 1 in the Professional Project Management with Roam v1.0)

For Professional Project Management with Roam v1.0, there will be some minor block references that are not included in the JSON file.

Steps

(This guide was made on August 2021. The user interface may be different if you are reading this far into the future.)

Unzip the rBook JSON

Go to RoamResearch.com and Sign-in/Sign-up

https://gyazo.com/4d00b764b968a1135d0cdb4b81966d90

Under the three dot menu, select Import Files

https://gyazo.com/8c6158acd55bab7276dcf3916f576635

Select the unzipped JSON file. It will look like this:

https://gyazo.com/cfed19c5d899a293eb5ed0c4fb0b5925

After import, a report like the one below will be shown in today's Daily Notes. A good place to start is the Prologue.

https://gyazo.com/f235b9573d167231760d2daf1e172782