Skip to main content
Create ENS subnames under a name you own in the Namespace App. Namespace stores these subnames and their records offchain. They are not minted as onchain NFTs. ENS clients resolve their records through CCIP Read. Creating, editing, and deleting offchain subnames and their records is free. These actions require no blockchain transactions or gas fees.

​
What you can do

  • Create, edit, and delete subnames under your ENS name.
  • Set EVM and non-EVM addresses, profile and social text records, and a content hash.
  • Index subnames by their optional owner address.
  • Manage subnames in the app or automate through the SDK and API.
Namespace Developer Portal introduction with subname, record, and API-key management tools

​
Configure the resolver

Set the parent ENS name to use the Namespace Hybrid Resolver. This initial setup requires an onchain transaction and gas fees. Skip this section if resolution is already configured.
1

Select your parent name

Connect the wallet that owns the ENS name. In Offchain, select the name and open Resolution.
2

Update the resolver

Click Update resolver and confirm in your wallet. Skip this step if it shows Updated.
Resolution tab with Update resolver and Configure buttons for the selected parent name
3

Configure offchain resolution

Click Configure and complete the wallet prompts. Check that the status reads Configured.
Resolution setup completed with Updated and Configured statuses

​
Create and manage subnames

1

Open the creation form

Select the parent name in Subnames, then click Mint subname.
Subnames tab with a parent ENS name selected and the Mint subname button
2

Create a subname

Enter a label, such as happy, and check availability.Owner Address is optional and can be used for indexing subnames by owner.Add records through Complete your profile, or add them later. Click Create.
Create subname dialog with an available label, optional owner address, Complete your profile, and Create button
3

Edit the subname's records

Click the subname’s pencil icon. Edit its address, text, or content hash records, then click Save.
Addresses editor with Ethereum and Base records, additional chain options, and the Save button
To delete a subname, click its trash icon.

​
Create an API key

API keys are required for SDK and API access, not for using the app.

Create an API key

Open API Keys in the Namespace App.
1

Open API Keys

Select the parent name, open API Keys, and click Create new key.
API Keys tab with the Create new key button and a reminder to save keys securely
2

Set the key's expiry and scope

Enter a key name, set an expiry date, and choose a scope:Email is optional. Click Create.
Complete API key screen with key name, expiry, scope options, optional email field, and Create and Cancel buttons
3

Copy and store the key

Store the key in a server-side environment variable or secret store. Never expose it in browser code or public repositories.Copy it before it disappears from the browser after about 24 hours. The key remains valid until its expiry date or revocation.
Limit: 2,000 subnames per parent name. For a higher limit, contact the Builders group.

​
Next steps

Integrate offchain subnames

Create and query subnames with the SDK.

Troubleshoot resolution

Fix name and record lookup failures.