"So if I understand correctly, unfolding one level would embed the referenced documents in the result one level down, two would also embed the documents referen

"So if I understand correctly, unfolding one level would embed the referenced documents in the result one level down, two would also embed the documents referenced in the root document's referenced documents, etc." That's correct. "I think it's definitely worth supporting differing depths of reference embedding along different paths." Yeah, path unfoldings were something we were thinking about but ended up on our very tall stack of things we want to do. You can generally get around it just by calling the get_document API on the client end from javascript, although it is true this will be much slower.