LostChurn Docs

The customer-facing recovery portal is where your subscribers update payment methods, view billing history, and complete recovery flows. This guide covers how to customize the portal to match your brand.

Accessing Portal Settings

Navigate to Dashboard > Settings > Portal
The portal settings page shows a live preview alongside configuration options

Changes are saved automatically and reflected in the preview in real time.

Page Visibility

Control which pages your customers can access through the portal. Toggle each page on or off:

Page	Description	Default
Payment Methods	Add, update, or remove cards and bank accounts	Enabled
Billing History	View past invoices and payment attempts	Enabled
Usage Summary	See current-period usage for metered subscriptions	Disabled
Identity Verification	Verify identity before processing high-value updates	Disabled

Disabling a page removes it from the portal navigation. If a customer visits a disabled page URL directly, they see a friendly "Page not available" message.

Recovery Page Copy

Customize the text customers see on the payment recovery page — the primary page linked from recovery emails and SMS messages.

Field	Description	Default
Page title	Heading at the top of the recovery page	"Update Your Payment Method"
Description	Explanatory text below the title	"We had trouble processing your last payment. Please update your payment details to keep your subscription active."
CTA button text	Text on the primary action button	"Update Payment Method"
Success message	Confirmation shown after a successful update	"Payment method updated successfully. Your subscription is now active."

Localization

If you have Localization enabled, you can provide translations for each field. The portal automatically displays the correct language based on the customer's preferred_locales setting from their payment processor profile.

Branding

Make the portal feel like a natural extension of your product:

Logo

Upload your logo (SVG, PNG, or JPG — max 2 MB). The logo appears in the portal header and on email recovery pages.

Accent Color

Set a primary accent color used for buttons, links, and focus states. Enter a hex value or use the color picker.

Accent color: #6366F1

The portal automatically generates hover, active, and disabled variants from your accent color.

Footer Text

Customize the footer text displayed at the bottom of every portal page. This is a good place for your company name, support link, or legal text.

Default: "© 2026 Your Company. Need help? Contact support@yourcompany.com"

"Powered by LostChurn" Badge

By default, a small "Powered by LostChurn" badge appears in the portal footer. You can toggle this off on Recovery and Command plans.

Plan	Badge Removable?
Engine	No
Recovery	Yes
Command	Yes (removed by default)

Custom CSS

For advanced styling beyond the built-in options, inject custom CSS:

Navigate to Settings > Portal > Advanced
Enter your CSS in the Custom CSS editor

/* Example: Custom font and rounded corners */
:root {
  --portal-font-family: "Inter", sans-serif;
  --portal-border-radius: 12px;
}

.portal-card {
  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.08);
}

.portal-header {
  background: linear-gradient(135deg, #6366f1, #8b5cf6);
}

Custom CSS is injected after the default styles. Avoid overriding structural layout properties (display, position, grid-template) as these may break the portal's responsive layout.

White-Label (Command Plan)

On the Command plan, you can fully white-label the portal:

Remove all LostChurn branding — no badge, no references to LostChurn anywhere in the portal
Custom domain — serve the portal from your own subdomain (e.g., billing.yourcompany.com) instead of portal.lostchurn.com
Custom email sender — recovery emails come from your domain with no LostChurn headers

To set up a custom domain:

Go to Settings > Portal > White-Label
Enter your desired subdomain
Add the provided CNAME record to your DNS
Wait for DNS propagation (typically under 10 minutes)
LostChurn automatically provisions an SSL certificate

White-label features require the Command plan. See Pricing for plan details. If you need white-label on a different plan, contact sales@lostchurn.com.

Preview Your Portal

Before publishing changes, use the built-in preview:

Click Preview Portal in the top-right of the settings page
A new tab opens showing the portal as your customers will see it
The preview uses sandbox data — no real customer information is displayed
Test the full flow: navigate between pages, submit a test payment update, and verify the success message

You can also share the preview link with your team for feedback. Preview links expire after 24 hours.

Next Steps

Set up Payment Update Links to include personalized portal URLs in recovery emails
Configure your Sender Domain so recovery emails come from your brand
Explore Campaign Builder to customize the recovery flow that leads to the portal

Portal Customization