Beneficial Ownership Data Standard - Development handbook

This repo contains work-in-progress documentation for people who are working on the Beneficial Ownership Data Standard. It is published on github pages to keep it lightweight and easy to update. The source files are at

To this repo you can add meta-documentation around updating the standard itself - workflows, processes, technical things and administrivia that you don’t want to be siloed inside your own organisation’s CRM or private wiki, but that don’t need to be seen by people who are only publishing or consuming data which conforms to the standard. Do check to make sure what you want to add wouldn’t be better suited to the docs of a particular tool.

If you add a new page, please follow the editing advice below, and list it under ‘Contents’ here.


It does not contain:

Running this site locally

The site uses jekyll (through github-pages) to turn these markdown files into html. You can do so locally too, to preview changes:

Editing this handbook

This Handbook is in English only (no translations).

Currently, there is no requirement for pull requests to be made - you can edit content on the main branch directly. Later, that will change to a strict requirement to always use pull requests.

Previewing work you have done

If you want to preview work before pushing it live, create a new branch in Git. Go to the GitHub UI, select the file you want to see and a preview is shown.

But be aware; there are some differences between this preview and the real docs on GitHub pages. These are:

If you just put a link in some text like this:

Please go to

It will appear as a clickable link in the preview but NOT in github pages. To make the link clickable in Github pages, use angle bracket markdown:

Please go to <>

Or use the bracket notation:

Please go to [](

Or more readable-

Please go to [](