Skip to content

Grants

Grant Status Lifecycle

Quick reference for grant statuses and what actions are allowed at each stage.

Grant status describes where an opportunity or award is in its lifecycle. It also affects active-grant plan usage, expense-allocation eligibility, some QuickBooks link behavior, and which grants appear in portfolio views.

Current interface limitation: GrantLink's backend defines canonical transition operations and checks, but the current grant Details form offers all statuses and saves through a general update path. That form does not universally enforce the graph below or collect every transition confirmation. Treat the graph as the intended lifecycle, not as a guarantee that every UI path blocks an out-of-sequence edit.

Before You Change Status

  • Use a non-viewer role in the correct organization.
  • Reconcile the grant's award terms, dates, allocations, reporting obligations, and QuickBooks links.
  • A class-linked grant must remain Awarded, Active, Closeout, or Closed. Make it app-only or archive its active Class links before moving to another status.
  • Confirm your plan has active-grant capacity before moving a grant to Active.

Status Overview

StatusUse it whenExpense allocations
ProspectYou are evaluating an opportunityNot eligible
AppliedThe application was submittedNot eligible
AwardedThe award was received but is not activeNot eligible
ActiveGrant-funded work and eligible spending are in progressEligible, subject to date rules
CloseoutThe period ended or closeout work beganEligible, subject to date rules
ClosedProgram and reporting work are completeNot eligible
DeclinedThe funder declined an applicationNot eligible
WithdrawnYour organization withdrew the prospect or applicationNot eligible

Status Progression

Prospect → Applied or Withdrawn
Applied → Awarded, Declined, or Withdrawn
Awarded → Active → Closeout → Closed
                     └→ Active

The canonical transition functions enforce these additional rules:

  • Applied → Awarded: award amount must be greater than zero.
  • Awarded → Active: an award amount is required. Activating before Period Start requires explicit early-activation confirmation.
  • Active → Closeout: starting before Period End requires explicit early-closeout confirmation. A closeout deadline may be recorded.
  • Closeout → Closed: requires confirmation that reporting is complete.
  • Closeout → Active: reactivation requires a reason and can optionally extend Period End.
  • Applied → Declined: may record a reason.
  • Prospect/Applied → Withdrawn: requires a reason.
  • Closed, Declined, and Withdrawn are terminal in the canonical graph.

Change Status in the Current Grant UI

  1. Open Grants and select the grant.
  2. Open Details.
  3. Under Grant Details, choose Status.
  4. Select the truthful lifecycle state.
  5. Select Save changes.
  6. Open Activity and verify the recorded status change.

Because this general form can bypass transition-specific confirmations and side effects, do not use it to manufacture a lifecycle shortcut. If a supported guided lifecycle action is available through an assistant workflow, review its preview and use that operation for sensitive transitions.

Expense Date Constraints

GrantLink enforces date rules based on grant settings:

RuleEffect
StatusOnly Active and Closeout grants can receive expense allocations
No expenses beforeBlocks transaction dates before the configured boundary
No expenses afterBlocks transaction dates after the configured boundary
Grant periodSupplies the normal eligibility window when separate expense boundaries are not configured

The current Details form exposes the grant period but not No expenses before or No expenses after. Those optional boundaries can be set through a supported assistant update; when absent, Period Start and Period End control the allocation window.

An eligible status does not make every expense allowable. The transaction still needs the correct date, amount, accounting source, support, and grant purpose.

Closed Versus Archived

  • Closed is a lifecycle status. It preserves the grant in the closed portfolio view.
  • Close / archive is a grants-list row action. It sets the grant to closed, timestamps it as archived, archives its QuickBooks links, and schedules release of allocations so their transactions can be reassigned.

Do not archive merely to indicate that the grant period ended. Use Closeout while final allocations or reporting remain.

Best Practices

  1. Use source evidence — Base Awarded, Declined, and reporting-complete decisions on retained documentation.
  2. Do not confuse status with permission — Income, reports, releases, indirect costs, and QuickBooks writeback each have separate rules.
  3. Use Closeout for final work — Active and Closeout are the only allocatable statuses.
  4. Verify side effects — Review Activity, allocations, reporting cycles, and QuickBooks link state after a consequential change.
  5. Archive only after reconciliation — Archive releases allocation treatment and removes the grant from normal list results.

Quick Status Check

From Grants, use All grants, Active, Pipeline, and Closed views. The Active view includes Awarded, Active, and Closeout records; in All grants, Awarded and Active share the Active grants group while Closeout has its own group. Prospect and Applied appear in Pipeline; Closed, Declined, and Withdrawn appear under Closed. Active-status rows omit the repeated status pill, while other statuses show it.

Search docs

Type to search documentation pages and sections.