> ## Documentation Index
> Fetch the complete documentation index at: https://docs.namespace.ninja/llms.txt
> Use this file to discover all available pages before exploring further.

# Onchain subnames

> Activate an ENS name and issue onchain subnames on Ethereum.

Activate your ENS name in the [Namespace App](https://app.namespace.ninja) to let people mint subnames under it on Ethereum (L1). Each subname is minted onchain and owned by the wallet that mints it. You set the price, the rules, and who can mint, then confirm in your wallet.

New activations need an ENSv2 name. Listings on ENSv1 names keep working and can still be edited, but they stay on ENSv1. Pick the tab that matches your name.

> [tab] ENSv2
>
> > [!WARNING]
> >
> > Onchain subname issuing on ENSv2 names is paused for now. Offchain subnames, ENSv1 listings, and everything else keep working.
>
> ## Before you begin
>
> * Connect the wallet that owns the parent ENS name.
> * Pick a name tagged `v2`. The name picker greys out ENSv1 names.
> * Keep some ETH in the wallet to pay network fees for the activation transaction.
> * Decide on a base price and how payouts should be split.
>
> ## Activate your ENS name
>
> **1. Select your name**
>
> In the sidebar, open **Onchain subnames** and then **ENSv2**. Pick the name from **Search your names**.
>
> ![Onchain subnames page with the name picker open, listing an ENSv1 name tagged v1 and onchin.eth tagged v2](https://mintcdn.com/namespace-1f56cc70/tvIySIkR53T1CXjA/assets/onchain/activate-select-name.png?fit=max\&auto=format\&n=tvIySIkR53T1CXjA\&q=85\&s=769d9bdd8b09283096f0659ad1111868)
>
> **2. Start the activation**
>
> The page shows **Name not activated** for a name without a listing. Click **Activate**.
>
> ![onchin.eth selected with a Name not activated message and the Activate button](https://mintcdn.com/namespace-1f56cc70/tvIySIkR53T1CXjA/assets/onchain/activate-name-not-activated.png?fit=max\&auto=format\&n=tvIySIkR53T1CXjA\&q=85\&s=3df2b1cf1d390b4f6f743977cc9b5eaf)
>
> **3. Choose Mainnet subnames**
>
> Select **Mainnet subnames**, which places subnames on Ethereum in the ENSv2 registry. Click **Next**.
>
> ![Where should subnames of onchin.eth live, with Mainnet subnames selected and the Next button](https://mintcdn.com/namespace-1f56cc70/tvIySIkR53T1CXjA/assets/onchain/activate-choose-mainnet.png?fit=max\&auto=format\&n=tvIySIkR53T1CXjA\&q=85\&s=ccffbb40be6c070395ee128b2bdebfd7)
>
> **4. Set up expiration, base price, and payout**
>
> On the **Setup** tab, choose an expiration mode:
>
> * **Permanent**: subnames are paid for once.
> * **Expirable**: subnames are rented for a chosen duration and renewed to keep. The base price is charged per year.
>
> Enter the **Base price** in dollars. It applies when no other price rule matches. Minters pay in USDC or DAI. Under **Payout**, keep **100% to owner** or choose **Split payment**.
>
> Type a label into **Price check** on the right to see what it would cost under your current rules.
>
> ![Setup tab with Expirable selected, a base price of 1 dollar per year, 100% to owner payout, and the Price check panel showing 1 dollar per year for alice](https://mintcdn.com/namespace-1f56cc70/tvIySIkR53T1CXjA/assets/onchain/configure-setup.png?fit=max\&auto=format\&n=tvIySIkR53T1CXjA\&q=85\&s=5f2cd567de2c33763b2faa07d64cbe2a)
>
> **5. Add optional rules**
>
> Add pricing tiers and minting restrictions on the other tabs, or skip them. See [Configure pricing and rules](#configure-pricing-and-rules).
>
> **6. Review the listing**
>
> Click **Review**. The summary lists each section with its settings. Click a section to change it, then click **Deploy**.
>
> ![Review screen summarizing Setup, Prices, Reservations, Mint window, Whitelist, Token gated, and Other, each marked OK, with the Deploy button](https://mintcdn.com/namespace-1f56cc70/tvIySIkR53T1CXjA/assets/onchain/activate-review.png?fit=max\&auto=format\&n=tvIySIkR53T1CXjA\&q=85\&s=39a3d36d9a315c3dfcef8b6ac484d96f)
>
> **7. Activate and confirm in your wallet**
>
> The app lists the activation steps:
>
> 1. **Set up subname registry** deploys the registry that holds your name's subnames. You own it.
> 2. **Allow Namespace to mint subnames** lets Namespace's subname issuer register and renew subnames in that registry.
> 3. **Save activation** saves your pricing, rules, and payment settings.
>
> Click **Activate** and confirm in your wallet.
>
> ![Activation steps Set up subname registry, Allow Namespace to mint subnames, and Save activation, each marked Bundled, with the Activate button](https://mintcdn.com/namespace-1f56cc70/tvIySIkR53T1CXjA/assets/onchain/activate-confirm-steps.png?fit=max\&auto=format\&n=tvIySIkR53T1CXjA\&q=85\&s=0b1539c6aa4402597ab684bf8175b1ab)
>
> **8. Finish the activation**
>
> When all three steps show **Confirmed**, the app shows that your name is activated. Click **Done**. People can now mint subnames of your name.
>
> ![Confirmation dialog saying onchin.eth is activated and people can start minting subnames, with all three steps marked Confirmed](https://mintcdn.com/namespace-1f56cc70/tvIySIkR53T1CXjA/assets/onchain/activate-success.png?fit=max\&auto=format\&n=tvIySIkR53T1CXjA\&q=85\&s=54d95589aa39689e6a9fefb530227e02)
>
> ## Configure pricing and rules
>
> Every tab after **Setup** is optional. Turn a rule on with the toggle at the top of its tab. Tabs you skip stay marked **OFF**. Use **Price check** to see what a label costs as you change the rules.
>
> ### Prices
>
> A label's price comes from up to three rules that work together. Only the base price is required:
>
> * **Base price**: set on **Setup**. Applies when no other rule matches the label.
> * **Label length pricing**: a price per year for labels of an exact length. Click **Add length tier**, then enter the number of characters and the price, such as $50 for 1 character, $20 for 2, and \$10 for 3.
> * **Character-class pricing**: one price for labels made only of letters (**Letters only**) and one for labels made only of numbers (**Numbers only**). Labels that mix letters and numbers match neither.
>
> Length and character-class pricing each have their own toggle. A [reservation](#reservations) overrides all of them.
>
> ![Prices tab with label length pricing at 50, 20, and 10 dollars per year for one, two, and three characters, and character-class pricing at 5 dollars for letters only and 2 dollars for numbers only](https://mintcdn.com/namespace-1f56cc70/tvIySIkR53T1CXjA/assets/onchain/configure-prices.png?fit=max\&auto=format\&n=tvIySIkR53T1CXjA\&q=85\&s=0afaabe975220b37c36233d748fdab21)
>
> ### Reservations
>
> Block specific labels or give them a custom price. Reservations override every other rule.
>
> * Click **Add reserved label** and enter the label.
> * **Blocked**: nobody can mint it.
> * **Priced**: it can be minted at the price you enter.
>
> ![Reservations tab with admin and token blocked and degen priced at 100 dollars](https://mintcdn.com/namespace-1f56cc70/tvIySIkR53T1CXjA/assets/onchain/configure-reservations.png?fit=max\&auto=format\&n=tvIySIkR53T1CXjA\&q=85\&s=17eb8eb4e0f786b7d7edfd45a11c89b7)
>
> ### Mint window
>
> Allow minting only between two dates.
>
> * **Opens at**: when minting starts.
> * **Closes at**: when minting stops.
> * Leave either one empty for an open start or end.
>
> ![Mint window tab with opening and closing dates set three days apart](https://mintcdn.com/namespace-1f56cc70/tvIySIkR53T1CXjA/assets/onchain/configure-mint-window.png?fit=max\&auto=format\&n=tvIySIkR53T1CXjA\&q=85\&s=8cbf9e236a5d3dc013380189b1d2a560)
>
> ### Whitelist
>
> Limit minting to listed wallets, or let them mint for free.
>
> * **Allowed addresses**: click **Add address** for each wallet.
> * **Gate**: only listed wallets can mint.
> * **Free mint**: anyone can mint, and listed wallets pay nothing.
>
> ![Whitelist tab in Free mint mode with three allowed addresses](https://mintcdn.com/namespace-1f56cc70/tvIySIkR53T1CXjA/assets/onchain/configure-whitelist.png?fit=max\&auto=format\&n=tvIySIkR53T1CXjA\&q=85\&s=5d87dc24d1e12777b05bb209cde74df9)
>
> ### Token gated
>
> Let only wallets that hold specific tokens mint.
>
> * **Standard**: ERC721, ERC1155, or ERC20.
> * **Contract** and **Min. held**: the token's contract address and the minimum balance a minter needs. Click **Add token** to add another.
> * **Combine with**: **All of them** requires every listed token. **Any one** requires just one.
>
> ![Token gated tab with Any one selected, an ERC20 token requiring at least 200 held, an ERC721 token requiring at least 1, and the Add token button](https://mintcdn.com/namespace-1f56cc70/tvIySIkR53T1CXjA/assets/onchain/configure-token-gated.png?fit=max\&auto=format\&n=tvIySIkR53T1CXjA\&q=85\&s=ade1544b6d176f9e18da63a0f4e99cb2)
>
> ### Other settings
>
> Set the resolver for new subnames and what their owners can do after minting.
>
> * **Use a custom resolver**: registers every subname with your resolver, whatever resolver the minting app asks for.
> * **Owner permissions**, **Default**: owners can set a resolver, create subnames under their subname, and transfer it. **Renew** and **Unregister** stay off.
> * **Owner permissions**, **Custom**: change any of these. Unregister permanently destroys the subname and frees the label for anyone to mint, so it's usually left off.
>
> ![Other settings tab with the custom resolver off and default owner permissions: set resolver, create subnames, and transfer on; renew and unregister off](https://mintcdn.com/namespace-1f56cc70/tvIySIkR53T1CXjA/assets/onchain/configure-other-settings.png?fit=max\&auto=format\&n=tvIySIkR53T1CXjA\&q=85\&s=cdde4227b488143f2e92c40975ac5caf)
>
> ## Mint a subname
>
> After activation, anyone can mint a subname from your name's page in the Namespace App or through [Namespace search](https://docs.namespace.ninja/user-guide/app/search-register.md). Minting one yourself is a quick way to check the listing.
>
> **1. Search for a label**
>
> On the name's page, type a label under **Find your perfect subname**. The app shows whether the subname is available and its price. Click **Mint**.
>
> ![Find your perfect subname search showing happy.onchin.eth is available for free on Ethereum, with the Mint button](https://mintcdn.com/namespace-1f56cc70/tvIySIkR53T1CXjA/assets/onchain/mint-search-subname.png?fit=max\&auto=format\&n=tvIySIkR53T1CXjA\&q=85\&s=9efba585fc13cd570ce92409f89477d2)
>
> **2. Choose a duration and review the total**
>
> For an expirable listing, set the duration in years. The dialog shows the price, estimated network fees, and the total.
>
> ![Mint dialog for happy.onchin.eth with a 1 year duration, a free price, estimated network fees in ETH, and Mint and Cancel buttons](https://mintcdn.com/namespace-1f56cc70/tvIySIkR53T1CXjA/assets/onchain/mint-subname-dialog.png?fit=max\&auto=format\&n=tvIySIkR53T1CXjA\&q=85\&s=bf0ef135cd84b731d75996080bbcb363)
>
> **3. Add profile records**
>
> Optionally, open **Complete your profile** to add an avatar, nickname, short bio, social accounts, addresses, a website, or custom records. Click **Save**, then click **Mint** and confirm in your wallet.
>
> ![Profile editor with an uploaded avatar, nickname, and short bio on the General tab, plus Social, Addresses, Website, and Custom tabs](https://mintcdn.com/namespace-1f56cc70/tvIySIkR53T1CXjA/assets/onchain/mint-complete-profile.png?fit=max\&auto=format\&n=tvIySIkR53T1CXjA\&q=85\&s=8bc5816c16c6af4a6f50c4cbeb5721ba)
>
> **4. Confirm the mint**
>
> When the transaction confirms, the dialog shows the minted subname, mint price, and transaction fees, with a link to Etherscan.
>
> ![Minted confirmation for happy.onchin.eth with mint price, transaction fees, total, View Name, and Mint Another](https://mintcdn.com/namespace-1f56cc70/tvIySIkR53T1CXjA/assets/onchain/mint-success.png?fit=max\&auto=format\&n=tvIySIkR53T1CXjA\&q=85\&s=3153aad4b1134eb40ced98e231fb3a9f)
>
> The subname resolves like any other ENS name, with the owner, expiry, and records you set.
>
> ![happy.onchin.eth in the ENS app with its owner, expiry date, avatar, nickname, bio, Ethereum address, and X account](https://mintcdn.com/namespace-1f56cc70/tvIySIkR53T1CXjA/assets/onchain/verify-ens-app.png?fit=max\&auto=format\&n=tvIySIkR53T1CXjA\&q=85\&s=c55bbeefff50c7b0dd673d6268bfa9dc)
>
> ## Manage onchain subnames
>
> The name's page lists every minted subname with its expiry date. Search the list or switch between grid and list views. Labels that are already minted show as taken in the search.
>
> ![onchin.eth page with one minted subname, happy.onchin.eth, its expiry date, and the search showing happy.onchin.eth is already taken](https://mintcdn.com/namespace-1f56cc70/tvIySIkR53T1CXjA/assets/onchain/manage-subnames-list.png?fit=max\&auto=format\&n=tvIySIkR53T1CXjA\&q=85\&s=26fdd9731fa85ed6779b959333fe3eb3)

> [tab] ENSv1 (deprecated)
>
> > [!WARNING]
> >
> > The ENSv1 onchain flow is deprecated. Use this tab only to manage an existing ENSv1 listing. To activate a new name, use the **ENSv2** tab.
>
> ## How ENSv1 listings work
>
> ENSv1 listings issue subnames on Ethereum (L1) or on an L2 network such as Base or Optimism. Subnames already minted on Base and Optimism keep resolving.
>
> | Model | Issuance cost | Ownership |
> | - | - | - |
> | L1 | Ethereum transaction and mint price | The minted subname is held by its owner |
> | L2 | L2 transaction and mint price | The minted subname is held by its owner |
>
> ## Edit an ENSv1 listing
>
> **1. Open the listing**
>
> Open **Onchain subnames** > **ENSv1**, connect the owner wallet, and select the activated name.
>
> **2. Click Edit Activation**
>
> Click **Edit Activation** to change pricing, reservations, deadlines, allowlists, or token-gating rules. Each tab has an **Update** button that saves that tab's changes.
>
> ![Prices tab of an ENSv1 listing with a base price in ETH and prices by label length for three- and four-character labels](https://mintcdn.com/namespace-1f56cc70/3A9Yy6VPLxpgOcjQ/assets/activate-ens-name-4.png?fit=max\&auto=format\&n=3A9Yy6VPLxpgOcjQ\&q=85\&s=fe3b5010c5dfa244cd187d66560fbd14)
>
> **3. Confirm the transaction**
>
> Confirm the update in your wallet.
>
> > [!TIP]
> >
> > Review every transaction carefully. Some ENS fuse changes on wrapped names can't be undone.
>
> ### Listing settings
>
> * **Setup**: currency, treasury address, collection name and symbol, and whether subnames can be burned or rented.
> * **Prices**: the base mint price, prices by label length, and special-name pricing.
> * **Reservations**: block names or give them a custom price.
> * **Deadline**: stop minting after a date.
> * **Whitelist**: let only listed wallets mint, or let them mint for free.
> * **Token Gated**: require minters to hold an ERC-20 or ERC-721 token.
>
> ![Deadline tab with Use Deadline on and minting set to end in three months](https://mintcdn.com/namespace-1f56cc70/3A9Yy6VPLxpgOcjQ/assets/activate-ens-name-6.png?fit=max\&auto=format\&n=3A9Yy6VPLxpgOcjQ\&q=85\&s=4052fe08a9e7dd2f445a73241e4e54b8)
>
> ![Whitelisting tab with Can mint only if whitelisted on and two allowed wallet addresses](https://mintcdn.com/namespace-1f56cc70/3A9Yy6VPLxpgOcjQ/assets/activate-ens-name-7.png?fit=max\&auto=format\&n=3A9Yy6VPLxpgOcjQ\&q=85\&s=deeeec9f64506070e1c064a81a1e903c)
>
> ![Token Gated Listing tab requiring at least one ERC721 token from a given contract on Ethereum](https://mintcdn.com/namespace-1f56cc70/3A9Yy6VPLxpgOcjQ/assets/activate-ens-name-8.png?fit=max\&auto=format\&n=3A9Yy6VPLxpgOcjQ\&q=85\&s=9bcb549b3dc8cf36d083d363ec071ebf)
>
> ## How ENSv1 listings were activated
>
> For reference, these are the steps owners followed to activate an ENSv1 name.
>
> **1. Open the Onchain section**
>
> The owner connected their wallet, selected the ENS name, and clicked **Activate Name**.
>
> ![Onchain section with an ENS name selected and the Activate Name button](https://mintcdn.com/namespace-1f56cc70/3A9Yy6VPLxpgOcjQ/assets/activate-ens-name-1.png?fit=max\&auto=format\&n=3A9Yy6VPLxpgOcjQ\&q=85\&s=2e26a780d353ce6175f195e796c42e82)
>
> **2. Choose L1 or L2 issuance**
>
> **L1 ENS Subnames** issued subnames on Ethereum Mainnet. **L2 ENS Subnames** issued them on a supported L2 picked from a dropdown.
>
> ![Listing type selection for L1 and L2 subnames](https://mintcdn.com/namespace-1f56cc70/3A9Yy6VPLxpgOcjQ/assets/activate-ens-name-2.png?fit=max\&auto=format\&n=3A9Yy6VPLxpgOcjQ\&q=85\&s=20fb0132343f6e9d88516d9fb65dbb8f)
>
> **3. Configure the listing**
>
> The owner set the currency, treasury address, collection name and symbol, and whether subnames could be burned or rented. Then they set the base mint price and any length-based or special-name pricing.
>
> ![Listing setup fields for currency, treasury, collection metadata, burning, and renting](https://mintcdn.com/namespace-1f56cc70/3A9Yy6VPLxpgOcjQ/assets/activate-ens-name-3.png?fit=max\&auto=format\&n=3A9Yy6VPLxpgOcjQ\&q=85\&s=8722b6ec72d0fb0c88de2f890ef8e6f4)
>
> **4. Add optional minting rules**
>
> Reservations blocked names or gave them a custom price. Owners could also add a deadline, restrict minting with an allowlist, or require an ERC-20 or ERC-721 token.
>
> ![Reservation settings for blocking names or assigning custom prices](https://mintcdn.com/namespace-1f56cc70/3A9Yy6VPLxpgOcjQ/assets/activate-ens-name-5.png?fit=max\&auto=format\&n=3A9Yy6VPLxpgOcjQ\&q=85\&s=830aa33891d7282159da4e213dde1108)
>
> **5. Activate the listing**
>
> The owner reviewed the configuration, clicked **Activate**, and confirmed the transaction. On Ethereum Mainnet this could require wrapping the ENS name. L2 listings also needed a registry contract and the Namespace Hybrid Resolver.
>
> **6. Finish the activation**
>
> After any remaining registry or resolver transactions, the owner clicked **Finish Activation**. The name then showed an **Activated** badge.
>
> ![Activated ENS name with its minted subnames](https://mintcdn.com/namespace-1f56cc70/3A9Yy6VPLxpgOcjQ/assets/activate-ens-name-11.png?fit=max\&auto=format\&n=3A9Yy6VPLxpgOcjQ\&q=85\&s=cf6ee21aeacccd62b555efe5f711b278)
>
> ## How users mint
>
> Users mint subnames of an ENSv1 listing through:
>
> * The name's page at `app.namespace.ninja/<name>.eth`.
> * [Namespace search](https://docs.namespace.ninja/user-guide/app/search-register.md).
>
> ENSv1 listings also work with the deprecated [ENS Widget](https://docs.namespace.ninja/user-guide/ens-widget.md), [Subpages](https://docs.namespace.ninja/user-guide/subpages.md), and [Mint Manager](https://docs.namespace.ninja/developer-guide/guide/mint-l1-l2-subnames.md).

## Next steps

> [card] [Add minting to your app](https://docs.namespace.ninja/developer-guide/sdks/ens-components/mint-subnames.md)
>
> Let users mint subnames of your activated name with ENS Components.

> [card] [Issue offchain subnames](https://docs.namespace.ninja/user-guide/dev-portal.md)
>
> Create gasless subnames under the same name.

> [card] [Namespace ENSv2 migration](https://docs.namespace.ninja/overview/ensv2.md)
>
> Check what works with your ENSv1 or ENSv2 name.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.