Working with ArNS
The Arweave 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
myappinstead 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 (Arweave Name Token) system
Getting Started
Purchase an ArNS Name
Learn how to register and purchase ArNS names using the arns.app interface
Manage ArNS Names
Update records, transfer ownership, and configure your ArNS names
Primary Names
Set up web3 identity using ArNS names that resolve to wallet addresses
Advanced Usage
Register ArNS Names Programmatically
Use the ArIO SDK to programmatically register and purchase ArNS names
Set Records Programmatically
Use the ArIO SDK to programmatically set and manage ArNS records
Undername Versioning
Use undernames to manage different versions and components of your permanent website
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 (Arweave Name Token)
The smart contract system that manages ArNS name ownership, transfers, and record updates.
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
Host Unstoppable Apps
Learn how to deploy and host permanent apps on Arweave
Access Data
Start accessing Arweave content through multiple gateways
ArIO SDK Documentation
Explore the full ArIO SDK for advanced ArNS operations
Join the Community
Connect with other developers building on AR.IO
How is this guide?