Custom Owner Portal

Custom owner portal domains are available through a support-managed pilot. Submit a custom support request before changing DNS. Support confirms availability and supplies the exact records for your team. Support configures the feature without a customer-specific application release. A domain does not grant access: owners still need an invitation and permission to view their statements.

What to provide

• Your team ID and desired subdomain, such as owners.example.com.
• A DNS administrator who can add the records supplied by support.
• Your company display name, at most 60 characters.
• A square PNG logo, at most 512 × 512 pixels and 200 KB, for upload to our asset storage.
• A primary colour from the existing UI palette, or a colour for contrast review.
• Your company/statement address and support phone, with contact labels at most 80 characters.
• Your requested sender address and an existing, monitored reply-to mailbox.

Support checks that the selected colour has at least 4.5:1 contrast with button text and that the logo fits the fixed layout. Use the existing team settings for logo, colours, company identity and contact details. Changes to the public sign-in brand require support to update the approved public presentation.

Fonts, spacing, positions, layouts and PDF templates cannot be changed. We do not supply a copy of our PDF generator. Existing email content editing remains available. Customer SMTP servers are not supported.

DNS and authentication

Support supplies portal ownership/routing records, a Clerk Frontend API CNAME and the Postmark DKIM and return-path records for your sending domain. Add those exact records and keep them in place. Do not change your existing MX records or add a second SPF record. Clerk's Frontend API CNAME must be DNS-only when using Cloudflare.

Support verifies domain ownership, TLS and sending identity, then tests the portal with a controlled owner account before enabling links in outgoing invitations and statements. Domain setup does not activate customer access automatically.

Sign-in and account creation briefly visit VRPlatform's primary authentication domain, then return to your portal. Clerk satellites share the existing account and session. Owners do not need a separate account for the custom hostname.

Portal and email behaviour

The custom hostname covers the owner portal, statement links, invitation links, calendar, files and supported account features. Features remain subject to your existing settings and each owner's permissions. The custom portal displays only its registered team's profiles. Manager access uses the normal platform portal.

Owner emails use the team's existing logo and name. A requested sender identity is used only after support verifies it. An explicit verified reply-to mailbox receives replies. Statement PDFs keep their existing layout, company/contact details and page numbers. Support can disable the promotional platform footer with showPlatformBranding. Custom sender, name and footer settings apply only while the portal is active; a pending or disabled portal sends platform-branded mail from the platform sender.

Branding delivery to the portal

The portal edge reads approved presentation and routing for a registered hostname from an internal, machine-authenticated API and embeds it into every page it serves; the browser never calls the API for this. The embedded data exposes no owner records, balances or credentials. portalEnabled is false until activation and after disabling the portal, and the edge stops serving the portal in both states. The edge reuses a lookup for up to 30 seconds and the API for up to one minute, so activation changes apply within that window. Embedded presentation does not authorize API requests; authenticated team and owner permissions still apply.

{
  "hostname": "owners.example.com",
  "portalEnabled": true,
  "teamId": "11111111-1111-4111-8111-111111111111",
  "slug": "example-team",
  "dataRegion": "us",
  "name": "Example Company",
  "logo": null,
  "colorPrimary": "#1343CC",
  "showPlatformBranding": false,
  "signInUrl": "https://portal.vrplatform.app/owner-login?owner_portal=owners.example.com",
  "signUpUrl": "https://portal.vrplatform.app/owner-sign-up?owner_portal=owners.example.com"
}

Contact support before removing DNS or changing domains. Previously delivered links need to remain reachable during a domain change.