Coming SoonCustom domain support is planned for a future release. Currently, landing pages are hosted on Fanfare subdomains.
Default Domain Structure
Landing pages are hosted on Fanfare infrastructure:
https://[org-slug].fanfare.io/[experience-slug]/[page-slug]
https://acme.fanfare.io/summer-drop/register
URL Components
| Component | Description | Example |
|---|
| org-slug | Your organization’s subdomain | acme |
| experience-slug | Experience identifier | summer-drop |
| page-slug | Landing page identifier | register |
Custom Domains (Coming Soon)
When custom domains launch, you will be able to:
Host on Your Domain
https://drop.your-brand.com
https://your-brand.com/drops/summer
Subdomain Configuration
Use a dedicated subdomain:
- Choose subdomain (e.g.,
drop.your-brand.com)
- Add CNAME record pointing to Fanfare
- Verify ownership
- SSL automatically provisioned
Type: CNAME
Host: drop
Value: custom.fanfare.io
TTL: 3600
Apex Domain (Root)
For root domains, use A records:
Type: A
Host: @
Value: [Fanfare IP addresses]
TTL: 3600
Apex domain configuration requires DNS provider support for ALIAS/ANAME records or static IP pointing.
SSL/TLS Configuration
All landing pages are served over HTTPS:
Default (Fanfare Subdomains)
- SSL included automatically
- Managed by Fanfare
- Auto-renewing certificates
Custom Domains (Coming Soon)
- Automatic SSL provisioning via Let’s Encrypt
- Certificate management handled by Fanfare
- No manual certificate uploads required
Domain Verification
When adding a custom domain:
Step 1: Add Domain
Enter your custom domain in settings:
Domain: drop.your-brand.com
Step 2: DNS Configuration
Add required DNS records:
# Verification record
Type: TXT
Host: _fanfare-verification
Value: fanfare-verify=abc123xyz
# CNAME record
Type: CNAME
Host: drop
Value: custom.fanfare.io
Step 3: Verification
Fanfare verifies:
- TXT record present (ownership)
- CNAME points correctly (routing)
- SSL can be provisioned
Step 4: Activation
Once verified:
- Domain becomes active
- SSL certificate issued
- Traffic routes to your landing page
Multiple Domains
Support for multiple custom domains per organization:
| Domain | Experience |
|---|
summer.brand.com | Summer Drop 2024 |
vip.brand.com | VIP Access Portal |
events.brand.com | Event Registration |
URL Redirects
Planned Redirect Features
| Type | Description |
|---|
| Slug change | Redirect old slug to new |
| Domain migration | Old domain to new domain |
| Experience end | Redirect after experience ends |
| Custom rules | Pattern-based redirects |
Redirect Configuration
{
redirects: [
{
from: "/old-slug",
to: "/new-slug",
type: "permanent", // 301
},
{
from: "/summer-2023",
to: "https://archive.brand.com/summer-2023",
type: "permanent",
},
];
}
Current Workarounds
Using Your Own Domain with Proxy
Until custom domains are supported, use a reverse proxy:
Cloudflare Workers
export default {
async fetch(request) {
const url = new URL(request.url);
// Rewrite to Fanfare
url.hostname = "your-org.fanfare.io";
return fetch(new Request(url, request));
},
};
Nginx Proxy
server {
listen 443 ssl;
server_name drop.your-brand.com;
location / {
proxy_pass https://your-org.fanfare.io;
proxy_set_header Host your-org.fanfare.io;
proxy_set_header X-Real-IP $remote_addr;
}
}
Proxy setups require careful configuration to avoid breaking cookies, sessions, and security headers.
URL Shorteners
For marketing, use shortened URLs:
bit.ly/your-drop → https://acme.fanfare.io/summer-drop/register
QR Codes
Generate QR codes pointing to Fanfare URLs:
- Works with default domains
- Update destination without reprinting
DNS Provider Guides
Cloudflare
- Go to DNS settings
- Add CNAME record
- Enable “Proxy” for additional features (optional)
GoDaddy
- Go to DNS Management
- Add new CNAME record
- Save changes (propagation: 24-48h)
Namecheap
- Advanced DNS settings
- Add new CNAME record
- TTL: Automatic
AWS Route 53
- Hosted zone for your domain
- Create record set
- Type: CNAME
- Value: custom.fanfare.io
Troubleshooting
DNS Not Propagating
| Issue | Solution |
|---|
| Still showing old site | Wait up to 48 hours for propagation |
| Intermittent | Lower TTL before making changes |
| Wrong destination | Verify CNAME value is correct |
SSL Errors
| Error | Cause | Solution |
|---|
| Not secure | SSL not yet provisioned | Wait 10-30 minutes after DNS verification |
| Certificate mismatch | Wrong domain in certificate | Verify domain configuration |
| Mixed content | HTTP resources on HTTPS page | Update all resource URLs to HTTPS |
Verification Failing
| Issue | Solution |
|---|
| TXT record not found | Ensure record host is _fanfare-verification |
| CNAME not found | Verify CNAME points to custom.fanfare.io |
| Timeout | Check DNS propagation status |
Next Steps
