---
title: Platform Settings
description: Multi-tab admin settings for organization branding, theme colors, email configuration, feature toggles, and notification controls.
icon: material/cog
tags:
  - guide
  - admin
  - configuration
---

# Platform Settings

Centralized configuration for organization identity, theming, email delivery, feature modules, and automated notifications.


![Settings Page](../../assets/images/screenshots/admin/settings.png){ loading=lazy }

---

## Settings Tabs

### Organization

Configure your organization's public identity:

- **Organization Name** — displayed in the admin sidebar, public pages, and emails
- **Short Name** — shown when the admin sidebar is collapsed (max 10 characters)
- **Logo URL** — displayed on the login page, homepage hero, and public navigation
- **Favicon URL** — browser tab icon
- **Footer Text** — shown in public page footers
- **Login Subtitle** — displayed below the organization name on the login page

---

### Theme Colors

Customize the look of admin and public interfaces:

**Admin theme:**

- Primary color (accent color for buttons, links, active states)
- Background color (page background)

**Public theme:**

- Primary color
- Background color
- Container color (card and section backgrounds)
- Header gradient (CSS gradient string for the public navigation bar)

A live preview panel shows color swatches and a gradient preview as you configure.

---

### Email

Configure how the platform sends emails:

- **Sender** — from name and from address for all outgoing emails
- **Active SMTP provider** — toggle between MailHog (testing) and Production SMTP with a single click
- **Production SMTP** — host, port, username, and password (collapsible panel, disabled when MailHog is active)
- **Test mode** — when enabled, all emails redirect to a single test recipient address
- **Test actions** — "Test Connection" verifies SMTP connectivity; "Send Test Email" delivers a test message through the active provider

A configuration summary card at the top displays the current provider, server, authentication status, and test mode state.

---

### Feature Toggles

Enable or disable platform modules. Disabling a module hides it from navigation but does not delete data.

| Category | Flag | Description |
|----------|------|-------------|
| **Core Platform** | `enableInfluence` | Advocacy campaigns, email sending, response wall |
| | `enableMap` | Map, locations, canvassing, volunteer shifts |
| | `enableNewsletter` | Listmonk newsletter sync |
| | `enableLandingPages` | GrapesJS landing page builder |
| **Media & Content** | `enableMediaFeatures` | Video library, public gallery, analytics |
| | `enableGalleryAds` | Promotional cards in the video gallery |
| | `enableEvents` | Gancio event calendar integration |
| **Communication** | `enableChat` | Rocket.Chat team coordination |
| | `enableMeet` | Jitsi video meetings (integrates with Rocket.Chat) |
| | `enableSms` | Termux Android SMS campaigns |
| **People & Engagement** | `enablePeople` | Unified contacts CRM |
| | `enableSocial` | Volunteer social connections and activity feeds |
| | `autoSyncPeopleToMap` | Auto-create map locations from contact addresses |
| **Commerce** | `enablePayments` | Stripe subscriptions, products, and donations |

---

### Notifications

Control which automated email notifications the platform sends. Disabling a notification stops future emails but does not affect already-queued jobs.

**Admin alerts:**

- New shift signup
- Response wall submission
- Yard sign request (from canvassing)
- Shift cancellation

**Volunteer emails:**

- Canvass session summary (sent after completing a session)
- Signup cancellation confirmation
- 24-hour pre-shift reminder
- Post-shift thank-you (sent 2 hours after shift ends)

**Re-engagement:**

- Re-engagement emails for inactive volunteers
- Configurable inactivity threshold (days without activity)
- Configurable cooldown period (minimum days between re-engagement emails)

---

## Admin Routes

- `/app/settings` — multi-tab settings page (supports deep-linking to a specific tab via router state)
