White-Label
Audience: Sales / Agency-success / Management (engineers for the technical section) · Where in app: Agency → Settings / White-Label Domains · Plan availability: Agency / Enterprise tier (widget-footer-only may be plan-gated for direct customers)
White-label re-brands Knock Knock under an agency's identity across several independent surfaces: the widget footer, a custom portal domain, a custom widget domain, branding (name/logo/colors), the Nox assistant name, transactional emails, and the desktop installer. Each can be enabled independently.
What it does
Lets clients experience the platform as the agency's own product:
- Replace "Powered by Knock Knock" in the widget footer.
- Serve the admin portal and the widget from the agency's own domains.
- Apply the agency name, logo, and theme colors throughout.
- Rename the in-app Nox assistant.
- Brand transactional emails.
- Ship a branded desktop installer.
How it works
Branding values live on the AgencyModel (name, logo_file, theme_colors, nox_name, reply_email). Custom domains are registered as AgencyDomainModel rows; the agency adds DNS records at their registrar, the platform validates them (certificate + DNS), and once active the domain routes to the agency's white-labeled portal. A public branding endpoint (/agency-domains/branding/:domain) returns the name, logo, theme, and Nox name so the frontend can render the agency's look before login. The desktop app's white-label is a separate build-time flag (see Desktop App).
Configuration & options
1. Widget footer
Replaces "Powered by Knock Knock" on the embedded widget. On companies.widget_whitelabel:
| Field | What |
|---|---|
is_enable | Turn the custom footer on |
text | e.g. "Powered by YourBrand" |
url | Link target |
Per-domain overrides are supported for agencies serving many client domains (the widget reads the current host and picks the matching brand).
widget_whitelabel.hide_logo (default false): when the override is on and the agency has a logo_file, every "Powered by" footer renders the agency logo before the text through widget/src/components/PoweredByLogo.vue (6ad5cdb, 14px high, ≤80px wide). The agency flips it with the Agency logo toggle on the client detail page (PUT /company/:id/widget-whitelabel { …, hide_logo }).
2. Custom portal domain (AgencyDomainModel)
Serves the admin dashboard from e.g. app.youragency.com.
- Agency adds the domain in Agency → White-Label Domains (
POST /agency-domains). Agency staff can add domains too (the controller resolves the agency viagetAgency, which handlesagency_staff); the add-domain form validates the domain client-side. - The platform requests a certificate and returns DNS validation records (
dns[]:keyownership/dns,type,namehost-only CNAME,value,statuspending→active). - Agency adds the CNAME(s) at their registrar (host-only format works across providers).
- A periodic job checks validation; status flips to active (
GET /agency-domains/:id/check-status). - The portal serves with agency branding (logo, colors, name, Nox name).
Cookie scope is per-domain, so sessions don't leak between agencies.
3. Custom widget domain
Serves the embeddable widget from e.g. widget.youragency.com so visitors see only the agency's domain in page source / network requests. Same DNS/CNAME pattern; configured per company.
3b. White-label hosts (*.nextlevelai.site)
backend/app/lib/whiteLabelHost.js (be38c58b0) swaps the apex
knock-knockapp.com → nextlevelai.site, subdomain preserved
(api | widget | ai | sessions | communications). forRequest(request, url)
keys off the request host (trust proxy on); forCompany(company_id, url)
keys off agency.script_whitelabel_allowed with a 5-min in-process cache for
cron/webhook paths that have no request. Applied to recording links in
CrmSyncHelper, GhlCallNotePostJob, GhlCallRecordingAttachJob,
CallCompletedWebhookJob, WebCallCompletedWebhookJob,
OutboundCallGhlSyncJob, AiCallGhlTranscriptSyncJob, SimproInvoiceChaseJob,
AiCallContactExtractedController. The widget welcome video is proxied via
/files/:id/get only for script_whitelabel_allowed agencies; everyone
else streams the raw S3 URL (fb3acbd1b). flux-deployments carries an
ingress-nextlevelai.yaml per public service. The old caveat that "DevTools
users can still see Knock Knock API endpoints" no longer holds on the
white-label apex. Frontend routes are brand-neutral with the old paths as
aliases (/settings/assistant, /settings/funnel, /activity), the SDK docs
link points at the app host, and document.title swaps \bNox\b for
appStore.noxName at the router guard.
3c. Links written into tenant CRMs (a6a1e4a7d)
White-label tenants used to see app.knockknockapp.ai / communications.knock-knockapp.com in links we write for them. Now the GHL visit-activity "Session:" link, the Simpro chase fallback link, the GHL sub-account custom-menu link and the Platform API login_url resolve the portal via mail.brandingFor (agency custom domain → white-label portal); the Jobber call-note recording link goes through whiteLabelHost.forCompany. The white-label portal comes from WHITE_LABEL_PORTAL_URL (falls back to portal_url) instead of a hardcoded prod host, so non-prod links stay local; playground invites use it as their no-domain fallback.
4. Branding (name / logo / colors / Nox name)
In Agency → Settings:
- Agency Name — appears on login, sidebar, emails, anywhere the platform name would.
- Logo —
AgencyModel.logo_file. - Theme colors —
theme_colors: primary, secondary, accent, sidebar bg/text, header bg/text. - Assistant name —
nox_namerenames Nox everywhere clients see it (assistant button/panel, replies, Daily Brief email, API/CRM references, and — since 2026-07 — the session details panel,SessionMoreInfoPanel.vue). Applies to all companies under the agency. Frontend resolution:useAppBranding.js(domain branding → logged-in agency store branding → defaults). - Brand-leak sweep (2026-07,
frontend96b2ff1e): hardcoded "Knock Knock" strings replaced withbrandingNamein the dashboard hero, Nox welcome copy, webhook docs, AI call transcript fallback name, and Simpro test-job payload; the Knock Knock social-proof card/testimonial on the packages page is hidden for white-labeled tenants. When adding tenant-facing copy, useuseAppBranding, never the literal product name. - Assistant name on playgrounds — the playground company payload resolves
company.knox.agent_name || agency.nox_name(5d3db85a7); before, a blank playground name showed "NOX" on an agency-branded page. - Prospecting agent name —
AgencyModel.agent_k_name(Prospecting Agent Name) renames Agent K for every client company (f963b8b58). - Contact tag prefix —
AgencyModel.nox_tag_prefixrenames the GHL intent tags; see GHL Integration. - Auto-invite —
AgencyModel.auto_invite_clients(Automatically invite new clients, default on) lives on the same Settings → Agency form; see Managing Companies. - Assistant voice —
AgencyModel.nox_voice_id: agency-picked ElevenLabs voice for Nox voice mode, applied as a per-session TTS override on the shared agent (ms-ai). - Reply Email — sender for automated agency emails.
4b. Implementation Partners listing (fa2fd2728)
Agencies publish into the same public directory feed as certified partners (Settings → Partner Listing, gate agency.manage_settings). Listing fields live in lib/partnerListingSchema.js, shared by PartnerCertificationModel.listing and AgencyModel.partner_listing (includes an optional public email, cf76d92dc, and person_name — agencies only, the individual shown beside the agency name; required on agency save (Your name is required), 60-char limit, pre-filled from the owner's first+last name, searchable and returned on the public directory card, 6ba5e3fc8). lib/partnerListing: isAgencyPublishable, agencyCard (kind: 'agency'), slugs unique across both kinds, publicDirectory lists agencies after certified partners. Endpoints: GET/PUT /agency/partner-listing; super-admin takedown/restore POST /admin/agencies/:id/partner-listing (Partner Listing card on the admin agency detail, standard confirm dialog) — an owner save can't undo a takedown. Frontend reuses views/partner/Listing.vue in agency mode.
5. Email branding
All company-facing system emails are branded (2026-07): a shared backend/app/views/templates/_header-logo.html partial swaps the header icon to the agency logo on a white chip (original icon otherwise), applied across every template including hero-style chat-transcript / daily-recap; footer carries the agency chip. GeneralHelper.app_name(company_id) resolves the product name — gated on company.agency_id: no agency → "Knock Knock", else the agency's name. Sends must pass company_id or white-label resolution never runs (past bugs: BookingController / SubscriptionController omitted it).
Verified-domain links only: email links use the agency's custom portal domain only when the domain has every DNS record status: 'active' (GeneralHelper.getActiveAgencyDomain — dns.every(e => e.status === 'active')), otherwise the shared domain.
6. Desktop app white-label
A build-time flag (WHITE_LABEL=true → __WHITE_LABEL__) produces a branded installer — app name, bundle id, icon, menu links, and update feed all change. Current target brand: Next Level AI (com.nextlevelai.app). Built via npm run build:next / publish:next. See Desktop App.
7. Installable PWA (per-tenant manifest)
The web app is an installable PWA with a per-tenant manifest — name/icon follow the resolved branding (agency logo/name on white-label domains, Knock Knock defaults otherwise), with a standalone-mode title fix. Implemented in frontend/src/App.vue + public/sw.js (commit be0bcc81).
Behaviors & edge cases
- "My custom domain isn't loading" (QA/support): confirm the CNAME points to the documented edge target; TLS provisioning can take a few minutes (DNS up to ~48h to fully propagate); make sure the CNAME isn't proxied behind Cloudflare; check the domain's
statusisactivevia check-status. - Fixed callback domains: some Stripe webhooks and OAuth redirects use a fixed
knockknockapp.aidomain — agencies should disclose this (typically via a DPA). - Email deliverability: DKIM/SPF depend on the agency providing their own domain authentication for outbound email.
- What stays Knock Knock even when fully white-labeled: Stripe receipts (charged via the underlying Stripe account), AI-provider cost attribution (Anthropic/OpenAI/ElevenLabs), and Knock Knock as the underlying data processor.
- Single-company white-label for direct customers: widget-footer-only white-label may be plan-gated (Pro+); full white-label (portal/widget domains, desktop installer) is agency-only.
Plan & limits
- Full white-label is an agency/Enterprise capability.
- Widget-footer-only branding for direct (non-agency) customers is plan-gated — verify which tier.
- The desktop white-label brand is currently Next Level AI — verify if additional agency desktop brands are provisioned.
Technical implementation
- Models:
AgencyModel(name,logo_file,theme_colors,nox_name,agent_k_name,nox_tag_prefix,nox_voice_id,reply_email,partner_listing),AgencyDomainModel(domain, certificate ref,dns[]),companies.widget_whitelabel. - Controller/routes:
AgencyDomainController(/agency-domains*, public/agency-domains/branding/:domainand/agency/branding/:agency_id); branding edited viaAgencyController(PUT /agencies/:id). - Frontend:
frontend/src/views/agency/WhiteLabelDomains.vue,settings/{Layout,Agency}.vue,views/partner/Listing.vue; widgetPoweredByLogo.vue. - Desktop: build-time flag — see /services/desktop and Desktop App.
- See Agency Overview and backend service.