Muin is in private beta.Watch the public release announcement —talk to us.
Falaah Falaah AI

Service Distributions

Manage distribution events, client check-in, frequency limits, eligibility screening, and disbursement batches for food pantries and social services in Muin.

Muin’s Distributions module supports organizations that provide direct services to clients — food pantries, clothing closets, supply drives, and social service programs. It manages the full lifecycle from creating a distribution event through welcoming clients at check-in, tracking service frequency, matching needs to programs, recording what was distributed, and generating impact and compliance reports.

Distribution Events

What are Distribution Events?

A Distribution Event represents a scheduled occasion where your organization distributes goods or services to clients. Each event is linked to a program, fund, and location, and tracks capacity, attendance, and what was distributed.

How to Create a Distribution Event

  1. Navigate to Nonprofit > Distributions
  2. Click Create Event
  3. Fill in the event details:
    • Name (e.g., “Weekly Food Distribution - March 15”)
    • Program and Fund to charge distributions against
    • Event Date and time window
    • Location information
    • Capacity (maximum number of clients to serve)
    • Distribution Type (food, clothing, supplies, financial assistance, etc.)
    • Items Available and quantities
  4. Save the event as a draft

Event Lifecycle

StatusDescription
DraftEvent created, not yet accepting check-ins
OpenEvent is active and accepting check-ins
CompletedEvent finished, all records finalized

To transition between statuses:

  • Click Open to begin accepting clients
  • Click Complete to finalize the event and lock distribution records

Client Check-In

What is the Check-In System?

The check-in system is the primary interface used during a distribution event. Staff or volunteers scan a client’s QR badge or look up their client number to check them in, verify eligibility, and record what they receive.

How to Check In a Client

  1. Open an active distribution event
  2. Click Check In or use the check-in kiosk view
  3. Identify the client by one of these methods:
    • QR Scan: Scan the client’s ID card QR code
    • Client Number: Type the client’s assigned number
    • Person Lookup: Search by name
  4. Muin automatically:
    • Looks up the person and their household
    • Checks frequency limits (e.g., one visit per week)
    • Runs eligibility screening if a profile is linked to the event
    • Shows any active alerts or items for review
  5. If ready to serve, a distribution record is created and the client proceeds to service
  6. If needs review, the screen shows the reason (frequency threshold reached, criteria not met, etc.)
    • Staff can enter an override reason to proceed if authorized

Check-In Response

After scanning, the check-in screen shows:

FieldDescription
Person InfoName, client number, photo (if available)
HouseholdHousehold name and member count
StatusWhether the client is ready to serve or needs review
Review ReasonWhy attention is needed (if applicable)
AlertsWarnings that do not block but require attention
History SummaryRecent distribution records for this person

Recording Service

After check-in, record what the client received:

  1. Open the distribution record
  2. Click Serve
  3. Enter the items distributed:
    • Item name, quantity, and unit
    • Total weight (lbs) if applicable
    • Total value
  4. Optionally capture a signature
  5. Link to a case if the client has an active case file
  6. Add notes about the interaction

Distribution Limits

What are Distribution Limits?

Distribution frequency rules help organizations manage capacity and plan for demand. When visit patterns indicate growing need, the system helps your team recognize it and respond.

How to Configure Limits

  1. Navigate to Nonprofit > Distribution Limits (or find them under Settings)
  2. Click Create Limit Rule
  3. Define the rule:
    • Program (or apply globally)
    • Frequency Period (daily, weekly, biweekly, monthly)
    • Maximum Visits per period
    • Apply to Household (counts all household members together) or individual
  4. Save the rule

How Limits are Enforced

During check-in, Muin evaluates all applicable limit rules:

  • Counts the client’s (or household’s) visits within the current period
  • If the count meets or exceeds the maximum, the check-in is blocked
  • The block reason includes the rule name and when the client will next be eligible
  • Authorized staff can override with a documented reason

Managing Limits

  • Edit a limit rule to adjust the frequency or maximum visits
  • Delete a limit rule (built-in system limits cannot be deleted)
  • View limits filtered by program to see rules for a specific service area

Eligibility Screening

What is Eligibility Screening?

Eligibility Screening determines whether a person qualifies for specific services based on criteria such as income, household size, geographic area, or program-specific rules. Profiles define the criteria, and checks are run automatically during check-in or manually on demand.

Setting Up Eligibility Profiles

  1. Navigate to Nonprofit > Eligibility Profiles
  2. Click Create Profile
  3. Define the eligibility criteria:
    • Profile Name (e.g., “Food Pantry - 200% FPL”)
    • Entity Type and Entity ID to link to a specific program or event
    • Income Threshold as a percentage of Federal Poverty Level (FPL)
    • Geographic Requirements (zip codes, counties, etc.)
    • Documentation Requirements (ID, proof of address, etc.)
    • Active flag
  4. Save the profile

Running an Eligibility Check

Checks can run automatically during distribution check-in or manually:

  1. Navigate to the eligibility profile
  2. Click Run Check
  3. Select the person and optionally specify:
    • Household ID
    • Household income
    • Household size
  4. Muin evaluates the criteria and returns a pass/fail result
  5. The check result is stored with an audit trail

Overriding a Check

If the eligibility criteria do not match a client’s current situation but they should be served (emergency, pending documentation, etc.):

  1. Open the eligibility check result
  2. Click Override
  3. Enter the reason for the override
  4. The override is recorded with the staff member’s identity for audit purposes

Federal Poverty Level (FPL) Tables

Muin maintains Federal Poverty Level tables used in income-based eligibility:

  • View current FPL thresholds by household size
  • Tables are available for the 48 contiguous states, Alaska, and Hawaii
  • Administrators can update FPL tables when HHS publishes new guidelines

Eligibility History

View a person’s complete eligibility check history:

  • Navigate to the person’s profile > Eligibility tab
  • See all checks, results, and any overrides
  • Use history to verify compliance during audits

Client ID Cards

What are Client ID Cards?

Client ID Cards give each person a unique client number and a QR code that can be scanned during check-in. Cards can be printed as PDF badges.

How to Generate Client IDs

Individual:

  1. Navigate to a person’s profile
  2. Click Generate Client ID
  3. Muin assigns a unique client number and generates QR data
  4. Click Download ID Card to get a printable PDF

Batch:

  1. Navigate to Client IDs > Batch Generate
  2. Select specific persons or let Muin find all persons without a client number
  3. Set the batch size limit
  4. Click Generate
  5. Muin creates client numbers for everyone in the batch

Scanning and Lookup

During distribution events:

  • Scan the QR code on the ID card to instantly identify the person
  • The scan returns the person’s name, client number, and household information
  • If a scan fails, fall back to client number or name search

Distribution Reports

Statistics

View aggregate distribution statistics for any date range:

  • Total clients served
  • Total items distributed
  • Total weight and value
  • Breakdown by fund, program, and distribution type
  • Comparison across time periods

Running a Report

  1. Navigate to Nonprofit > Distribution Reports
  2. Select a date range
  3. Optionally filter by fund
  4. View the statistics dashboard
  5. Export data for external reporting (USDA, state agencies, board reports)

Tips & Best Practices

  • Pre-register clients: Generate client IDs before distribution events to speed up check-in
  • Test your rules before going live: Create a test event and verify that frequency rules work as expected
  • Train volunteers on the check-in screen: The check-in interface is designed for simplicity but staff should understand alerts and overrides
  • Update FPL tables annually: When HHS releases new poverty guidelines (usually January), update the tables to keep eligibility checks accurate
  • Record everything during service: Detailed item records and weights are required for USDA and grant reporting
  • Use household-level tracking for family programs: Ensures your team sees the full picture of a household’s needs in one view, so service is coordinated
  • Review overrides regularly: Override patterns can reveal where your criteria may need updating to better match community needs

Common Issues

ProblemSolution
Client flagged for review but should be eligibleCheck the review reason. If it is a frequency threshold, verify the period and count. If eligibility criteria, run a manual check and override if warranted.
QR code not scanning during check-inEnsure the client card is not damaged or faded. Try a manual client number lookup. Regenerate the ID card if needed.
Eligibility check returning incorrect resultVerify the eligibility profile criteria (income threshold, FPL percentage). Check that FPL tables are up to date for the current year.
Distribution event cannot be openedVerify the event has a linked program and fund. Draft events without required fields cannot transition to Open.
Household visits counting incorrectlyConfirm the limit rule has “Apply to Household” enabled. Verify household membership is correct in the CRM.
Client number already assignedClient numbers are unique per tenant. If a number collision occurs, regenerate for the affected person.

Need Help?

If you have questions about distribution management, contact your organization administrator or reach out to Muin support. For guidance on setting up eligibility profiles for government-funded programs, consult your program compliance officer.