Register user
Register users in the identity registry for compliance tracking and token eligibility.
This guide explains how to register users in the identity registry - a required step for compliance tracking and token eligibility.
Prerequisites
- Identity Manager role or equivalent permissions
- Users must have completed onboarding with on-chain identity
- Understanding of user jurisdiction requirements
About identity registry
The identity registry is an on-chain system that:
- Tracks all verified identities for your organization
- Links wallet addresses to identity contracts
- Enforces jurisdictional rules
Identity states
| State | Description | Can receive assets |
|---|---|---|
| Pending Registration | Onboarded but not in registry | No |
| Registered | In registry, awaiting verification | Depends on rules |
| Verified | Has required verifications | Yes |
Registering users
Access user management
Navigate to Participants > Users. You'll see all users with their name, email, EOA (wallet address), type, identity address, and status.
Select unregistered user
Find and click on a user you want to register. The user details page shows their information, identity contract details, current registration status, and available actions.

Initiate registration
Click Register Identity (top right button) to begin the registration process. This opens the registration flow.
Select jurisdiction
Choose the user's country from the dropdown. Jurisdiction determines applicable regulatory requirements, compliance rules, investment limits, and verification requirements.
Jurisdiction importance
Country selection can be used in compliance rules but doesn't automatically apply specific rules. Choose based on user's legal residence or incorporation, not temporary location.
Complete registration
Click Continue after selecting jurisdiction, review the summary, then click Register identity. Enter your PIN when prompted and wait for blockchain confirmation. The registry contract adds the user's identity to the registry and links it to their wallet address.
Verify registration
After transaction confirmation, the user status changes to "Registered". The user is now in the identity registry and ready to receive verifications.
Best practices
Enrollment timing
- Enroll users promptly after onboarding completion
- Verify user information before enrollment
- Document enrollment decisions for audit
Jurisdiction selection
- Use user's legal residence or incorporation
- Verify jurisdiction through documentation
- Consider tax and regulatory implications
- Update if user's status changes
Security considerations
- Verify identity before enrollment
- Monitor for duplicate enrollments
- Audit enrollment activities
- Maintain enrollment records
Integration with compliance
Token transfers
- Enrolled identities can receive assets (with proper verifications)
- Non-enrolled identities are blocked from asset transactions
- Different assets may have different enrollment requirements
Compliance modules
- Identity verification module checks registry enrollment
- Transfer restrictions enforce enrollment requirements
- Compliance reporting tracks enrolled vs. non-enrolled users
Verification process
- Enrollment is prerequisite for issuing verifications
- Verifications can only be added to enrolled identities
- Multiple verifications can be issued per enrolled identity
Troubleshooting
| Issue | Solution |
|---|---|
| Cannot see Register button | • Verify you have Identity Manager role • Check user has completed onboarding • Ensure user has on-chain identity |
| Registration transaction fails | • Check wallet has sufficient gas • Verify correct user is selected • Ensure network connectivity |
| User still shows as Pending | • Wait for blockchain confirmation • Refresh the page • Check transaction was successful |
| Cannot select jurisdiction | • Ensure valid country is available • Check compliance settings • Verify no existing registration |
Related guides
- User Onboarding - Understanding identity creation
- Provide KYC Data - How users complete their KYC profile
- Manage KYC Data - Review KYC submissions before registration
- Verify KYC - Issue verifications after enrollment
- Configure Trusted Issuers - Set up verification framework
- Compliance Overview - Complete compliance reference
Provide KYC data
Complete your KYC profile with personal information and supporting documents to enable identity verification and asset transactions.
Compliance overview
Compliance modules enforce on-chain rules for your tokenized assets. Learn about available modules and how to configure them during asset creation.