HostModules Docs

Domain Configuration

If your product requires a domain (configurable per product in WHMCS), the order form includes a domain section where customers can register, transfer, or use an existing domain.

Enabling Domain Requirements

In WHMCS Admin → Products/Services → Edit Product → Details Tab:

  • Set Require Domain to checked if the product needs a domain
  • The domain section will appear automatically in the order form when this is enabled

If the product does not require a domain, the domain section is hidden completely.

Domain Options Available to Customers

Customers see three tabs in the domain section:

1. Register a New Domain

  • Text input for entering a domain name (without TLD)
  • TLD selector dropdown (populated from your WHMCS domain pricing)
  • Check Availability button — performs a real-time availability query via your configured registrar
  • Available domains show a green check and price
  • Unavailable domains show with suggestions (alternative TLDs)

2. Transfer a Domain

  • Input for the full domain name (e.g. example.com)
  • Input for the EPP/Auth code
  • Transfer pricing is pulled from your WHMCS domain registrar pricing

3. Use an Existing Domain

  • Input for the domain name
  • No registrar check is performed
  • WHMCS will prompt for nameserver updates after the order is complete

Configuring Available TLDs

The TLDs shown in the domain register dropdown are the TLDs you have configured and priced in WHMCS:

  1. Go to Payments → Domain Pricing
  2. Add TLDs and set registration/renewal/transfer prices
  3. Set each TLD’s registrar to an active registrar module (e.g. ENOM, ResellerClub, Cloudflare)
  4. Ensure the registrar module is configured under System Settings → Domain Registrars

Registrar required for availability checks

Real-time availability search requires a working domain registrar integration. If no registrar is configured, the availability check will fail silently or return an error.

Domain Pricing Display

Domain prices displayed in the order form come from your WHMCS Domain Pricing configuration:

  • Registration price = the 1-year registration price for the TLD
  • The order form shows the first-year registration price next to the TLD in the dropdown

Free Domain with Hosting

WHMCS supports offering a free domain with certain products. When configured:

  1. In the product settings, enable Require Domain and configure the free domain promotion in WHMCS Promotions
  2. The order form automatically detects the free domain promotion and shows “Register a domain — FREE” in the domain section

After the Order

Once an order is placed:

  • Register — WHMCS submits a registration request to the registrar automatically (if auto-provisioning is enabled)
  • Transfer — WHMCS initiates the transfer process
  • Existing — WHMCS notes the domain; no registrar action is taken automatically

Customers manage their domain settings from the WHMCS client area after checkout.