Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.fanfare.io/llms.txt

Use this file to discover all available pages before exploring further.

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]
Example: 
https://acme.fanfare.io/summer-drop/register

​
URL Components

ComponentDescriptionExample
org-slugYour organization’s subdomainacme
experience-slugExperience identifiersummer-drop
page-slugLanding page identifierregister

​
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:
  1. Choose subdomain (e.g., drop.your-brand.com)
  2. Add CNAME record pointing to Fanfare
  3. Verify ownership
  4. 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:
  1. TXT record present (ownership)
  2. CNAME points correctly (routing)
  3. 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:
DomainExperience
summer.brand.comSummer Drop 2024
vip.brand.comVIP Access Portal
events.brand.comEvent Registration

​
URL Redirects

​
Planned Redirect Features

TypeDescription
Slug changeRedirect old slug to new
Domain migrationOld domain to new domain
Experience endRedirect after experience ends
Custom rulesPattern-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

  1. Go to DNS settings
  2. Add CNAME record
  3. Enable “Proxy” for additional features (optional)

​
GoDaddy

  1. Go to DNS Management
  2. Add new CNAME record
  3. Save changes (propagation: 24-48h)

​
Namecheap

  1. Advanced DNS settings
  2. Add new CNAME record
  3. TTL: Automatic

​
AWS Route 53

  1. Hosted zone for your domain
  2. Create record set
  3. Type: CNAME
  4. Value: custom.fanfare.io

​
Troubleshooting

​
DNS Not Propagating

IssueSolution
Still showing old siteWait up to 48 hours for propagation
IntermittentLower TTL before making changes
Wrong destinationVerify CNAME value is correct

​
SSL Errors

ErrorCauseSolution
Not secureSSL not yet provisionedWait 10-30 minutes after DNS verification
Certificate mismatchWrong domain in certificateVerify domain configuration
Mixed contentHTTP resources on HTTPS pageUpdate all resource URLs to HTTPS

​
Verification Failing

IssueSolution
TXT record not foundEnsure record host is _fanfare-verification
CNAME not foundVerify CNAME points to custom.fanfare.io
TimeoutCheck DNS propagation status
Use DNS Checker to verify propagation globally.

​
Next Steps

SEO

Optimize for search engines

Analytics

Track page performance

Preview

Test before publishing

Branding

Customize your page