Skip to main content

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​

Replaces "Powered by Knock Knock" on the embedded widget. On companies.widget_whitelabel:

FieldWhat
is_enableTurn the custom footer on
texte.g. "Powered by YourBrand"
urlLink 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.

  1. Agency adds the domain in Agency → White-Label Domains (POST /agency-domains). Agency staff can add domains too (the controller resolves the agency via getAgency, which handles agency_staff); the add-domain form validates the domain client-side.
  2. The platform requests a certificate and returns DNS validation records (dns[]: key ownership/dns, type, name host-only CNAME, value, status pending→active).
  3. Agency adds the CNAME(s) at their registrar (host-only format works across providers).
  4. A periodic job checks validation; status flips to active (GET /agency-domains/:id/check-status).
  5. 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.

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_name renames 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, frontend 96b2ff1e): hardcoded "Knock Knock" strings replaced with brandingName in 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, use useAppBranding, 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_prefix renames 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 status is active via check-status.
  • Fixed callback domains: some Stripe webhooks and OAuth redirects use a fixed knockknockapp.ai domain — 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/:domain and /agency/branding/:agency_id); branding edited via AgencyController (PUT /agencies/:id).
  • Frontend: frontend/src/views/agency/WhiteLabelDomains.vue, settings/{Layout,Agency}.vue, views/partner/Listing.vue; widget PoweredByLogo.vue.
  • Desktop: build-time flag — see /services/desktop and Desktop App.
  • See Agency Overview and backend service.