> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryinhouse.co/llms.txt
> Use this file to discover all available pages before exploring further.
# Domain Management
> Configure and manage custom domains for your Inhouse links
## Domain Management
Custom domains allow you to brand your Inhouse links with your own domain names, creating a professional and trustworthy appearance for your marketing campaigns.
## Why Use Custom Domains?
### Benefits of Custom Domains
* **Brand Recognition**: Links look more professional and trustworthy
* **User Trust**: Users are more likely to click branded links
* **SEO Benefits**: Links contribute to your domain's authority
* **Consistency**: Maintain brand consistency across all marketing materials
* **Analytics**: Track performance under your own domain
### Use Cases
* **Marketing Campaigns**: Branded links for email campaigns
* **Social Media**: Professional links for social posts
* **Referral Programs**: Trusted links for partner promotions
* **Product Launches**: Branded links for new product announcements
## Adding Your First Domain
### Domain Setup Process
1. **Navigate to Domains**: Go to Settings > Domains in your dashboard
2. **Click "Add Domain"**: Use the prominent button to start adding
3. **Enter Domain Name**: Type your domain (e.g., `links.yourcompany.com`)
4. **Choose Domain Type**: Select primary or secondary domain
5. **Verify Ownership**: Complete the verification process
### Domain Requirements
Before adding a domain, ensure it meets these requirements:
* **Valid Domain**: Must be a registered, active domain
* **DNS Access**: You must have access to modify DNS records
* **HTTPS Support**: Domain should support HTTPS (recommended)
* **No Conflicts**: Domain shouldn't conflict with existing services
## Domain Verification
### Verification Methods
Choose the verification method that works best for your setup:
Add a TXT record to your domain's DNS:
1. **Get Verification Code**: Copy the verification code from Inhouse
2. **Add TXT Record**: Add to your DNS provider
3. **Wait for Propagation**: DNS changes can take up to 48 hours
4. **Verify**: Click verify in the Inhouse dashboard
**Example TXT Record:**
```
Name: @
Type: TXT
Value: inhouse-verification=abc123def456
```
Upload a verification file to your web server:
1. **Download File**: Download the verification file from Inhouse
2. **Upload to Server**: Place file in your domain's root directory
3. **Test Access**: Ensure file is accessible via HTTP
4. **Verify**: Click verify in the Inhouse dashboard
**File Location:** `https://yourdomain.com/inhouse-verification.txt`
Verify through domain email (if available):
1. **Enter Email**: Use an email address associated with your domain
2. **Check Email**: Look for verification email from Inhouse
3. **Click Link**: Click the verification link in the email
4. **Complete**: Domain is automatically verified
## DNS Configuration
### Required DNS Records
After verification, configure these DNS records for your domain:
#### CNAME Record (Required)
```bash theme={null}
# Route all traffic to Inhouse
CNAME @ your-inhouse-domain.com
# Or route specific subdomain
CNAME links your-inhouse-domain.com
```
#### A Record (Alternative)
```bash theme={null}
# If CNAME doesn't work, use A record
A @ 192.168.1.1 # Inhouse IP address
```
#### Additional Records
```bash theme={null}
# MX Record (if using domain for email)
MX @ 10 mail.yourdomain.com
# TXT Record (for SPF, DKIM, etc.)
TXT @ "v=spf1 include:_spf.google.com ~all"
```
### DNS Provider Examples
#### Cloudflare
1. **Login to Cloudflare**: Access your Cloudflare dashboard
2. **Select Domain**: Choose the domain you want to configure
3. **Go to DNS**: Navigate to the DNS section
4. **Add Records**: Add the required CNAME or A records
5. **Set Proxy Status**: Set to DNS only (gray cloud)
#### GoDaddy
1. **Login to GoDaddy**: Access your GoDaddy account
2. **Manage DNS**: Go to your domain's DNS management
3. **Add Records**: Add the required CNAME or A records
4. **Save Changes**: DNS changes are applied immediately
#### AWS Route 53
1. **Access Route 53**: Go to AWS Route 53 console
2. **Select Hosted Zone**: Choose your domain's hosted zone
3. **Create Records**: Add the required CNAME or A records
4. **Set TTL**: Use default TTL or set custom value
## Domain Testing
### Verification Steps
After configuring DNS, test your domain setup:
1. **DNS Propagation**: Wait for DNS changes to propagate (up to 48 hours)
2. **Test Domain**: Try accessing your domain in a browser
3. **Check Redirects**: Verify links redirect correctly
4. **Test Analytics**: Ensure tracking data is being collected
### Testing Tools
Use these tools to verify your domain configuration:
* **DNS Checker**: Verify DNS propagation globally
* **Ping Tool**: Test domain resolution
* **SSL Checker**: Verify HTTPS configuration
* **Redirect Checker**: Test link redirections
## Domain Management
### Multiple Domains
Manage multiple domains for different purposes:
* **Primary Domain**: Main domain for your links
* **Secondary Domains**: Additional domains for specific campaigns
* **Geographic Domains**: Country-specific domains
* **Brand Domains**: Different brands or products
### Domain Settings
Configure domain-specific settings:
* **Default Domain**: Set which domain to use for new links
* **Domain Aliases**: Create alternative domain names
* **SSL Configuration**: Enable/disable HTTPS enforcement
* **Custom Error Pages**: Set custom 404 and error pages
## Security and SSL
### HTTPS Configuration
Ensure secure connections for your domains:
* **Automatic SSL**: Inhouse provides automatic SSL certificates
* **SSL Enforcement**: Redirect HTTP to HTTPS
* **HSTS Headers**: Enable HTTP Strict Transport Security
* **Certificate Monitoring**: Monitor SSL certificate expiration
### Security Best Practices
* **Regular Monitoring**: Check domain health regularly
* **SSL Validation**: Ensure SSL certificates are valid
* **DNS Security**: Use DNSSEC if available
* **Access Control**: Limit who can modify domain settings
## Troubleshooting
### Common Domain Issues
* Check DNS configuration
* Verify domain verification
* Test DNS propagation
* Contact domain registrar
* Wait for SSL certificate generation
* Check domain verification status
* Verify DNS configuration
* Contact support if issues persist
* DNS changes can take up to 48 hours
* Use DNS checking tools to verify
* Clear browser cache and DNS cache
* Test from different locations
### Advanced Troubleshooting
#### DNS Resolution Issues
```bash theme={null}
# Check DNS resolution
nslookup yourdomain.com
dig yourdomain.com
# Check specific record types
dig CNAME yourdomain.com
dig A yourdomain.com
```
#### SSL Certificate Issues
```bash theme={null}
# Check SSL certificate
openssl s_client -connect yourdomain.com:443 -servername yourdomain.com
# Verify certificate chain
openssl x509 -in certificate.crt -text -noout
```
## Best Practices
### Domain Strategy
1. **Choose Memorable Names**: Use short, memorable domain names
2. **Brand Consistency**: Align domains with your brand
3. **Geographic Considerations**: Use country-specific domains if needed
4. **Future Planning**: Consider long-term domain strategy
### Technical Setup
1. **DNS Management**: Use reliable DNS providers
2. **SSL Configuration**: Always use HTTPS
3. **Monitoring**: Set up domain health monitoring
4. **Backup Plans**: Have alternative domains ready
### Maintenance
1. **Regular Checks**: Monitor domain health monthly
2. **SSL Renewal**: Track SSL certificate expiration
3. **DNS Updates**: Keep DNS records current
4. **Performance Monitoring**: Track domain performance
## Next Steps
Configure deep linking for your domains.
Manage your project configuration.
Start creating links with your custom domain.
Automate domain management via API.
**Need help with domains?** Check our [API documentation](https://api.tryinhouse.co/docs) or contact [support@tryinhouse.co](mailto:support@tryinhouse.co).