Documentation
Guides and reference for every part of NP Helper. Every article is also available as raw Markdown — append .md to its URL.
CRM
-
Contacts
How to add, view, edit, and manage individual contacts in the CRM, including custom fields and contact tagging.
-
Custom Fields
How to define custom fields that extend contact, event, and page records with organization-specific data.
-
Households
How household grouping works — linking contacts who share an address or family unit via the self-referential household_id field.
-
Mailing Lists
How to create and manage dynamic audience lists using filter rules against the contacts database.
-
Members
A focused view of contacts who hold an active membership, with filtering by tier.
-
Membership Tiers
How to configure membership tier definitions — billing intervals, default prices, and display order.
-
Memberships
How to manage membership records that track a contact's formal membership status, type, and renewal dates.
-
Notes
How to add and manage notes attached to contact records to track interactions, calls, and relationship history.
-
Organizations
How to create and manage organization records representing businesses, foundations, or other entities with a relationship to your nonprofit.
-
Tags
How to create and manage tags for contacts, pages, posts, events, and collection items using the unified Tag Manager.
CMS
-
Bar Chart Widget
Configuring data sources, axes, colours, and chart-display options for the Bar Chart widget.
-
Blog Posts
How to write, publish, and manage blog posts that appear on the public website.
-
Content Collections
How to create and manage content collections that group reusable content items for use in page builder blocks and widgets.
-
Donation Form Widget
Configuring the donation form's preset amounts, monthly and annual options, and post-donation redirect behaviour.
-
Event Calendar Widget
Configuring the interactive calendar view of published events — heading, default view, and event-filter behaviour.
-
Event Registration Form Widget
Configuring the sign-up form for a single event, including the event selection, capacity handling, and paid-event payment flow.
-
Events
How to create and manage events, including date and location details, registration, and the event's public page.
-
Media Library
Browse, inspect, and delete all media files stored in the system via Spatie Media Library.
-
Navigation
How to manage the public website's navigation menu items, including links, labels, order, and nesting.
-
Page Details
How to manage page metadata including title, slug, status, template, images, tags, SEO settings, and code snippets.
-
Pages
How to create and manage public website pages using the built-in page builder, including content blocks and visual editing.
-
Portal Pages
How to create pages visible only to authenticated, verified member portal users.
-
Post Details
How to manage blog post metadata including title, slug, status, images, tags, and SEO settings.
-
Pricing Chart Widget
Configuring a side-by-side pricing comparison table — columns, attribute rows, emphasis, and the recommended-tier treatment.
-
Products
How to create and manage products, price tiers, and view purchases and waitlist entries.
-
Public Theme
Manage the public site's visual appearance — brand colour, fonts, logo, site chrome, and advanced SCSS.
-
Templates
Manage page templates (colors, fonts, SCSS, header, footer) and content templates (widget stack presets).
-
Web Form Widget
Embedding a form built in the Form Manager on a CMS page — selecting the form, submission handling, and the after-submit experience.
-
Web Forms
How to create, configure, and embed web forms on public pages. Covers field types, validation, contact field mapping, honeypot spam protection, and viewing submissions.
-
Widget Development Guide
Technical reference for building widgets — directories, pipeline, config fields, inspector, asset bundling, image handling, collections, and demo seeders.
-
Widget Types
Developer-managed widget type definitions — configuring server-rendered and client-rendered widgets available in the page builder.
-
Widgets
Introduction to page-builder widgets — what they are, where they appear, and where to find help for specific widget types.
Finance
-
Campaigns
How to create and manage fundraising campaigns that group related solicitations and track progress toward a goal.
-
Donations
How to view and audit Stripe-backed donation records — one-off and recurring.
-
Funds
How to create and manage funds that designate where donated money is directed within your organization.
-
Giving Summary
View and filter all donors, generate year-end tax receipts, and send acknowledgement emails.
-
Setting up QuickBooks
How to connect QuickBooks Online for transaction sync — developer portal setup, OAuth credentials, environment configuration, and account selection.
-
Setting up Stripe
How to configure Stripe for payments, webhooks, and testing — including test card details.
-
Transactions
How financial transactions are recorded, where they come from, and when to enter one manually.
Tools
-
Collection Manager
Super-admin tool for defining custom data collections and their fields, used by page builder widgets to display structured content.
-
Dashboard View
Arrange per-role admin dashboard widgets using the page builder.
-
Data Imports
Umbrella reference for every importer in the CRM — contacts, events, donations, memberships, invoice details, notes, and the shared review / history workflow. Covers CSV upload, source selection, column mapping, duplicate handling, approval, and rollback.
-
Design System
Site-wide design system controls — button styles, typography, and other visual tokens used across all public pages.
-
Import Notes
How to import notes and interactions (calls, meetings, emails, tasks) from a separate activity CSV. One row per note. Contacts must already exist; rows whose contact cannot be matched are reported as errors.
-
Importer
Landing page for all import tools — import contacts, events, and financial data. Also hosts the review queue for users with the review_imports permission.
-
Onboarding — Migration
Walkthrough for moving an organization's existing records into the CRM — what to expect, the order to run imports in, edge cases to watch for, and a checklist for a first migration.
-
Record Detail Views
Configure widget sets that render in the sidebar of admin record-edit pages, scoped per record type.
Settings
-
CMS Settings
Site name, description, timezone, contact email, and event publishing defaults.
-
Finance Settings
Stripe API key configuration, webhook secret setup, and QuickBooks integration credentials.
-
General Settings
Site URL, admin branding, routing prefixes, and integration keys.
-
Mail Settings
Outgoing mail driver, sender address, Resend API key, and MailChimp integration credentials.
-
Roles
How to create and manage roles that control what each user can see and do in the admin panel.
-
System Emails
How to customise the subject, body, branding, footer, and preview of transactional emails sent by the system.
-
User Invitations
How to invite new admin users by email, resend an invitation, or revoke a pending invite.
-
Users
How to manage admin panel user accounts, including creating new users, assigning roles, and resetting passwords.
General
-
Dashboard
The main landing page of the admin panel, showing a welcome message, quick actions, integration status, and a help placeholder.
-
Heroicon Picker (Quill)
Insert inline heroicons into rich text via the Quill toolbar's icon picker. Supports the outline-set heroicons; icons inherit text color and size from surrounding text.
-
System Taxonomy
Reference document for all enumerated values, role vocabulary, status strings, and architectural terms used throughout the application.
-
Text Editor
Reference for the rich text editor (Quill) used throughout the admin — toolbar buttons, formatting options, and inline image insertion.