Custom Subdomain

Give your workspace a branded login experience at your-company.conferbot.com. Your team and customers see your logo, colors, and background — not Conferbot’s.

How It Works

Every Conferbot workspace can claim a unique slug (e.g. acme-corp). Once saved, the slug is used as a subdomain:

• Login page: https://acme-corp.conferbot.com/login
• Dashboard: https://acme-corp.conferbot.com

Visitors landing on your subdomain automatically see your branded login page with your custom logo, colors, background media, tagline, and optional ad banners.

Prerequisites

• A Conferbot account on any paid plan (Starter or above).
• Admin access to your workspace.

Step 1: Choose Your Subdomain

1. Log in to your Conferbot dashboard.
2. Navigate to Workspace → Branding tab.
3. Scroll to the Custom Subdomain section.
4. Enter your desired slug (e.g. acme-corp). The preview will show acme-corp.conferbot.com.
5. Wait for the availability check (runs automatically as you type).
6. Click Save Subdomain when the green checkmark appears.

Step 2: Customize Your Branding

On the same Branding tab, configure the look and feel of your branded login page:

Step 3: Share Your Branded URL

Once your subdomain and branding are configured, share your login URL with your team:

https://your-slug.conferbot.com/login

All authentication methods are supported on subdomains — email/password, OTP, magic link, and Google OAuth (via secure proxy popup).

Background Media Gallery

Upload up to 10 images or videos as login page backgrounds. Media items rotate automatically with a crossfade transition.

Background Display Settings

Ad Click Analytics

Track how visitors interact with ad banners on your login page. Available on Pro plans and above.

GET /api/v1/workspace/ad-analytics

// Response
{
  "totalClicks": 342,
  "uniqueVisitors": 189,
  "daily": [
    { "date": "2024-12-01", "clicks": 12 },
    { "date": "2024-12-02", "clicks": 18 }
  ],
  "devices": [
    { "device": "desktop", "count": 210 },
    { "device": "mobile", "count": 120 },
    { "device": "tablet", "count": 12 }
  ],
  "browsers": [
    { "browser": "Chrome", "count": 180 },
    { "browser": "Safari", "count": 90 }
  ]
}

Organization Details

Add metadata about your organization. This information is included in the public branding response and helps personalize your workspace.

API Reference

You can also manage subdomains and branding programmatically using the REST API.

Check Slug Availability

No authentication required.

GET /api/v1/workspace/check-slug/:slug

Response:

{
  "available": true,
  "slug": "acme-corp"
}

// Or if unavailable:
{
  "available": false,
  "reason": "Slug is already taken",
  "slug": "acme-corp"
}

Update Workspace Slug

Requires authentication. Admin role only.

PUT /api/v1/workspace/slug
Content-Type: application/json
x-api-key: YOUR_API_KEY

{
  "slug": "acme-corp"
}

{
  "message": "Slug updated",
  "slug": "acme-corp"
}

Get Public Branding

No authentication required. Used by the login page to fetch branding for a given subdomain.

GET /api/v1/workspace/public/branding/:slug

{
  "slug": "acme-corp",
  "displayName": "ACME Corporation",
  "workspaceId": "ws_12345",
  "branding": {
    "loginLogo": "https://cdn.conferbot.com/...",
    "primaryColor": "#4F46E5",
    "secondaryColor": "#3b82f6",
    "tagline": "Build amazing chatbots",
    "activeLoginMedia": {
      "mediaUrl": "https://cdn.conferbot.com/...",
      "mediaType": "image",
      "adUrl": "https://example.com",
      "adLabel": "Sponsored"
    }
  },
  "organization": {
    "description": "...",
    "website": "https://acme.com"
  }
}

Validation Rules

Troubleshooting

Slug shows as unavailable

The slug may be taken by another workspace, be a reserved word, or fail a format rule. Try a different variation (e.g. add your company’s initials or a region code).

Google login not working on subdomain

Google OAuth on subdomains uses a secure proxy popup. Ensure your browser allows popups for *.conferbot.com. The popup opens briefly on the main domain, completes the OAuth flow, and passes the token back.

Branding not showing on subdomain

After saving branding changes, hard-refresh the subdomain login page (Ctrl+Shift+R / Cmd+Shift+R). Branding is fetched fresh on each page load but may be cached by your browser.

Next Steps