Custom Domains

Connect your own domain to LinkSnap for fully branded short links. Available on Pro and Business plans.

Overview

Custom domains let you use your own domain (e.g. links.yourdomain.com) instead of linksnap.forjio.com for your short links. Every link you create will automatically use your custom domain. SSL is provisioned for free.

Plan	Custom Domains
Free	Not available
Pro	1 domain
Business	5 domains

Step 1: Add Your Domain

Go to Settings → Custom Domains in the dashboard and click Add Domain. Enter your subdomain (e.g. links.yourdomain.com).

Or use the CLI:

linksnap domains add links.yourdomain.com

After adding, you'll see two DNS records that need to be configured at your DNS provider.

Step 2: Configure DNS Records

Add these two records at your DNS provider (e.g. Cloudflare, Namecheap, GoDaddy, DigitalOcean):

CNAMEPoints your domain to LinkSnap

Host	links.yourdomain.com
Target	cname.linksnap.forjio.com

TXTVerifies domain ownership

Host	_linksnap-verify.links.yourdomain.com
Value	ls-verify-<your-token>

The exact token is shown in the dashboard or CLI output after adding the domain.

Note: DNS propagation can take up to 48 hours, though most providers update within minutes. If you use Cloudflare, set the CNAME record to "DNS only" (gray cloud) — not proxied.

Step 3: Verify Your Domain

Once DNS records are configured, click the Verify button in Settings or run:

linksnap domains verify <domain-id>

LinkSnap will check your CNAME and TXT records. If both are valid, your domain enters theverifyingstate while SSL is automatically provisioned.

Within a minute, the status will change toactive— your custom domain is live!

Step 4: Start Using It

Once active, all new links in your workspace will automatically use your custom domain:

# Before custom domain
https://linksnap.forjio.com/my-link

# After custom domain
https://links.yourdomain.com/my-link

Existing links will also work on your custom domain. QR codes that link to your short URLs will automatically use the branded domain.

CLI Commands

Manage custom domains entirely from the terminal:

Command	Description
linksnap domains list	List all custom domains with status
linksnap domains add <domain>	Add a new custom domain
linksnap domains verify <id>	Verify DNS configuration
linksnap domains remove <id>	Remove a custom domain

Troubleshooting

"CNAME record not found"

Make sure the CNAME record points exactly to cname.linksnap.forjio.com (with no trailing dot in some providers). If using Cloudflare, disable the proxy (orange cloud → gray cloud).

"TXT record not found"

Most DNS providers (DigitalOcean, Cloudflare, Namecheap, etc.) automatically append your domain to the record host. If your custom domain is links.yourdomain.com, enter only _linksnap-verify.links as the host — not the full _linksnap-verify.links.yourdomain.com, otherwise it becomes _linksnap-verify.links.yourdomain.com.yourdomain.com. The value must match the token exactly.

Domain stuck in "verifying"

SSL provisioning usually completes within a minute. If the status doesn't change to "active" after 5 minutes, try removing and re-adding the domain.

Can I use a root domain?

We recommend using a subdomain (e.g. links.yourdomain.com) because root domains cannot have CNAME records per the DNS specification. Some providers support CNAME flattening (e.g. Cloudflare CNAME at apex), but this isn't guaranteed to work with all setups.