What Is White-Label?
As a white-label holder you run your own branded instance of the Viraloo giveaway platform. Your clients log in under your domain and see your brand — your name, logo, and colors — while Viraloo powers everything behind the scenes.
You manage clients and their campaigns through the Portal Admin panel, and configure branding, email, and billing independently from the main Viraloo platform.
Portal Admin Dashboard
Access your portal at https://yourdomain.com/portal-admin.
| KPI Card | What it shows |
|---|---|
| Total Clients | All white-label users on your portal |
| Total Campaigns | All campaigns created by your clients |
| Active Campaigns | Campaigns currently live |
| Total Participants | Combined entry count across all client campaigns |
Client Management
Go to Portal Admin → Users (/portal-admin/users).
Add a Client
- Click Add Client
- Fill in name, email, password, and plan
- Click Create — client receives welcome email and can log in immediately
Edit a Client
- Click Edit next to any client
- Update name, email, plan, or password
- Suspend the account if needed → Save
Suspend / Reactivate
Suspending blocks login while preserving all data. Use this for non-payment, terms violations, or accounts on hold. Reactivating restores full access immediately.
Campaign Oversight
Go to Portal Admin → Campaigns (/portal-admin/campaigns) to see every campaign across all clients — filterable by client, status, and date. Monitor participant counts and referral activity from here.
Portal Settings
Go to Portal Admin → Settings (/portal-admin/settings). All settings here apply only to your white-label portal — they do not affect the main Viraloo platform or other portals.
🏷 Brand
| Setting | Description |
|---|---|
| Portal / Brand Name | Appears in navigation, emails, and browser tab |
| Logo URL | Your logo image (transparent PNG recommended, min 200px wide) |
| Accent Color | Primary brand color — hex, e.g. #6366f1 |
| Favicon URL | Browser tab icon |
| Tagline | Short descriptor on the login/register page |
✉️ SMTP / Email
| Field | Description |
|---|---|
| Host | SMTP hostname (e.g. smtp.mailgun.org) |
| Port | 587 for TLS, 465 for SSL |
| Username / Password | SMTP credentials |
| Encryption | tls or ssl |
| From Name | Sender name (e.g. Acme Giveaways) |
| From Email | Sender address (e.g. no-reply@yourdomain.com) |
💳 Stripe
Connect your own Stripe account so client subscription revenue goes directly to you.
| Field | Where to find it |
|---|---|
| Publishable Key | Stripe Dashboard → Developers → API keys |
| Secret Key | Stripe Dashboard → Developers → API keys |
| Webhook Secret | Stripe Dashboard → Webhooks → your endpoint → Signing secret |
Stripe webhook setup:
- Stripe: Developers → Webhooks → Add endpoint
- Endpoint URL:
https://yourdomain.com/billing/webhook
- Events:
checkout.session.completed,customer.subscription.*,invoice.* - Copy the Signing secret → paste into the Webhook Secret field
📋 Email Templates
| Template | When sent |
|---|---|
| Welcome | New client registers |
| Password Reset | Client requests password reset |
| Campaign Joined | Participant enters a campaign |
| Referral Earned | A referral generates a bonus entry |
| Winner | Campaign winner selected |
| Team Invite | Client invites a collaborator |
| Double Opt-In | Opt-in confirmation flow |
| Unsubscribed | Participant unsubscribes |
| Milestone Alert | Campaign hits a participant milestone |
Available template variables: {{name}} {{email}} {{campaign_title}} {{campaign_url}} {{brand_name}} {{referral_link}} {{winner_prize}}
🤖 Autoresponders
Connect an external ESP for clients to use with their campaigns — enabling automatic list-building when participants enter a giveaway. Configure credentials here so clients can link their own ESP accounts from their settings page.
WordPress Plugin for Clients
Walk clients through these steps to embed campaigns on WordPress:
- Download the plugin from their dashboard → Download Plugin
- WordPress: Plugins → Add New → Upload Plugin
- Go to Settings → Viraloo Campaigns
- Set Viraloo Site URL to your portal domain (e.g.
https://yourdomain.com) - Paste their Sync Token → Save → Sync Campaigns
viraloo.org) as the site URL so API calls route to your installation.Client Onboarding Checklist
Portal setup (one-time)
- Configure Brand settings (name, logo, accent color, favicon)
- Set up SMTP and send a test email
- Connect Stripe and configure the webhook
- Customize email templates with your brand name
- Set up autoresponder integration if needed
Per new client
- Create account via Portal Admin → Add Client
- Assign the correct plan
- Share login credentials securely
- Send plugin download link and step-by-step setup instructions
Plans & Limits
Each client is assigned a plan controlling usage limits (max campaigns, participants per campaign, features). Plan tiers are set at the platform level by the super-admin. You can assign or change any client's plan at any time via the edit screen.
Support & Escalation
As a white-label holder, you are the first line of support for your clients. Escalate to Viraloo only for platform-level bugs, outages, or billing issues with your own Viraloo account.
Key URLs Reference
| URL | Purpose |
|---|---|
/portal-admin | Portal admin dashboard |
/portal-admin/users | Client list |
/portal-admin/campaigns | All client campaigns |
/portal-admin/settings | Portal configuration |
/register | Client self-registration (if enabled) |
/billing/webhook | Stripe webhook endpoint |