> ## Documentation Index
> Fetch the complete documentation index at: https://docs.goguardian.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Understand Approvals, Limits, and Rules

> How GoGuardian Hall Pass decides whether a pass activates immediately or waits for approval, and how approvals, overrides, and enforcement rules interact.

GoGuardian Hall Pass evaluates every pass request against a set of policy checks before allowing a student to leave. Understanding how those checks work helps administrators configure policies accurately and helps staff respond to blocked passes with confidence.

This article covers:

* How passes enter the **Waiting for Approval** state
* The blockers that prevent a pass from activating
* How approvals and overrides work
* Pass limits and how enforcement rules interact

## Understand How Passes Move from Request to Active

When a student requests a pass, Hall Pass runs all configured policy checks in sequence. The outcome depends on what those checks find:

* **No blockers, no approvals required:** the pass moves directly to **Active**
* **1 or more blockers or approval requirements:** the pass enters **Waiting for Approval**

A pass in Waiting for Approval is not canceled. It remains open until a staff member approves it, an override is applied, or the conditions blocking it clear (for example, capacity frees up or a cooldown window expires).

## Review Pass Statuses

| Status                          | What it means                                                                    |
| ------------------------------- | -------------------------------------------------------------------------------- |
| **Waiting for Approval**        | The pass exists, but 1 or more blockers prevent it from activating               |
| **Scheduled**                   | The pass is set to become active at a future time                                |
| **Active**                      | The student is currently out on the pass                                         |
| **Overtime**                    | The pass has exceeded its expected duration but is still within the grace window |
| **Expired**                     | The pass has exceeded the overtime grace window                                  |
| **Ended / Canceled / Rejected** | The pass is closed and will not continue                                         |

**Expired** is a visibility signal. The student is overdue, but depending on your workflow, staff may still need to end the pass manually.

A pass in Waiting for Approval can become active later (after an approval is granted, capacity frees up, or a cooldown resets).

## Understand Blockers

When a pass enters Waiting for Approval, 1 or more of the following conditions caused it.

### Understand Approval Requirements

| Blocker                           | What triggers it                                                                          |
| --------------------------------- | ----------------------------------------------------------------------------------------- |
| **Origin approval required**      | The origin room is configured to require teacher approval before the student can leave    |
| **Destination approval required** | The destination room is configured to require teacher approval before the student arrives |

### Review Capacity Blockers

| Blocker                                                        | What triggers it                                                |
| -------------------------------------------------------------- | --------------------------------------------------------------- |
| **Destination room is at capacity**                            | Too many active passes are already assigned to that destination |
| **The maximum number of hall passes for this site are in use** | Too many active passes are in progress across the site          |

### Identify Student Limit Blockers

| Blocker                                | What triggers it                                                                          |
| -------------------------------------- | ----------------------------------------------------------------------------------------- |
| **Student has reached the pass limit** | The student has reached a daily or weekly pass limit set by site settings or a group rule |
| **Minimum time between passes**        | The student is within a cooldown window since their last pass ended                       |

### Check Out-Together Rule Blockers

| Blocker                                                                   | What triggers it                                                   |
| ------------------------------------------------------------------------- | ------------------------------------------------------------------ |
| **Another student with an out-together rule is currently in the hallway** | A student in the same out-together rule already has an active pass |

### Identify Time Restriction Blockers

| Blocker                        | What triggers it                                                   |
| ------------------------------ | ------------------------------------------------------------------ |
| **Time restriction is active** | The current time falls within a configured time restriction window |

## Review How Approvals Work

A staff member can move a pass forward in 2 ways:

**Provide a required approval:** If a pass is in Waiting for Approval because origin or destination approval is required, a staff member with the appropriate role can approve it. Approving removes that specific blocker. If other blockers remain, the pass stays in Waiting for Approval.

**Apply an override:** Overrides let staff approve a pass even when a policy would otherwise block it. Hall Pass includes the following override labels:

* Capacity Override
* Origin Approved
* Destination Approved
* Out-together Rule Override
* Site Capacity Override
* Student Pass Limit Override
* Minimum Time Between Passes Override
* Time Restriction Override

Override permissions are configured by administrators. Keep override access limited and define when overrides are appropriate, for example, emergencies or documented exceptions.

## Check How Scheduled Passes Are Enforced

Scheduling a pass creates it immediately but delays activation until the start time. Enforcement checks re-evaluate at activation time:

* A pass can schedule successfully and still fail to activate if approvals haven't been granted or if conditions like capacity or pass limits are not met at the scheduled start time.

Train staff that **scheduled** means "queued," not "guaranteed."

## Configure Pass Limits

Pass limits cap how many passes a student can take within a given interval:

* **Per Day:** resets at midnight (or at a configured time)
* **Per Week:** resets at the start of the school week

Limits can be set at the site level (applying to all students) or scoped to specific groups using Group Rules. Group Rules take precedence over site defaults for students they cover.

## See How Multiple Rules Interact

Multiple enforcement rules can apply to the same student at the same time. When they do:

* All active blockers are listed on the pass
* Each blocker must be resolved (approved, overridden, or cleared naturally) before the pass activates
* Resolving 1 blocker does not clear others

A pass in Waiting for Approval with both a capacity block and a pass limit block requires both conditions to clear before it becomes active.

## Avoid Common Pitfalls

**"Why did it schedule but not activate?"** Scheduled passes are still subject to enforcement at activation time. Open the pass and check the blocker reason.

**Capacity settings can unintentionally limit movement.** If site or destination capacity is set too low, expect many passes in Waiting for Approval at peak periods. Start conservatively and adjust based on reporting.

**Combining cooldowns with low pass limits can feel restrictive.** A long minimum time between passes combined with a low daily or weekly limit can result in frequent blocks. Validate these settings against your real bell schedule.

**Out-together rules need clear naming and staff communication.** If staff don't understand why a student is in Waiting for Approval, they'll assume the system is broken. Name rules for the policy and communicate which students are covered.

**Multi-site users.** Staff or students associated with multiple sites must be in the correct site context to view and act on passes for that building. If someone can't find a pass, verify they're in the right site.
