Skip to main content
Version: Isle Royale (2.5.0)

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:

  1. Plan Access - Custom domains are available on specific plans. Contact your ToughClicks account manager to ensure this feature is included in your plan.
  2. Domain Access - You must have access to configure DNS records for your domain.
  3. Subdomain Selection - Choose a subdomain (e.g., legal, terms, agreements, docs).

How It Works​

When you configure a custom domain:

  1. You choose a subdomain (e.g., legal.yourdomain.com)
  2. ToughClicks configures SSL certificates and routing
  3. You create a DNS CNAME record pointing to ToughClicks
  4. 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 be https://)

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.

Who can change it

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:

FieldValue
Record TypeCNAME
Host/NameYour subdomain (e.g., legal)
Value/Targetforward.toughclicks.com
TTL3600 (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:

  1. Wait 5-15 minutes for DNS propagation (may take up to 48 hours)
  2. ToughClicks will verify the domain and create SSL Certificates
  3. Visit your custom domain in a browser
  4. Verify it loads your ToughClicks legal center
  5. 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​

  1. Log in to Cloudflare
  2. Select your domain
  3. Go to DNS > Records
  4. Click Add record
  5. Configure:
    • Type: CNAME
    • Name: legal (your subdomain)
    • Target: forward.toughclicks.com
    • Proxy status: DNS only (grey cloud)
    • TTL: Auto
  6. Click Save
Cloudflare Proxy

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​

  1. Log in to AWS Console
  2. Go to Route 53 > Hosted Zones
  3. Select your domain
  4. Click Create record
  5. Configure:
    • Record name: legal (your subdomain)
    • Record type: CNAME
    • Value: forward.toughclicks.com
    • TTL: 300
    • Routing policy: Simple routing
  6. Click Create records

Google Cloud DNS​

  1. Log in to Google Cloud Console
  2. Go to Network Services > Cloud DNS
  3. Select your DNS zone
  4. Click Add record set
  5. Configure:
    • DNS name: legal.yourdomain.com
    • Resource record type: CNAME
    • TTL: 5 minutes
    • Canonical name: forward.toughclicks.com
  6. Click Create

GoDaddy​

  1. Log in to GoDaddy
  2. Go to My Products > DNS
  3. Select your domain
  4. Click Add under Records
  5. Configure:
    • Type: CNAME
    • Host: legal (your subdomain)
    • Points to: forward.toughclicks.com
    • TTL: 1 hour
  6. Click Save

Namecheap​

  1. Log in to Namecheap
  2. Go to Domain List > Select your domain
  3. Click Advanced DNS
  4. Click Add New Record
  5. Configure:
    • Type: CNAME Record
    • Host: legal (your subdomain)
    • Value: forward.toughclicks.com
    • TTL: Automatic
  6. Click the checkmark to save

Using Your Custom Domain​

Once configured, your custom domain will automatically be used in:

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:

  1. Verify DNS Record

    nslookup legal.yourdomain.com

    Should show a CNAME record pointing to forward.toughclicks.com

  2. Check TTL - DNS changes can take time to propagate. Wait at least the TTL duration.

  3. 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
  4. Use Online DNS Tools - Check propagation globally:

SSL Certificate Errors​

If you see SSL warnings:

  1. Wait for Provisioning - SSL certificates can take up to 24 hours to provision
  2. Check DNS - SSL provisioning requires valid DNS records
  3. Contact Support - If issues persist after 24 hours

404 or 502 Errors​

If you see error pages:

  1. 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
  2. Check CNAME Target - Ensure CNAME points to forward.toughclicks.com exactly
  3. Remove Proxies - Disable any CDN or proxy features (like Cloudflare's orange cloud)

Subdomain Conflicts​

If you already use a subdomain:

  1. Choose a different subdomain (legal, terms, agreements, docs, privacy, etc.)
  2. Use a different root domain if available
  3. 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 content
  • terms.yourdomain.com - Specifically for terms of service
  • privacy.yourdomain.com - For privacy policies
  • agreements.yourdomain.com - For user agreements
  • compliance.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:

  1. Plan the Migration - Choose a low-traffic time
  2. Configure Domain - Follow setup steps above
  3. Test Thoroughly - Verify all links work
  4. Monitor - Watch for any issues after launch
  5. Update Documentation - Update any references to old URLs
Backward Compatibility

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​