Skip to main content
To mint subnames from the Namespace App, ENS Widget, or via the SDK, you must first activate your ENS name from the Onchain section of the Namespace App.
Names activated on Ethereum L1 cannot be migrated to Namechain (ENS v2). If you plan to use Namechain, activate on a supported L2 (Base or Optimism) instead.

How to Activate an ENS Name

1

Open the Onchain section

  1. Visit app.namespace.ninja/onchain.
  2. Connect the wallet that owns the ENS name you want to activate.
  3. Select your ENS name from the dropdown at the top, then click Activate Name.
Onchain Subnames page with ENS name selected and Activate Name button
2

Choose the listing type

Pick where subnames will be issued:
  • L1 ENS Subnames — issue original ENS subnames on Ethereum mainnet.
  • L2 ENS Subnames — issue subnames on a supported L2 chain (Base or Optimism). Pick the network from the “Select Subname Network” dropdown.
Click Next.Choose between L1 and L2 ENS Subnames
3

Setup — base activation properties

Configure the collection:
  • Currency — the token mint fees are collected in (e.g. ETH or USD).
  • Treasury Address — wallet that receives mint revenue.
  • Name and Symbol — collection metadata.
  • Burnable — allow subname holders to burn their subname.
  • Renting — allow time-bound subname rentals.
Setup tab — currency, treasury, name, symbol, burnable, renting
4

Prices — mint pricing rules

Set how subnames are priced:
  • Base Price — default price for every subname. Set to 0 to make subnames free.
  • Prices by length — override price for specific subname lengths (e.g. 3-char names cost more).
  • Special Name Pricing — custom rules for emoji-only, numbers-only, or other patterns.
Prices tab — base price, length-based pricing, special name pricing
5

Reservations — block or specially price specific subnames (optional)

Reserve subnames so they either cannot be minted at all (set Mintable off → “No Mint”) or are minted at a specific price different from your base rules.Add reservations one-by-one or bulk-import via CSV.Reservations tab — reserve subnames with no-mint or special pricing
6

Deadline — set a minting cutoff (optional)

Toggle Use Deadline to make the collection time-bound. After the chosen date, no new subnames can be minted.Deadline tab — set a minting expiry date
7

Whitelist — restrict who can mint (optional)

Toggle Use Whitelisting to gate minting by wallet address. Two modes:
  • Can mint only if whitelisted — restrict minting to listed wallets.
  • If whitelisted, can mint for free — allowlisted wallets bypass the mint fee.
Add addresses or ENS names one-by-one.Whitelist tab — restrict minting or grant free mints to specific addresses
8

Token Gated — require token holdings (optional)

Toggle Use Token Gated Listing to require that minters hold a specific token:
  • Standard — ERC-20 or ERC-721.
  • Token Address — contract address of the gating token.
  • Subname Network — the chain the token lives on.
  • Minimum Amount Required — minimum balance the wallet must hold to be eligible.
Token Gated tab — gate minting behind ERC-20 or ERC-721 holdings
9

Activate the listing

Once all tabs are configured, click Activate. Sign the transaction in your wallet.
L1 activation also requires wrapping your ENS name into a NameWrapper-compatible name. The app prompts for this wrap transaction automatically. This step is skipped for L2 activations.
10

Deploy Registry

After activation, the app shows a “Few more steps before you can list your name” screen with two actions.Click Deploy Registry to deploy the Registry Contract on the selected L2 chain. This contract holds all subnames issued under your name.Few more steps — Deploy Registry and Configure Resolver
11

Configure Resolver

Click Configure Resolver to point your ENS name’s resolver at the Namespace Hybrid Resolver. This is what makes subnames resolvable across the entire Web3 ecosystem.Confirm the transaction in your wallet.Configure Resolver — confirm transaction in wallet
12

Finish Activation

Click Finish Activation. Your ENS name now shows an Activated badge, and you can start minting subnames from the same page or via the SDK / widget.Activated ENS name with minted subnames listed
You can revisit any tab later via Edit Activation — pricing, reservations, deadline, whitelist, and token gating can all be updated after activation.

Next Steps

Your ENS name is now activated and ready for subname minting. Choose how to get started:

Namespace App

Mint subnames directly from the Namespace App.

Embed ENS Widget

Embed a widget in your app to let users mint subnames.

Subpages

Launch a branded minting site quickly using our ready-made template.

Mint L1/L2 Guide

Learn best practices for minting subnames on L1 and L2.
For advanced automation or custom flows, explore the Mint Manager SDK.