W
webb.in Support
← Back to guides

Custom Domains

Brand your short links with your own domain — complete with free SSL via Let's Encrypt.

Why Use a Custom Domain?

Instead of sharing webb.in/abc, you can share links like go.yourbrand.com/abc. Custom domains build trust, reinforce your brand, and increase click-through rates.

  • ✓ Free SSL certificate via Let's Encrypt (auto-provisioned & auto-renewed)
  • ✓ Global CDN distribution
  • ✓ One custom domain per account (included free)
  • ✓ Works with any domain registrar

Before You Begin

  • •You must have a webb.in account. Sign up here.
  • •You need a domain you own and access to its DNS settings (e.g., Cloudflare, GoDaddy, Namecheap, Route 53).
  • •Use a subdomain like go.yourdomain.com or link.yourdomain.com. Root domains are not supported.

Step-by-Step Setup

1

Add Your Domain

Log in to app.webb.in, go to Settings → Custom Domain, and enter your subdomain (e.g., go.yourbrand.com).

Domain: go.yourbrand.com
2

Add DNS Records

After adding your domain, webb.in will provide two DNS records to add: a TXT record for ownership verification, and a CNAME record that delegates SSL challenges to our servers for automatic certificate management.

# DNS TXT Record (Ownership Verification)
Name: _webb-verify.go.yourbrand.com
Type: TXT
Value: webb-verify=abc123...
# DNS CNAME Record (SSL Delegation)
Name: _acme-challenge.go.yourbrand.com
Type: CNAME
Value: go.yourbrand.com._acme.webb.in

DNS changes can take 5–30 minutes to propagate, though some providers are faster.

3

SSL Certificate Provisioning

Once verification succeeds, webb.in automatically obtains a free SSL certificate via Let's Encrypt. This typically takes 1–3 minutes.

✓ You'll see the status change from "Pending" → "Provisioning SSL" → "Active" in your dashboard. Certificates auto-renew — no manual action needed.
4

Add a CNAME Record

After the SSL certificate is issued, webb.in will show you an API endpoint URL. Point your subdomain to this endpoint.

# DNS CNAME Record (Routing)
Name: go.yourbrand.com
Type: CNAME
Value: d-xxx.execute-api.us-east-1.amazonaws.com
5

Start Using Your Custom Domain

Once the CNAME propagates, your custom domain is fully active! All new short links you create will automatically use your custom domain. Visit https://go.yourbrand.com/your-code to verify it works.

Troubleshooting

Domain stuck on "Pending Verification"

Make sure the TXT record is set on the correct subdomain (_webblink.go.yourbrand.com) and allow up to 30 minutes for DNS propagation. You can use Google's Dig tool to verify.

SSL certificate not issuing

SSL provisioning requires both the TXT verification and the ACME delegation CNAME (_acme-challenge.go.yourbrand.com) to be set correctly. If it's been more than 30 minutes, try removing and re-adding the domain.

"Domain already in use" error

Each custom domain can only be linked to one webb.in account. If you previously added this domain to a different account, remove it there first.

Cloudflare users: Proxy mode

If you use Cloudflare, set the CNAME record to DNS only (gray cloud), not Proxied (orange cloud). Cloudflare's proxy can interfere with DNS-based certificate validation and routing.