Custom Domains
Learn how to configure a custom domain for your ToughClicks legal center to maintain brand consistency.
Overview
ToughClicks allows you to use a custom domain name for your legal center, such as legal.yourdomain.com or terms.yourdomain.com. This provides:
- Brand Consistency - Keep users on your domain
- Trust - Users see your company's domain in the URL
- Professional Appearance - Maintain a cohesive brand experience
- SEO Benefits - Keep traffic on your domain
By default, ToughClicks document links use toughclicks.com domains. With a custom domain, users will see your branded URL instead.
Prerequisites
Before setting up a custom domain, you need:
- Plan Access - Custom domains are available on specific plans. Contact your ToughClicks account manager to ensure this feature is included in your plan.
- Domain Access - You must have access to configure DNS records for your domain.
- Subdomain Selection - Choose a subdomain (e.g.,
legal,terms,agreements,docs).
How It Works
When you configure a custom domain:
- You choose a subdomain (e.g.,
legal.yourdomain.com) - ToughClicks configures SSL certificates and routing
- You create a DNS CNAME record pointing to ToughClicks
- Document links use your custom domain instead of
toughclicks.com
Setup Process
Step 1: Request Custom Domain
Contact your ToughClicks account manager with:
- Your desired subdomain (e.g.,
legal) - Your root domain (e.g.,
yourdomain.com) - Your complete custom domain (e.g.,
legal.yourdomain.com) - Optionally, how the browser tab should look on that domain: a page title (e.g.,
Acme's Legal Center), a meta description for search engines, and a favicon URL (must behttps://)
Example email:
Subject: Custom Domain Setup Request
Hi [Account Manager],
We would like to set up a custom domain for our ToughClicks legal center.
Desired custom domain: legal.acmecorp.com
Root domain: acmecorp.com
Subdomain: legal
Please let me know the next steps.
Thanks,
[Your Name]
Step 2: ToughClicks Configuration
Your ToughClicks representative will:
- Set up routing, forwarding and SSL for the hostname
- Enter the custom domain, page title, meta description and favicon on your organization in the ToughClicks Site Admin panel (Site Admin > Organizations)
The custom domain settings are stored on your organization, so they can be added or changed at any time without waiting for a ToughClicks release. Routing and SSL typically take 1-2 business days.
Only ToughClicks site administrators can set or change an organization's custom domain settings. Organization admins can see their organization's other settings but not these. If you want to change your domain, title, description or favicon, contact your account manager.
Step 3: DNS Configuration
Once ToughClicks confirms configuration is complete, create a CNAME record in your DNS settings:
| Field | Value |
|---|---|
| Record Type | CNAME |
| Host/Name | Your subdomain (e.g., legal) |
| Value/Target | forward.toughclicks.com |
| TTL | 3600 (or your DNS provider's default) |
Example Configurations
For legal.acmecorp.com:
Type: CNAME
Host: legal
Target: forward.toughclicks.com
TTL: 3600
For terms.mycompany.com:
Type: CNAME
Host: terms
Target: forward.toughclicks.com
TTL: 3600
Step 4: Verify Configuration
After creating the DNS record:
- Wait 5-15 minutes for DNS propagation (may take up to 48 hours)
- ToughClicks will verify the domain and create SSL Certificates
- Visit your custom domain in a browser
- Verify it loads your ToughClicks legal center
- Check that SSL certificate is valid (look for the padlock icon)
Test your configuration:
# Check DNS resolution
nslookup legal.yourdomain.com
# Should show CNAME pointing to forward.toughclicks.com
# Check SSL certificate
curl -I https://legal.yourdomain.com
DNS Provider Examples
Cloudflare
- Log in to Cloudflare
- Select your domain
- Go to DNS > Records
- Click Add record
- Configure:
- Type:
CNAME - Name:
legal(your subdomain) - Target:
forward.toughclicks.com - Proxy status: DNS only (grey cloud)
- TTL: Auto
- Type:
- Click Save
Make sure to set the proxy status to "DNS only" (grey cloud icon). Do not use Cloudflare's proxy (orange cloud) as it may interfere with ToughClicks' SSL configuration.
AWS Route 53
- Log in to AWS Console
- Go to Route 53 > Hosted Zones
- Select your domain
- Click Create record
- Configure:
- Record name:
legal(your subdomain) - Record type:
CNAME - Value:
forward.toughclicks.com - TTL:
300 - Routing policy: Simple routing
- Record name:
- Click Create records
Google Cloud DNS
- Log in to Google Cloud Console
- Go to Network Services > Cloud DNS
- Select your DNS zone
- Click Add record set
- Configure:
- DNS name:
legal.yourdomain.com - Resource record type:
CNAME - TTL:
5minutes - Canonical name:
forward.toughclicks.com
- DNS name:
- Click Create
GoDaddy
- Log in to GoDaddy
- Go to My Products > DNS
- Select your domain
- Click Add under Records
- Configure:
- Type:
CNAME - Host:
legal(your subdomain) - Points to:
forward.toughclicks.com - TTL:
1 hour
- Type:
- Click Save
Namecheap
- Log in to Namecheap
- Go to Domain List > Select your domain
- Click Advanced DNS
- Click Add New Record
- Configure:
- Type:
CNAME Record - Host:
legal(your subdomain) - Value:
forward.toughclicks.com - TTL:
Automatic
- Type:
- Click the checkmark to save
Using Your Custom Domain
Once configured, your custom domain will automatically be used in:
Document Links
When users click to view terms, they'll see:
Before: https://app.toughclicks.com/legal-center/{your_org_slug}/{document_slug}...
After: https://legal.yourdomain.com/{document_slug}...
Email Notifications
If you send email notifications with document links, you should use your custom domain:
Click here to review our terms:
https://legal.acmecorp.com/privacy-policy
Integration
No code changes are required. The JavaScript library automatically uses your configured custom domain:
import { ToughClicks } from '@toughclicks/js-client-sdk';
const tc = new ToughClicks(clientToken, packetId);
tc.setDisplayOptions({
containerId: 'tc-agreements',
signerId: '[email protected]',
shouldOpenModal: true // Links will use your custom domain
});
tc.render();
Page Title, Description and Favicon
On your custom domain, the legal center, the hosted acceptance page (/accept) and the thank-you page use the page title, meta description and favicon configured for your organization. Any of them can be left empty, in which case the ToughClicks defaults are shown.
One Domain per Organization
Each ToughClicks organization has one custom domain, and a domain can belong to only one organization. Hostnames are not case sensitive (Legal.AcmeCorp.com and legal.acmecorp.com are the same domain) and are entered without a path or port.
If you have multiple brands that each need their own domain, use a separate ToughClicks organization per brand. Contact your ToughClicks representative to set this up.
Deactivated Organizations
If an organization is deactivated, its custom domain keeps resolving but shows a "This page is unavailable" message instead of the legal center. Reactivating the organization restores the legal center within about a minute.
SSL/TLS Certificates
ToughClicks automatically provisions and manages SSL certificates for your custom domain using Let's Encrypt. This includes:
- Automatic Issuance - Certificates are created when you configure your domain
- Auto-Renewal - Certificates are renewed automatically before expiration
- Strong Encryption - Industry-standard TLS 1.2+ encryption
- Browser Trust - Certificates are trusted by all modern browsers
You don't need to provide or manage certificates yourself.
Troubleshooting
DNS Not Resolving
If your custom domain isn't working:
-
Verify DNS Record
nslookup legal.yourdomain.comShould show a CNAME record pointing to
forward.toughclicks.com -
Check TTL - DNS changes can take time to propagate. Wait at least the TTL duration.
-
Clear DNS Cache - Your computer may have cached old DNS records:
# macOS
sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
# Windows
ipconfig /flushdns
# Linux
sudo systemd-resolve --flush-caches -
Use Online DNS Tools - Check propagation globally:
SSL Certificate Errors
If you see SSL warnings:
- Wait for Provisioning - SSL certificates can take up to 24 hours to provision
- Check DNS - SSL provisioning requires valid DNS records
- Contact Support - If issues persist after 24 hours
404 or 502 Errors
If you see error pages:
- Verify ToughClicks Configuration - Contact your account manager to confirm backend setup is complete and that the custom domain is entered on your organization. A domain that isn't assigned to any organization shows a "Page Not Found" page
- Check CNAME Target - Ensure CNAME points to
forward.toughclicks.comexactly - Remove Proxies - Disable any CDN or proxy features (like Cloudflare's orange cloud)
Subdomain Conflicts
If you already use a subdomain:
- Choose a different subdomain (
legal,terms,agreements,docs,privacy, etc.) - Use a different root domain if available
- Create a new subdomain specifically for ToughClicks
Best Practices
1. Choose Intuitive Subdomains
Pick subdomains that clearly indicate legal content:
legal.yourdomain.com- Most common, general legal contentterms.yourdomain.com- Specifically for terms of serviceprivacy.yourdomain.com- For privacy policiesagreements.yourdomain.com- For user agreementscompliance.yourdomain.com- For compliance documentation
2. Keep DNS Simple
- Use a short, memorable subdomain
- Avoid complex subdomain structures (e.g.,
legal.docs.yourdomain.com) - Use lowercase only
3. Monitor Certificate Expiration
While ToughClicks auto-renews certificates, set up monitoring:
# Check certificate expiration
openssl s_client -connect legal.yourdomain.com:443 -servername legal.yourdomain.com 2>/dev/null | openssl x509 -noout -dates
4. Document Your Configuration
Keep a record of:
- Custom domain name
- DNS provider
- Date configured
- Contact person at ToughClicks
5. Test Before Launch
Test your custom domain thoroughly:
- Verify SSL certificate
- Check document links
- Test on multiple browsers
- Verify mobile experience
Migrating to a Custom Domain
If you're already using ToughClicks and want to add a custom domain:
- Plan the Migration - Choose a low-traffic time
- Configure Domain - Follow setup steps above
- Test Thoroughly - Verify all links work
- Monitor - Watch for any issues after launch
- Update Documentation - Update any references to old URLs
Old toughclicks.com links continue to work even after configuring a custom domain. This ensures existing links in emails or documentation remain functional.
Cost and Availability
Custom domain availability varies by plan:
- Enterprise Plans - Typically included
- Professional Plans - May be available as an add-on
- Standard Plans - Contact your account manager
Pricing may include:
- One-time setup fee
- Monthly recurring fee
- Additional fees for multiple domains
Contact your ToughClicks account manager for specific pricing.
Next Steps
- Set up sandbox environments for testing
- Configure dynamic contracts for personalization
- Learn about force reacceptance workflows