Platform Settings & Administration
White-label branding, SMTP email, localization, API configuration, WhatsApp, user policies, and payment gateway setup.
Last updated April 17, 2026
Settings Overview
The Settings module provides centralized configuration for branding, email delivery, localization, external APIs, messaging, policies, and payment processing. Each section is accessed via the settings sidebar navigation.
White Label
| Field | Placeholder / Format | Description |
|---|---|---|
| Custom Domain | tenant.company.com | Host only — no http/https prefix. DNS and SSL must point to this application server. |
| Primary Color | Searchable color palette | Selected color is saved as the theme name. Light and dark mode preview available. |
| Favicon (16x16) | PNG, 16×16 pixels | Small icon displayed in browser tabs |
| Favicon (32x32) | PNG, 32×32 pixels | Larger icon displayed in browser tabs and bookmarks |
| Light Logo | PNG/SVG image | Logo used on light backgrounds |
| Dark Logo | PNG/SVG image | Logo used on dark backgrounds |
SMTP Email Configuration
| Field | Placeholder | Description |
|---|---|---|
| SMTP Status | Toggle | Activate or deactivate SMTP email sending |
| Type | NONE / SSL / TLS | Encryption type with helper text explaining each option |
| Host | smtp.example.com | SMTP server hostname |
| Sender Name | Company Notifications | Display name for outgoing emails |
| Port | 587 | SMTP server port number |
| no-reply@company.com | Sender email address | |
| Reply To | support@company.com | Reply-to email address |
| Username | smtp-user | SMTP authentication username |
| Password | Masked input | SMTP authentication password |
The "Validate SMTP" button opens a dialog with a test email field. Enter a recipient address and click "Send Test" to verify the configuration. Success and failure messages are displayed.
Localization
| Setting | Options / Format | Description |
|---|---|---|
| Default Language | 8 languages (en, zh-Hans, hi, es, ar, fr, de, ja) | Loading state while fetching language list |
| Text Direction | LTR / RTL | Affects entire UI layout direction |
| Date Format | Multiple format options | Loading state while fetching format list |
| Time Format | 24-hour clock | Toggle between 12H and 24H display |
| Timezone | UTC offset selection | Loading state while fetching timezone list |
| Units | KM / Miles | Distance unit for all platform displays |
| Map Focus Latitude | -90 to 90 | Default map center latitude |
| Map Focus Longitude | -180 to 180 | Default map center longitude |
| Map Focus Zoom | 1 to 20 | Default map zoom level; quick location presets available |
| Theme | Light / Dark / System | UI color scheme preference |
Live Preview Panel
- Date — shows the current date in the selected format
- Time — shows the current time in the selected format
- Map center — displays the configured lat/lng coordinates
- Zoom — shows the configured zoom level
- Timezone — displays the selected timezone name
- Units — shows the selected distance unit
General Settings
| Setting | Options | Description |
|---|---|---|
| Demo Login | Active / Disabled | Toggle demo login button on the login page |
| Allow Signups | Toggle | Enable or disable self-service user registration |
| Free Credits | Number (placeholder: 100) | Credits granted to new accounts on signup |
| Address Precision | 2 Digits / 3 Digits / City/Region / Street Level | Reverse geocoding precision for address display |
| Database Backup Retention | 1 Mo / 3 Mo / 6 Mo / 1 Yr / 2 Yr / 3 Yr / 5 Yr / 10 Yr | How long database backups are retained |
API Configuration
Reverse Geocoding
Configure reverse geocoding providers with priority ordering, base URL, and API key. Each provider can be validated and set as default. OpenStreetMap Nominatim is available as a free built-in option.
Google Auth SSO
| Field | Description |
|---|---|
| Client ID | Google OAuth 2.0 client identifier |
| Client Secret | Google OAuth 2.0 client secret |
| Redirect URI | Callback URL for OAuth flow |
OpenRouter (AI Agent)
| Field | Description |
|---|---|
| API Key | OpenRouter API key for AI model access |
| Default Model | Primary model selection from model selector dropdown |
| Fallback Models | Backup models used when the default is unavailable |
| Test Chat | Button to verify the API key and model configuration |
WhatsApp API
Test WhatsApp API delivery by entering an E.164 formatted phone number, selecting a template or custom message, and specifying the language code. The test verifies end-to-end delivery through the WhatsApp Business API.
User Policy
| Policy | Description |
|---|---|
| Privacy Policy | Plain text editor with word count for privacy policy content |
| Terms of Service | Plain text editor with word count for terms of service content |
| Cookies Policy | Plain text editor with word count for cookie usage policy |
| Refund Policy | Plain text editor with word count for refund policy content |
Payment Gateway
| Field | Description |
|---|---|
| Gateway Provider | Select payment processor (Razorpay, Stripe, etc.) |
| Mode | Test or Live environment |
| Publishable Key | Client-side publishable/public key |
| Secret Key | Server-side secret key |
| Webhook Secret | Secret for webhook signature verification |
| Webhook URL | Auto-generated URL for payment event callbacks |
| Payment Methods | Toggle individual payment method availability |
| Default Currency | Primary currency for transactions |
| Currency Symbol | Display symbol with hint for formatting |
Warning
Custom Domain requires DNS CNAME/A records pointing to your server IP and a valid SSL certificate. Use the SSL module in Superadmin to install certificates.