The introduction of document-level property drawers (commit 1bdff9f73dc1e7ff625a90e3e61350bdea99f29c from May 2019) introduced inconsistencies in the behavior of org-id and org-store-link.
If org-id-link-to-org-use-id is set to t or 'create-if-interactive, calling org-store-link above the first headline in an org file will insert a PROPERTY drawer and an ID at top of the file, so that the file (call it "~/test.org") looks like this: --8<---------------cut here---------------start------------->8--- :PROPERTIES: :ID: 1f43e860-9e7b-4c8f-82b9-6ed3352e589f :END: * First headline --8<---------------cut here---------------end--------------->8--- However, the link that Org actually stores is "[[file:~/test.org]]", so the ID is irrelevant. In addition, a link to a document-level ID does not work. Following "[[id:1f43e860-9e7b-4c8f-82b9-6ed3352e589f]]" results in this error: user-error: Before first headline at position 14 in buffer test.org So either: 1. org-id and org-store-link/org-open-link should support document level ids in a user-configurable way, or 2. org-id-get-create should detect whether it is above the first heading and should not create an id Option #2 would obviously be the easier fix. Gustav: were IDs within the scope of your initial thinking about document level properties? Or are these largely irrelevant? Best, Matt
