Skip to main content

Identity How-to Guides

This is an advanced guide that is relevant for entities that would like to become registrars or would like to set sub-identities to an existing account with an identity. The learn identity page provides information on how to set an identity and have it verified.


Becoming a Registrar

To become a registrar, submit a pre-image and proposal into Democracy, then wait for people to vote on it. For best results, write a post about your identity and intentions beforehand, and once the proposal is in the queue ask people to endorse it so that it gets ahead in the referendum queue.

Here's how to submit a proposal to become a registrar:

Go to the Democracy tab, select "Submit preimage", and input the information for this motion - notably which account you're nominating to be a registrar in the identity.setRegistrar function.

Setting a registrar

Copy the preimage hash. In the above image, that's 0x90a1b2f648fc4eaff4f236b9af9ead77c89ecac953225c5fafb069d27b7131b7. Submit the preimage by signing a transaction.

Next, select "Submit Proposal" and enter the previously copied preimage hash. The locked balance field needs to be at least

. You can find out the minimum by querying the chain state under Chain State -> Constants -> democracy -> minimumDeposit.

Submitting a proposal

At this point, DOT holders can endorse the motion. With enough endorsements, the motion will become a referendum, which is then voted on. If it passes, users will be able to request judgement from this registrar.

Setting Sub-Identity (Sub-ID) for your Ledger Account

Setting an Identity is not possible on Ledger app yet, but as a workaround, you can set the identity for an on-chain account and then use it to set a sub-identity to your Ledger account.

  • Go to Click on the three vertical dots correponding to the account to which you already set identity. You should see an option to set onchain sub-identities. Click on it.

    Add sub-identity in PolkadotJS

  • In the pop-up window, select your Ledger account from the dropdown and enter text in sub name field. Then, click on set subs button. Set sub-identity in PolkadotJS

  • Sign and submit the transaction from the parent account with the identity

You should now see the sub-identity displayed on-chain. You need to be aware that

is reserved for setting identity and
for each sub-identity. This reserved account balance is freed once you clear the identities on the account.

Sub-identity example