Skip to content
Last updated
Edit

Command Reference

This page documents every command available in the Unstoppable Domains CLI. For installation and setup, see the CLI Quick Start.

Search & Discovery

Search for domain availability and pricing.

ud search <query>

Example:

ud search "mybusiness"
ud search "coffee.com"

ud tlds

List all available TLDs supported by the registrar.

ud tlds

Domain Management

ud domains list

List domains in your portfolio.

ud domains list

Key flags:

FlagDescription
--status <status>Filter by all, for-sale, or unlisted
--expiring-within <days>Show domains expiring within N days
--tag <tag>Filter by tag
--order-by <field>Sort by name, length, purchasedAt, expiresAt, listingPrice, offers, leads, watchlistCount
--order-direction <dir>asc or desc

Example:

ud domains list --status for-sale --order-by listingPrice
ud domains list --expiring-within 30
ud domains list --fields name,expiresAt,offersCount

ud domains get

Get detailed information about one or more domains.

ud domains get <domains...>

Example:

ud domains get example.com
ud domains get example.com mybrand.io

ud domains push

Push a domain to another user.

ud domains push <domains...>

ud domains auto-renewal update

Toggle auto-renewal for domains.

ud domains auto-renewal update <domains...>

ud domains tags

Manage domain tags.

ud domains tags add <domains...> --tag <tag>
ud domains tags remove <domains...> --tag <tag>

ud domains flags

Manage domain flags.

ud domains flags set <domains...>
ud domains flags unset <domains...>

DNS

ud domains dns records show

Display DNS records for a domain.

ud domains dns records show <domain>

Example:

ud domains dns records show example.com

ud domains dns records add

Add a DNS record.

ud domains dns records add <domain>

Pass record data inline with --data or from a file with --file:

ud domains dns records add example.com --data '{"type":"A","hostName":"@","value":"192.0.2.1","ttl":3600}'
ud domains dns records add example.com --file records.json

ud domains dns records update

Update an existing DNS record.

ud domains dns records update <domain>

ud domains dns records remove

Remove a DNS record.

ud domains dns records remove <domain>

ud domains dns nameservers show

Display current nameservers.

ud domains dns nameservers show <domain>

ud domains dns nameservers set-custom

Set custom nameservers.

ud domains dns nameservers set-custom <domain>

ud domains dns nameservers set-default

Reset to UD default nameservers.

ud domains dns nameservers set-default <domain>

Using custom nameservers disables DNS record management through the CLI and API. Set default nameservers to re-enable it.

Hosting

ud domains hosting redirect

Configure a domain redirect.

ud domains hosting redirect <domain>

ud domains hosting landing-page

Generate an AI-powered landing page for a domain.

ud domains hosting landing-page <domain>

Cart & Checkout

ud cart list

View items in your shopping cart.

ud cart list

ud cart add

Add domains to your cart. The subcommand specifies the source:

ud cart add registration <domains...>   # New domain registration
ud cart add renewal <domains...>        # Domain renewal
ud cart add listed <domains...>         # Marketplace listing
ud cart add afternic <domains...>       # Afternic listing
ud cart add sedo <domains...>           # Sedo listing

Example:

ud cart add registration mybusiness.com
ud cart add listed premium.io

ud cart remove

Remove items from the cart.

ud cart remove <domains...>

ud cart checkout

Complete the purchase.

ud cart checkout

ud cart payment-methods

Manage payment methods.

ud cart payment-methods

Marketplace

ud marketplace listings create

List domains for sale on the marketplace.

ud marketplace listings create <domains...>

ud marketplace listings update

Update existing marketplace listings.

ud marketplace listings update <domains...>

ud marketplace listings cancel

Remove domains from the marketplace.

ud marketplace listings cancel <domains...>

ud marketplace offers list

View incoming offers on your domains.

ud marketplace offers list

ud marketplace offers respond

Accept or decline an offer.

ud marketplace offers respond

ud marketplace leads list

View conversation leads for your domains.

ud marketplace leads list

ud marketplace leads open

Open a conversation lead.

ud marketplace leads open

ud marketplace leads messages

View and send messages in a lead conversation.

ud marketplace leads messages

Contacts

ud domains contacts create

Create an ICANN contact for domain registration.

ud domains contacts create --data '{"firstName":"Jane","lastName":"Doe","email":"jane@example.com",...}'

ud domains contacts list

List your saved ICANN contacts.

ud domains contacts list

Configuration

ud config set

Save default options for a command.

ud config set "<command>" <key> <value>

Example:

ud config set "domains list" fields name,expiresAt
ud config set "domains list" format json

ud config get

View saved defaults.

ud config get [command]

ud config reset

Remove saved defaults.

ud config reset <command> [key]

ud env set

Switch the active environment.

ud env set <environment>

Example:

ud env set sandbox
ud env set production

ud env show

Display the current environment.

ud env show

Authentication

ud auth signup

Create a new Unstoppable Domains account. Prompts for email and password, sends a verification code, and signs you in automatically.

ud auth signup

Requires an interactive terminal. Password must be at least 8 characters with uppercase, lowercase, number, and special character.

ud auth login

Sign in to an existing Unstoppable Domains account.

ud auth login            # OAuth (opens browser)
ud auth login --key <key>  # API key

ud auth status

Check current authentication status.

ud auth status

ud auth logout

Clear stored credentials.

ud auth logout

Utilities

ud update check

Check for CLI updates.

ud update check

ud completion

Generate shell completion scripts.

ud completion

ud install --skills

Install agent skills for Claude Code, Cursor, or GitHub Copilot.

ud install --skills

You can also install skills via npx:

npx skills add unstoppabledomains/ud-cli

Passing Complex Data

For commands that require structured input, use --data for inline JSON or --file to read from a file:

# Inline JSON
ud domains contacts create --data '{"firstName":"Jane","lastName":"Doe","email":"jane@example.com"}'

# From a file
ud domains dns records add example.com --file records.json