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.