Platform Settings
Configure every aspect of your SaaS platform from a single location. Platform settings control registration, billing, email delivery, authentication, theming, branding, and access.
Accessing Platform Settings
Go to Super Admin > Platform Settings to access all configuration tabs.
General Settings
The General tab controls core platform behavior:
| Setting | Description |
|---|---|
| Platform Name | The name of your SaaS platform |
| Platform Description | A short description of your platform |
| Registration Mode | Open — anyone can sign up. Invite Only — only invited users can create accounts |
| Free Trial Enabled | Toggle whether new tenants get a free trial |
| Default Trial Days | Number of days for the free trial period |
| Default Plan | The plan assigned to new tenants after trial or on signup |
| Free Trial Plan | The plan tenants are assigned during their trial period |
Stripe Integration
The Stripe tab connects your platform to Stripe for payment processing.
API Keys
| Setting | Description |
|---|---|
| Publishable Key | Your Stripe publishable key (starts with pk_) |
| Secret Key | Your Stripe secret key (starts with sk_) |
| Webhook Secret | Your Stripe webhook signing secret (starts with whsec_) |
All keys are stored encrypted in the database.
Webhook URL
Set your Stripe webhook endpoint to:
https://yourdomain.com/api/stripe/webhook
Setup Steps
- Create a Stripe account if you don't have one
- Get your API keys from the Stripe Dashboard (Developers > API Keys)
- Add a webhook endpoint in Stripe (Developers > Webhooks) pointing to your webhook URL
- Copy the webhook signing secret from Stripe
- Enter all three values (Publishable Key, Secret Key, Webhook Secret) in Votlie
Make sure to use your live keys for production and test keys for development. Stripe test keys start with pk_test_ and sk_test_.
Email Configuration
The Email (SMTP) tab configures platform-wide email delivery. This uses the same SMTP fields as board-level email configuration (host, port, username, password, from address, encryption).
This is the default email configuration for the entire platform. Individual tenants can override these settings with their own SMTP credentials from their board settings.
Email Logs
The Email Logs tab provides visibility into email delivery:
- 30-day statistics — delivery success rate and volume
- Recent entries — individual email send attempts with status
- Filters — filter logs by status (sent, failed, pending) or recipient
Authentication
The Authentication tab configures social login providers at the platform level.
Available Providers
| Provider | Fields |
|---|---|
| Client ID, Client Secret | |
| GitHub | Client ID, Client Secret |
| Discord | Client ID, Client Secret |
| Slack | Client ID, Client Secret |
For each provider:
- Enter the Client ID and Client Secret from the provider's developer console
- Toggle Enable/Disable to control availability
- Click Test to verify the credentials work
Platform-level authentication settings apply to all tenant boards by default. Individual tenants can override these with their own OAuth credentials from their board settings.
Theme & Branding
Theme
The Theme tab sets the default theme for new tenant boards.
Choose from 12 presets:
| Default | Ocean | Emerald | Orange |
| Purple | Minimal | Cyan | Yellow |
| Teal | Pink | Violet | Custom |
Each preset includes both light and dark mode palettes. You can also configure the font selection for your platform.
Use the Apply to all existing tenants option to push the selected theme to every current tenant board.
Branding
The Branding tab configures platform-level branding assets:
| Setting | Description |
|---|---|
| Light Mode Logo | Logo displayed on light backgrounds |
| Dark Mode Logo | Logo displayed on dark backgrounds |
| Favicon | Small icon shown in browser tabs |
| Logo Icon | Compact icon version of your logo |
These assets are used on the landing page, login page, and serve as defaults for new tenant boards.
Landing Page
The Landing Page tab lets you customize the public-facing landing page of your SaaS platform.
| Section | What You Can Edit |
|---|---|
| Hero | Headline, subheadline, and call-to-action button |
| Features | Feature highlights with titles and descriptions |
| Pricing | Plan cards pulled from your plan configuration |
| FAQ | Frequently asked questions and answers |
| Footer | Footer links and content |
Access & Maintenance
The Access & Maintenance tab controls platform availability and access methods.
| Setting | Description |
|---|---|
| Maintenance Mode | When enabled, tenants see a maintenance page instead of their board |
| Allowed IPs | IP addresses that can still access the platform during maintenance |
| Tenant Access Method | How tenants access their boards |
Tenant Access Methods
| Method | Description |
|---|---|
| Subdomain | Tenants access via tenant.yourdomain.com |
| Path-based | Tenants access via yourdomain.com/tenant |
| Both | Both subdomain and path-based access are supported |
License
The License tab shows your Extended License status. You can:
- View your current license details
- Check license validity
- Deactivate the license if needed
Updates
The Updates tab displays:
- Current version of the platform
- System specs (PHP version, database, server info)
- Update history showing previously applied updates
Next Steps
- Super Admin Team & Roles - Manage your platform operations team