Widget catalog

The customizable dashboard at /home-v2 ships with 30 built-in widgets organized into seven categories. This page is the reference — what each widget shows, what it's good for, and what knobs you can turn.

You add widgets through Edit → Add Widget in the dashboard toolbar. The picker has a search bar and category tabs so you don't have to scroll through all 30 at once.

TIP

Every widget has a default size (typically 4×3 or 6×3 columns × rows on the 12-col grid) and a minimum size. The grid auto-places new widgets at the bottom; you can drag and resize after adding.

Categories

Category	Count	What's in it
Members	7	Growth, leaderboards, birthdays, profile completeness
Attendance	3	By meeting, heatmap, most faithful
Giving	1	Giving trend
Demographics	6	Gender, age, type, city, relationship status, active vs lost
Schools	1	School enrollment
Insights	9	Pastoral analytics — engagement, retention, decay, care gaps, leadership pipeline, more
Custom	open	Your own custom widgets

There's also a special Universal chart widget (created via the chart builder) that doesn't live in the picker — each one is its own one-off, configured per-instance.

Members

Top inviters

The members who have invited the most other members. A leaderboard with a configurable limit (default 10). Inviter relationships are derived from the invited_by_id field on each member profile.

Most faithful

The members with the highest attendance count in the date range (default last 90 days). Useful for spotting people you might tap on the shoulder for a leadership conversation.

Backsliding members

Members who have not attended in thresholdDays days (default 30). Configurable threshold and date range. Same intent as Today's focus → At-risk but at any scale and any threshold.

Member growth

A line chart of new member registrations per month over the chosen window (default last 365 days). The classic growth-rate visualization.

Ministry participation

A horizontal bar chart of member counts per ministry. Pulls from the ministry_members join table.

Upcoming birthdays

A list of members whose birthdays fall in the next thresholdDays days (default 7, max 30). Configurable limit. A larger version of the Today's focus → Birthdays card.

Profile completeness

A histogram of how many members fall into each completeness bucket (0–25%, 26–50%, etc.) plus a worst-offender list. The completeness formula is configurable per-church under Settings → Completeness — see Custom fields.

Attendance

Attendance by meeting

A stacked bar chart of attendance counts grouped by meeting and month. Defaults to the last 365 days. The natural "are services trending up or down" view.

Most faithful

(Same as Members → Most faithful — also categorized under attendance for discovery.)

Attendance heatmap

A GitHub-style calendar heatmap of attendance frequency over the last year. Twelve columns wide on the grid (the full row) and best read at desktop size.

Mobile

The heatmap is dense and not great on a phone. Toggle Hide on mobile in the widget config to keep it off the small-screen view.

Giving

Giving trend

A line or bar chart of donation totals per month. Optionally filter to a single fund via givingFundId. Defaults to the last 365 days. Pulls from donations and respects the amount_redacted privacy flag — redacted donations are excluded from SUM and AVG but still counted.

Demographics

Gender distribution

A donut chart of active members grouped by gender. The "Not set" bucket is rendered explicitly so missing data doesn't hide.

Age distribution

A bar chart of members bucketed into age brackets (under 18, 18–25, 26–35, 36–50, 51–65, 65+). The bucket boundaries are fixed; if you need different brackets, build a custom chart.

Member type distribution

Members grouped by their membership type / category (first-timer, visitor, regular member, member, etc.). The exact list comes from your church's member_types configuration.

City distribution

The top 10 cities by member count, rendered as a horizontal bar chart. Cities are taken from the member profile's address city. Useful for catchment-area decisions.

Relationship status

Members grouped by marital / relationship status (single, married, etc.). Driven by your church's relationship_statuses config.

Active vs lost

A two-bucket donut chart comparing active members to lost members. Same numbers as the KPI tiles but in chart form so it's easy to drop on a dashboard alongside other widgets.

Schools

School enrollment

Active enrollments grouped by school. Useful for church-school environments running Bible school, Sunday school, or leadership academies. Pulls from school_enrolments (note the British spelling).

Insights

The insights category is where the heavy pastoral analytics live. Each one is designed to answer one specific shepherding question.

Engagement score

A composite 0–100 score per member, ranking them by attendance, giving, ministry involvement, group membership, school enrollment, and inviting. Configurable limit (default 20). Open with a click to see the score breakdown per member.

Retention funnel

A cohort analysis: for each month of registration, what fraction of those members is still active 1, 3, 6, 12 months later. Renders as a funnel or a multi-line chart depending on size.

Attendance decay

Members whose attendance is declining month-over-month over the last 3 months. A sharper version of the backsliding list — it surfaces the trend rather than just the absolute gap.

Inviter effectiveness

A retention-rate-per-inviter view: out of everyone an inviter has brought in, what fraction is still active 6+ months later? Helps you spot inviters whose contacts stick versus those whose contacts churn.

Pastoral care gaps

Members with no notes, no group, no ministry, and no recent attendance — likely on the verge of being forgotten. The shortlist of people who need a phone call this week.

Leadership pipeline

Members enrolled in a school AND serving in a ministry AND with 80%+ attendance in the window. Your next bench of small-group leaders.

Giving health

Aggregate giving metrics in one card: total givers, average gift, consistent givers (donated at least once a month for 3+ months), first-time givers in the window, and per-capita giving.

Org unit scorecard

A health scorecard per org unit: member count, growth rate, attendance ratio, retention rate. The natural way to compare branches or cell groups against each other.

Seasonal patterns

A 24-month rolling chart of new registrations, attendance, visitor counts, and members who went lost. Reveals seasonality (summer slumps, Christmas spikes).

Connection network

Invitation chains — root inviters (no parent) ranked by their total tree size and depth. Switchable between Top networks (any member with descendants) and Top roots (only members with no parent). Linked to the Connection network page.

Configuration options

Every widget has a settings cog (only visible in edit mode) that opens a config panel. The available knobs depend on the widget but always include:

Option	What it does
Title	Override the default widget title. Leave blank to use the registry label.
Date range	Inherit from dashboard (default), or override with last_7d/last_30d/last_90d/this_month/this_year/last_365d/all_time. When overridden, the widget header shows a Custom timeline badge.
Org unit	Per-widget override of the dashboard's unit scope. Useful for pinning one widget to "always show the main campus".
Limit	Top-N row limit on leaderboards and lists.
Threshold days	For decay / backsliding / birthday widgets — how many days defines the cutoff.
Hide on mobile	Skip rendering on screens narrower than 640px.

For widgets backed by the chart engine, the config panel also exposes color scheme, sort order, legend, labels, and percentage display. See Charts for the full chart-config surface.

What's next

• Charts — chart library + the 5-step chart builder for one-off visualizations
• Custom widgets — build your own widget definition from any data source
• Customization — how to add, resize, save, and lock widget layouts