Before you begin
- Connect the wallet that owns the parent ENS name.
- Activate the parent ENS name before offering its subnames through the widget.
- Decide which names and subnames visitors should be able to search and mint.
Choose the widget type
Create and embed the widget
1
Open Widgets
Visit app.namespace.ninja, connect your wallet, open the account menu, and select Widgets.
2
Create a widget
Create a widget and choose the type that matches the names you want visitors to search. For Selected Names or Single Selected Name, select the parent ENS names to include.
3
Choose whether to include ENS names
Enable Allow ENS Name Registrations if visitors should also be able to register second-level ENS names such as
example.eth.4
Save the configuration
Review the settings, click Update, and sign the gasless update request in your wallet.
5
Copy the integration code
Copy the generated integration code and paste it into the page where the registration experience should appear.
6
Test the registration flow
Open the published page, search for an available subname, and verify the displayed parent name, network, price, and wallet transaction before sharing the widget with users.
Next steps
Manage onchain subnames
Update the parent name’s pricing and minting rules in the Namespace App.
Build a custom minting site
Use the white-label starter when you need full control over the registration experience.

