Settings reference
The Settings area is where you configure how every part of Sacramentum behaves for your parish — from canonical rules about Mass intentions to the payment processor that handles online offerings, the kiosk PIN that runs in the sacristy, and the templates you hand to families during baptism registration. This article is the master map: it walks through every tab in order, names the settings inside each one, and points you to the detail article for any setting that has its own workflow.
The Settings page
Navigate to Admin Dashboard → Settings. The page is organized into eight tabs, each with its own concern:
| Tab | What it controls |
|---|---|
| Canonical | Parish identity, default timezone, intention rules, diocese info, logos |
| Kiosk | Sacristy kiosk PIN, allowed locations, kiosk views, per-device links |
| Payment | Stripe integration, currency, payment options, manual payouts |
| Resend-powered notifications, sender branding, recipient routing | |
| Intentions | Custom intention types, ordering, colors |
| Facilities | Facility scheduler defaults, public visibility, online room requests |
| Funeral Liturgy | Funeral ceremony defaults and configuration |
| Forms | Custom downloadable forms (godparent eligibility, sacramental records) |
Every tab has its own Save button. Sacramentum only sends the settings you have actually changed back to the server, so editing one tab will never accidentally clear values configured on another tab.
Canonical tab
The Canonical tab establishes who your parish is and the canonical rules that govern how Mass intentions are accepted and scheduled. Most parishes spend the most time here during initial setup, then rarely touch it again.
Parish identity
| Setting | Description |
|---|---|
| Parish name | Displayed across the admin console, public site, and email templates |
| Default timezone | The timezone every Mass and confession time is anchored to unless a location overrides it. See Managing locations for per-location timezone overrides |
| Parish contact email | Public-facing contact email |
| Parish contact phone | Public-facing contact phone |
| Parish website | Linked from the public site footer |
| Parish office address | Used on receipts, invoices, and tax-deductible offering summaries |
Mass intention rules
These settings encode the canonical rules your parish follows for Mass intentions. They affect what your team can do in Pending approvals, how intentions flow through Mass intentions overview, and what parishioners see on the public request form.
| Setting | Description | Default |
|---|---|---|
| Mass intentions per celebrant | Single (one intention per priest per day, the canonical default) or Multiple (requires episcopal permission) | Single |
| Maximum intentions per Mass | Only shown when Multiple is selected | 1 |
| Accept unlimited unscheduled intentions | When on, requesters can submit intentions even if no Mass slot is open. When off, intentions are limited to available slots | Off |
| Default stipend | Suggested offering amount displayed on the public request form | 10 |
| Primary stipend selection | When a Mass has multiple intentions, which one's stipend is treated as primary: First celebrated or Highest stipend | First celebrated |
Gregorian Masses
Toggle Accept Gregorian Masses to allow requesters to commission a Gregorian Mass series (30 consecutive Masses for a deceased soul). When enabled, additional fields appear:
- Gregorian Mass stipend — the total stipend for the 30-Mass series.
- Buffer days — days between accepting a Gregorian request and starting the series, so the celebrant can plan.
- Scheduling preference — Private, Public, or Both. Controls whether the daily Masses appear on the public schedule or are celebrated privately.
- Auto-approve — when on, Gregorian requests bypass the pending approvals queue.
- Default private Mass time, Unscheduled scheduling mode, and other fields control how individual days in the series are placed on the calendar.
For the full Gregorian workflow, see Gregorian Masses.
Early requests
Early requests let parishioners book Mass dates beyond the standard 365-day scheduling window. Toggle Enable early requests to expose this option to the public. Configure:
- Maximum days ahead — between 365 and 3650 days. The early-request window starts after the standard window ends.
- Allocation policy — First-come, Lottery, or Manual selection. Determines how requests for the same date are allocated when more than one comes in.
- Require payment for public early requests — admins can still create unpaid early requests for pastoral exceptions.
See Early requests for the full workflow.
Pro Populo
Pro Populo is the Mass that pastors are canonically obligated to offer for the people of their parish on Sundays and holy days. Sacramentum tracks this obligation automatically. Settings here include the custom intention text shown in the bulletin, the maximum number of times Pro Populo can be deferred, the vigil start time, the country (which affects which days are holy days of obligation), and whether Pro Populo Masses appear on the public calendar.
Diocese information
Optional diocese name and parish logos. Two logos are uploaded:
- Parish Logo (White/Light) — used on dark backgrounds (email headers, navigation).
- Parish Logo (Dark/Colored) — used on light backgrounds (receipts, invoices, PDFs).
PNG with a transparent background is recommended for both.
Extraordinary Form preference
When on, parishioners can request that their Mass intention be celebrated in the Extraordinary Form (Traditional Latin Mass). The preference appears as an optional field on the public intention request form.
Kiosk tab
The Kiosk tab configures the sacristy kiosk — a tablet or wall-mounted display that priests use to see the next Mass, the day's intentions, and the requester information for each one.
| Setting | Description |
|---|---|
| Enable kiosk | Master switch. Kiosks cannot sign in until this is on |
| Kiosk PIN | 4–6 digit code that authorizes a sacristy device. Leave blank when editing other kiosk settings to preserve the existing PIN |
| Allowed locations | The locations a kiosk session can display. Empty means all locations |
| Default location | The location the kiosk shows on first run when no URL binding is set |
| Kiosk views | Named groupings of multiple locations into a single kiosk display (e.g., "Sacristy + Nursing Homes") |
| Default kiosk view | The view used when a kiosk loads without a specific URL binding |
| Allow location picker fallback | When on, a kiosk with no URL binding lets the user pick a location on first run |
| Kiosk language | Auto, English, or Spanish. Auto follows the device's language preference |
| Show requester contact details | Display email and phone in the internal intention details view |
Per-location kiosk links and per-view kiosk links appear at the bottom of the tab. Each entry includes a Copy link button, an Open button, and a View QR button so you can pin a kiosk to a specific location or view by URL or QR scan.
Use a separate kiosk URL for each sacristy. Binding by URL means a priest cannot accidentally switch the device to the wrong location.
For details on locations themselves, see Managing locations.
Payment tab
The Payment tab is where you connect Stripe, set the currency, and control what parishioners can do at online checkout. Because this tab has many settings of its own, it has a dedicated detail article: see Payment configuration for the full walkthrough including how to connect Stripe, verify keys, configure the webhook, and troubleshoot common issues.
A summary of the settings on this tab:
| Section | Settings |
|---|---|
| Subscription Plan | Subscribe, Manage Billing (Sacramentum's own subscription, not parish payments) |
| Stripe Integration | Publishable Key, Secret Key, Stripe Setup Assistant (Verify Keys, Auto-create Webhook, Reset Webhook) |
| Currency | USD, EUR, GBP, CAD, AUD |
| Payment Options | Require payment for intentions, Allow donations above stipend, Show transaction fee coverage, Manual payouts enabled, Cover uncollected stipends in priest payouts |
| Baptism Offering | Suggested baptism offering amount |
Once you save a Stripe secret key, Sacramentum never displays it in full again. The field shows a placeholder rather than the real value. This is intentional — see Payment configuration for how to handle key rotation and verification.
Email tab
The Email tab controls when Sacramentum sends emails on your parish's behalf and how those emails are branded. Sacramentum uses Resend as the email provider; emails are sent from a verified Sacramentum domain, but the From Name and Reply-To you configure here appear on every message so replies come back to your parish.
Sender branding
| Setting | Description |
|---|---|
| Enable emails | Master switch for all parish emails |
| From name | The display name used in the From line (e.g., "St. Mary's Parish") |
| Reply-to email | The address replies are routed to |
Email types (parishioner-facing)
Each toggle controls one category of message:
| Toggle | Sends an email when |
|---|---|
| Confirmation emails | A parishioner submits a Mass intention request |
| Approval emails | An admin approves a pending intention |
| Rejection emails | An admin rejects a pending intention |
| Fulfillment emails | A Mass is celebrated and the intention is fulfilled |
| Reminder emails | Several days before a scheduled Mass intention |
| Invoice reminder emails | An invoice is past due |
| Daily priest digest | A daily summary email is sent to celebrants listing their upcoming Masses (set the send time) |
Admin notifications
| Setting | Description |
|---|---|
| Admin intention request emails | Notify admins when a new intention request comes in |
| Recipient mode | All admins, Admin priests only, or Selected admins (multi-select picker) |
For the full email system architecture, template customization, and Resend account configuration, see Email system (coming soon).
Intentions tab
The Intentions tab manages your parish's list of intention types — categories such as "Repose of soul," "In thanksgiving," "Healing," or any custom labels you want to offer requesters. Each intention type has:
- Label (English) and Label (Spanish) — the display names parishioners see on the request form.
- Color — a color from a 10-color palette used to badge intentions in lists and the calendar.
- Enabled — drag-and-drop ordering and a toggle to disable a type without deleting it.
The Pro Populo type is system-managed and cannot be disabled or deleted. All other types are custom and can be added, renamed, recolored, reordered, or removed.
Intention types control what parishioners can choose on the public request form and what your team sees in Pending approvals and Mass intentions overview.
Facilities tab
The Facilities tab governs the parish facility scheduler — the system used to book parish halls, classrooms, and meeting rooms for non-liturgical events.
| Setting | Description |
|---|---|
| Daily schedule emails | Comma-separated email addresses that receive a daily digest of facility bookings |
| Reply-to emails | Reply-to addresses on facility emails |
| Default public visibility | Hidden or Visible. New meeting series default to this visibility on the public schedule |
| Require admin approval for meetings | When on, internal meeting requests stay pending until an admin approves or rejects |
| Allow online room requests | Master switch for the public room-request form |
For the locations and rooms themselves, see Managing locations.
Funeral Liturgy tab
The Funeral Liturgy tab configures defaults for funeral ceremonies — preferred readings, hymns, eulogy time limits, the funeral coordinator's contact info, and the standard pre-funeral conference workflow. Most parishes set these once during initial setup so the funeral coordinator does not have to re-enter the same defaults on every new arrangement.
The tab is organized into sections covering ceremony defaults, music preferences, eulogy policies, and notification preferences. Settings here populate sensible starting values when a new funeral arrangement is created in Funerals.
Forms tab
The Forms tab is where you upload custom PDF forms that parishioners or sacramental candidates download during workflows. Currently supported:
| Form | When it is downloaded |
|---|---|
| Godparent Eligibility (English) | During baptism registration, by godparents |
| Godparent Eligibility (Spanish) | Same as above, in Spanish |
Each upload slot accepts a PDF file. Sacramentum stores the original filename and upload date next to the form so you can confirm at a glance whether the parish's current version is in place. View opens the form in a new tab; Delete removes it. If no custom form is uploaded, Sacramentum's default template is used.
Other parish-facing online forms — sacrament registration, ministry sign-ups, group requests — are configured separately in the Online forms builder, which is a full no-code form designer rather than a single PDF upload.
How settings interact with the rest of Sacramentum
Almost every setting on this page has a downstream effect somewhere else in the admin console. The following table summarizes the major dependencies — use it when you change a setting and want to know what to test next:
| If you change... | Test this next |
|---|---|
| Default timezone | Managing schedules, Mass intentions overview |
| Single vs. multiple intentions per Mass | Pending approvals |
| Default stipend / Gregorian stipend | The public Mass intention request form |
| Stripe keys | Finance and accounts, Payouts, Receipts |
| Email settings | The next intention request triggers a confirmation email |
| Intention types | The public request form, Pending approvals, Bulletin and register |
| Kiosk PIN or allowed locations | Sign in to the kiosk URL on the sacristy device |
| Facility default visibility | Managing schedules and the public schedule view |
| Funeral Liturgy defaults | Create a new funeral arrangement under Funerals |
| Godparent eligibility forms | Walk through public baptism registration as a parishioner would |
Saving and discarding changes
Each tab has its own save button at the top of the page. The button only enables when you have edited something on that tab. If you switch tabs with unsaved changes, Sacramentum warns you before discarding.
When you save:
- Canonical, Kiosk, Email, Forms, Funeral Liturgy, and Facilities save together when you click Save — Sacramentum sends only the values you actually changed.
- Payment is saved separately and only when you have edited a payment field, so editing settings on any other tab will never disturb your stored Stripe credentials.
- Intentions are saved through their own API call, triggered by the same Save button.
For who can see and edit each tab, see Roles and access.
What's next
- Payment configuration — connect Stripe, configure currency and payment options, troubleshoot
- Managing schedules — apply timezone and visibility settings to actual Mass and confession schedules
- Mass intentions overview — see how Canonical, Email, and Intention type settings come together in the daily workflow
Related articles
- Managing locations — per-location timezone overrides
- Managing users — admin and priest accounts that interact with these settings
- Visiting clergy — visiting clergy records used by Visiting clergy engagements
- Households — household records used in identity resolution
- Identity review queue — disambiguation workflow for parishioner records
- Pending approvals — affected by Canonical and Intentions tab settings
- Early requests — controlled by the Early requests section of the Canonical tab
- Gregorian Masses — controlled by the Gregorian section of the Canonical tab
- Memorial offerings — independent of these settings, but settled through the same ledger
- Bulletin and register — populated by intention types defined here
- Sacraments and Rites — workflows that use the Forms tab uploads
- Funerals — workflow driven by the Funeral Liturgy tab
- Visitation Ministry — independent of these settings
- Finance and accounts — receives every Stripe payment configured here
- Payouts — affected by manual payouts and uncollected stipend toggles
- Visiting clergy engagements — finance side of visiting clergy bookings
- Online forms builder — separate from the Forms tab; full no-code form designer
- Admin Chat — chat-based assistant that respects all settings configured here
- Roles and access — who can edit settings