Guide
Custom Domains
Replace the default linkwi.sh hostname with your own branded domain so every link reads links.yourdomain.com/slug-here.
Overview
By default every short link is served under linkwi.sh/slug. Custom domains let you swap that hostname for any subdomain you control — for example go.yourbrand.com or links.yourdomain.com.
go.example.com). If you want to use a root/apex domain (e.g. example.com) your DNS provider must support CNAME flattening (sometimes called ALIAS or ANAME records). Cloudflare, Bunny DNS, and Route 53 all support this. Check your provider's documentation before attempting an apex-domain setup.Adding a custom domain
Go to Settings → Custom Domains in the dashboard sidebar and click Add Domain. Enter your hostname (e.g. go.yourdomain.com) and confirm.
clicksdk will immediately show you two DNS records that you must add at your DNS provider before the domain becomes active.
Required DNS records
Two records are required for every custom domain:
SSL verification record
Proves you own the domain so clicksdk can issue a TLS certificate on your behalf. Without this record HTTPS will not work.
| Field | Value |
|---|---|
| Type | TXT |
| Name | shown in the dashboard after adding your domain |
| Value | shown in the dashboard after adding your domain |
| TTL | 300 (or “Auto”) |
Traffic proxying record
Routes visitor requests for your custom hostname through the clicksdk edge network so redirects are served correctly.
| Field | Value |
|---|---|
| Type | CNAME |
| Name | your subdomain, e.g. go |
| Target | proxy.linkwi.sh |
| TTL | 300 (or “Auto”) |
Using a custom domain on a link
Once a domain is verified, it appears in the Domain dropdown inside the link editor. Select it when creating or editing a link — the short URL preview updates immediately to reflect the custom hostname.
Existing links under linkwi.sh are not migrated automatically. Create new links (or duplicate existing ones) to start using the custom domain.
Multiple custom domains
You can add more than one custom domain to your account. Each domain goes through the same TXT + CNAME verification process independently. Links are domain-scoped, so the same slug can exist on multiple domains simultaneously.
Removing a custom domain
Open Settings → Custom Domains, locate the domain, and click Remove. Any links currently assigned to that domain will stop redirecting immediately. Reassign those links to another domain (or to the default linkwi.sh) before removing the domain to avoid broken links.
Troubleshooting
Domain shows `Pending` for a long time
Double-check the TXT record name and value exactly as shown in the dashboard — extra characters or spaces will cause verification to fail. Use a tool like dnschecker.org to confirm the record has propagated.
HTTPS certificate not issued
The TXT record must be verified before a certificate can be issued. If the TXT record is confirmed but the certificate is still pending, click Retry in the dashboard.
Visitors see a DNS error when clicking a link
Ensure the CNAME record is pointing to custom.linkwi.sh and that it has propagated globally. Use dig go.yourdomain.com CNAME to confirm.
Apex domain not working
Confirm your DNS provider supports CNAME flattening. If it does not, use a subdomain instead (e.g. go.yourdomain.com).