Working with ArNS

The Ar.io Name System (ArNS) provides human-readable names for Arweave content, making it easy to access and manage your permanent websites and applications. Learn how to register, manage, and use ArNS names effectively.

What is ArNS?

ArNS is a decentralized naming system that allows you to:

• Register human-readable names like myapp instead of using long transaction IDs
• Point names to content stored on Arweave for permanent access
• Create subdomains (undernames) for organizing different versions and components
• Establish web3 identity with primary names linked to wallet addresses
• Transfer ownership of names through the ANT (Ar.io Name Token) system — ANTs are Metaplex Core NFTs tradeable on Solana marketplaces

Getting Started

Advanced Usage

Key Concepts

ArNS Names

Human-readable identifiers that point to Arweave content, making it easy to access your permanent websites and applications.

Undernames

Subdomains under your main ArNS name that allow you to organize different versions, components, and content types.

Primary Names

ArNS names used as web3 identity that resolve to wallet addresses, enabling human-readable usernames across applications.

ANT (Ar.io Name Token)

A Metaplex Core NFT on Solana that represents ownership and control of an ArNS name. Each ANT stores DNS-like records pointing to Arweave data. ANTs are managed by the ario-ant Solana program and are tradeable on NFT marketplaces like Tensor and Magic Eden.

Common Use Cases

• Permanent websites - Host decentralized websites with memorable names
• Application versioning - Maintain multiple versions of your app using undernames
• Web3 identity - Use primary names as your identity across the ecosystem
• Content organization - Structure different types of content using undernames
• API endpoints - Create dedicated subdomains for different services

Next Steps