Overview
NueForm allows Pro+ users to serve forms from their own branded domain instead of the default nueform.io URL. There are two options: NueForm subdomains and fully custom domains.
NueForm Subdomains
A NueForm subdomain gives you a branded URL under the nueform.io domain.
Format: yourcompany.nueform.io
Setting Up a Subdomain
- Navigate to your account settings.
- Find the Custom Domain section.
- Enter your desired subdomain (e.g.,
acme). - Click Save.
Your forms will now be accessible at:
https://acme.nueform.io/f/your-form-slug
Subdomain Rules
- Subdomains must be unique across all NueForm users.
- Only lowercase letters, numbers, and hyphens are allowed.
- The subdomain cannot start or end with a hyphen.
- Certain reserved subdomains (e.g.,
www,api,app) are not available.
NueForm subdomains require no DNS configuration. They are available immediately after setup.
Custom Domains
A fully custom domain lets you serve forms from your own domain name.
Format: forms.yourcompany.com
Setting Up a Custom Domain
- Navigate to your account settings.
- Find the Custom Domain section.
- Enter your full custom domain (e.g.,
forms.acme.com). - Click Save to initiate domain verification.
- Configure DNS records as instructed (see below).
- Wait for verification to complete.
DNS Configuration
To connect your custom domain, you need to add a CNAME record in your DNS provider:
| Record Type | Name | Value |
|---|---|---|
CNAME | forms (or your chosen subdomain) | cname.vercel-dns.com |
Steps for common DNS providers:
- Log in to your DNS provider (e.g., Cloudflare, GoDaddy, Namecheap, Route 53).
- Navigate to DNS management for your domain.
- Add a new CNAME record:
- Name/Host: The subdomain you want to use (e.g.,
forms). - Value/Target:
cname.vercel-dns.com - TTL: Auto or 3600.
- Name/Host: The subdomain you want to use (e.g.,
- Save the record.
- Return to NueForm and wait for verification.
DNS changes can take up to 48 hours to propagate, though they typically complete within minutes to a few hours. NueForm will automatically check for verification periodically.
Domain Verification
After adding your DNS record, NueForm verifies the domain:
- Pending: The CNAME record has not been detected yet. Wait for DNS propagation.
- Verified: The domain is verified and active. Your forms are now served from your custom domain.
The verification status is tracked with a timestamp (customDomainVerifiedAt). Once verified, SSL certificates are automatically provisioned through Vercel.
SSL Certificates
Custom domains automatically receive SSL certificates. All traffic is served over HTTPS with no additional configuration required.
Using Your Custom Domain
Once verified, your forms are accessible at:
https://forms.acme.com/f/your-form-slug
URL parameters, embeds, and all form features work identically to the default nueform.io URL.
Domain Management
| Field | Description |
|---|---|
| subdomain | Your NueForm subdomain (e.g., acme for acme.nueform.io). |
| customDomain | Your fully custom domain (e.g., forms.acme.com). |
| customDomainVerifiedAt | Timestamp when the domain was verified. null means verification is pending. |
| customDomainVercelId | Internal Vercel domain ID used for management. |
Requirements
Custom domains and subdomains are Pro+ features. They are not available on free or lower-tier plans.
Changing or Removing a Domain
- Changing: Update the domain in your account settings. If switching to a new custom domain, you will need to update your DNS records and wait for re-verification.
- Removing: Clear the domain field in your account settings. Forms will revert to being served from the default
nueform.ioURL.
Changing or removing a custom domain will break any existing links that use the old domain. Make sure to update any embeds, bookmarks, or shared links that reference the old URL.