Partner Guide·Reference

White-Label Your Tenants

Brand inheritance, custom domain, what tenants see, white-labeling this manual.

What's actually white-labeled

When a tenant logs into the platform, here's what they see based on your branding:

Surface What's branded What stays neutral
Dashboard header Your logo, your brand name The actual UI controls (button styles, layouts)
Login page Your logo, your brand name (when accessed via your subdomain or custom domain) The form itself
Email notifications Sent from your brand email, signed with your brand name Email infrastructure (DKIM/SPF aligns to your domain if custom domain is set)
Invoices Your logo, brand name, support email, custom statement descriptor on cards Invoice numbering format, line items
Help center (this!) Your logo and name in the chrome The screenshots and instructions (those show the actual platform)
Browser tab title Your brand name (e.g., "ACME Phones — Dashboard")

Things tenants never see:

  • The platform's name in normal use
  • Other partners' names
  • Other tenants' anything
  • Internal admin tools

Where to set everything

Settings (in the top nav) has six tabs. The first three matter for branding:

Tab 1 — Company

The legal and admin info attached to your account:

  • Company Name — your legal business name. Shows in account settings, internal invoices, and as a fallback if Brand Name is empty.
  • Billing Email — where we email you (your monthly subscription invoice, alerts about your account).

This isn't customer-facing. It's about how we identify you internally.

Tab 2 — Branding

The customer-facing identity:

  • Logo — drop or browse. SVG is best, PNG is fine, JPG works (no transparency). Displayed at ~32px tall in the dashboard header. Test it at small sizes.
  • Primary Color — the accent color throughout the dashboard. Buttons, links, the active-page indicator. Pick a color with good contrast against white and against light grey.
  • Brand Name — what your customers see everywhere. Defaults to Company Name if blank.
  • Brand From Email — the "from" address on emails to your tenants (invoices, alerts, password resets). Use a noreply address you control. If your domain isn't custom-set up here yet, emails will come from a generic platform-managed address with your brand name in the display.
  • Brand Support Email — where customers go for help. Shows on invoices, in error messages, in password reset emails. Use an inbox you actively monitor.

Tab 3 — Domain

Your custom domain. Optional but recommended.

Without a custom domain, your tenants access the platform at yourbrand.simuwave.com. Functional but breaks the white-label illusion at the URL bar.

With a custom domain, they use phones.yourbrand.com or whatever you choose. Setup:

  1. Pick a hostname. Common patterns: phones.yourbrand.com, voip.yourbrand.com, pbx.yourbrand.com. Subdomain on your existing domain is easiest.
  2. Enter the hostname in the Custom Domain field. Click Save.
  3. The page now shows you a target IP and DNS instructions. Add an A record (or CNAME to a target hostname we provide) at your DNS provider.
  4. Click Check Domain Status. Status flips PENDING → VERIFYING → ACTIVE within a few minutes once DNS propagates.
  5. SSL is automatic. We use Let's Encrypt; certificates issue within ~10 minutes of the domain reaching ACTIVE status.
  6. Once ACTIVE, tenants accessing your custom domain see your branded portal. The old yourbrand.simuwave.com URL still works as a fallback.

Tab 4 — Notifications

Toggle which alerts you receive:

  • New tenant signups
  • Usage limit alerts
  • Monthly reports
  • System updates / maintenance windows

These auto-save when you toggle.

Tab 5 — Integrations

Reserved. Future home for HubSpot, Salesforce, Zapier connectors.

Tab 6 — Account

Your password, 2FA setup, and account deletion.

Account deletion is irreversible and only works if you have zero tenants and zero outstanding balance. To delete, you'll need to delete all tenants first, then settle final invoices, then come here. The button requires typing "DELETE" to confirm.

Brand inheritance

What your tenants see on each surface:

Surface Source
Tenant dashboard header Partner's Brand Name + Logo + Primary Color
Tenant dashboard chrome Partner's Primary Color (buttons, links)
Tenant invoices Partner's Brand Name + Logo + Support Email
Tenant emails Partner's Brand From Email + Brand Name signature
Tenant credit-card statements Partner's Statement Descriptor
Tenant help center Partner's Brand Name + Logo (this very document, when viewed via your domain, shows YOUR brand!)

Tenants never see the platform name unless they go looking for it (it's mentioned in the legal terms and in technical support emails).

How to white-label this very help center for your tenants

Yes. The help center white-labels itself.

When a tenant opens help.[your-custom-domain] (or [your-subdomain].simuwave.com/help), the platform detects which partner subdomain or custom domain the request came in on, looks up your brand, and substitutes:

  • Your logo in the top-left
  • Your brand name in the header
  • Your primary color in accents and links
  • Your support email in the footer
  • Your brand name on the PDF cover

The actual content — the screenshots, the instructions — stays the same. (Your tenants are using the same dashboard you are; the screenshots show that dashboard. The branding wrapper around them changes.)

This works automatically. You don't configure anything per-manual. As soon as your branding is set in Tab 2 above, the help center reflects it.

If you want a tenant-only entry point, link to [your-domain]/help/tenant from inside the tenant dashboard, or include the link in your welcome email when you onboard a new tenant.

Email deliverability — the gotcha

Outbound emails from the platform default to a generic platform-managed sender with your brand name displayed. Most email providers (Gmail, Outlook) deliver these fine, but they're occasionally flagged as suspicious because the displayed name and the technical sender domain don't match.

For best deliverability, set up your own email infrastructure to align with your custom domain. Specifically:

  • Add SPF and DKIM records at your DNS provider
  • Configure DMARC to monitor (not reject yet)

Open a support ticket and we'll guide you through the specifics for your domain — it's one-time setup, takes ~30 minutes, and dramatically improves email deliverability.

What white-labeling doesn't cover

  • The mobile soft-phone apps (if your tenants use them) are still branded with the app maker's name. We don't yet offer a white-label mobile app.
  • Phone provisioning files for desk phones contain technical SIP server hostnames that aren't your domain. End users don't see this; only the IT person setting up the phone does.
  • Carrier-side caller ID (CNAM) is a separate system; it shows whatever name your tenant set on each DID, not your brand.