Skip to main content

System Settings

ChurchCRM's system-wide configuration lives under Admin → Settings. This page covers every settings tab and the options within each one.


General Settings

Church Information

Found at Admin → Church Info (also accessible from the Admin Dashboard).

SettingDescription
Church nameDisplayed in headers, emails, and PDF reports
Address, city, state, zipUsed for geocoding the church location on maps
Phone, emailShown on contact pages and auto-emails
Latitude / LongitudeOverride the auto-geocoded map position
LogoUploaded image used in PDF reports and email headers

Church name is required — ChurchCRM will prompt you to set it on first run and will block certain features until it is configured.


People Settings

SettingDescription
Default countryPre-fills the country field on new person/family forms
Date formatControls how dates display throughout the application
Person list columnsChoose which columns appear in the people list
Photo upload size limitMaximum file size for member photo uploads
Self-registrationAllow members to create their own accounts (disabled by default)

Finance Settings

SettingDescription
Fiscal year start monthUsed for financial period reports
Currency symbolDisplayed on donation and report pages
Tax-exempt numberPrinted on tax statements
Default fundPre-selected fund for new donation entries

Email Settings

Email settings control outbound mail delivery. See Email Setup for the full configuration guide.

SettingDescription
SMTP host / portYour outbound mail server
SMTP username / passwordAuthentication credentials
Sender name"From" display name in outbound emails
Sender address"From" email address
Reply-to addressOptional separate reply-to address
TLS/SSLEncryption mode for the connection

Integration Settings

Google Analytics (GA4)

Requires the Google Analytics plugin (Admin → Plugins → enable).

SettingDescription
GA4 Measurement IDYour G-XXXXXXXXXX property ID

Once set, login, 2FA, and password-reset page views are reported to GA4.

Vonage SMS

Requires the Vonage SMS plugin.

SettingDescription
API keyYour Vonage account API key
API secretYour Vonage account API secret
Sender number / nameThe number or alphanumeric name SMS messages originate from

OpenLP

Requires the OpenLP plugin.

SettingDescription
OpenLP hostIP address or hostname of the OpenLP instance
OpenLP portDefault 4316
Username / PasswordOpenLP authentication (if enabled in OpenLP)

Locale & Language Settings

SettingDescription
Application languageDefault UI language for all users (overridable per user in User Settings)
Date/time formatServer-side format string for dates
Week starts onSunday or Monday — affects calendar display
Browser language auto-detection

When a visitor first loads ChurchCRM (login page), the browser's preferred language is detected and the UI is shown in that language if a translation exists. No configuration is required — this is automatic.


Security Settings

SettingDescription
Minimum password lengthDefault 8 characters
Password expiryOptionally require password changes after N days
Two-factor authenticationEnable/require 2FA for all users or specific roles
Session timeoutIdle session timeout in minutes
HTTPS enforcementRedirects all HTTP traffic to HTTPS (recommended)

Map Settings

ChurchCRM uses Leaflet + Nominatim (OpenStreetMap) — no API key is required.

SettingDescription
Map default centerLatitude/longitude used when no address is geocoded yet
Map default zoomStarting zoom level on family/group maps
Geocoding providerNominatim (default, no key required)

See Maps & Geocoding for full details.