diff --git a/.github/github-on-chain-identity-process.jpg b/.github/github-on-chain-identity-process.jpg
new file mode 100644
index 0000000..18882e9
Binary files /dev/null and b/.github/github-on-chain-identity-process.jpg differ
diff --git a/README.md b/README.md
index 01e2411..1714bfb 100644
--- a/README.md
+++ b/README.md
@@ -46,6 +46,14 @@ They are:
 - `github-handles`: All the fellows handles separated by commas
 	- Example: `user-1,user-2,user-3`
 
+## Adding github account to your on-chain identity
+
+Adding the github account to your identity requires the usage of the `additional` fields in the identity info. This is currently only supported by using the [polkadot-js bare extrinsic interface](https://polkadot.js.org/apps/?rpc=wss%3A%2F%2Frpc.polkadot.io#/extrinsics). See the following image for an example:
+
+![Add github name to the additional fields of the on-chain identity](.github/github-on-chain-identity-process.jpg)
+
+You should also at least add the `display` field. If you want to add `utf8` characters, you need to hex encode them and put the hex string (`0x` prefixed) into the field.
+
 ## Deployment
 
 To deploy a new version you need to update two files: