// Set up credentials for the dn CLI tool. Use when the user needs to authenticate, switch between partner and user mode, set up API keys, or connect their WordPress.com account via OAuth. Also use when the user mentions "dn configure" or needs to reconfigure their dn CLI setup.
| name | dn-configure |
| description | Set up credentials for the dn CLI tool. Use when the user needs to authenticate, switch between partner and user mode, set up API keys, or connect their WordPress.com account via OAuth. Also use when the user mentions "dn configure" or needs to reconfigure their dn CLI setup. |
Set up authentication credentials for the dn CLI.
# Interactive setup (shows splash screen, mode selection)
dn configure
# Specify mode directly
dn configure --mode=user
dn configure --mode=partner
# Pipe credentials (CI/automation)
echo -e "token" | dn configure --mode=user --stdin
echo -e "api-key\napi-user" | dn configure --mode=partner --stdin
# Custom API URL (partner mode only)
dn configure --mode=partner --api-url=https://custom.api.example.com
| Option | Description |
|---|---|
--mode | partner or user (interactive if omitted) |
--stdin | Read credentials from stdin instead of prompts |
--api-url | Custom API base URL (partner mode only) |
~/.config/dn/config.json with 0600 permissionsDN_API_KEY, DN_API_USER, DN_MODE, DN_OAUTH_TOKENVerify that the dn CLI is installed and configured. Use when the user first installs the domain-names plugin, or when a dn command fails because the CLI is missing or not set up.
View the WordPress.com shopping cart using the dn CLI. Use when the user wants to see what domains are in their cart before checkout. User mode only - not available in partner mode.
Check domain name availability and pricing using the dn CLI. Use when the user wants to know if a domain is available, see domain pricing, or verify multiple domains at once. Supports both partner mode (Domain Services API) and user mode (WordPress.com API).
Open WordPress.com checkout in the browser using the dn CLI. Use when the user wants to complete a domain purchase after adding domains to cart. User mode only.
Update domain contact information (WHOIS contacts) using the dn CLI. Use when the user wants to change owner, admin, tech, or billing contacts for a domain. Partner mode only.
Delete a domain registration using the dn CLI. Use when the user wants to remove or cancel a domain. Shows a confirmation prompt before proceeding. Partner mode only - user mode redirects to WordPress.com.