Usage plugins

Usage plugins define rules and restrictions for how employees can request and consume time off. They are evaluated when a time-off request is submitted.

How usage validation works

When an employee submits a time-off request, the system checks all configured usage plugins:

Validates the request against each plugin’s rules
Blocks requests that violate hard rules (errors)
Warns about soft violations that can proceed (warnings)
Routes for approval when required by policy

Multiple usage plugins can be combined on a single policy. For example, you might use:

Balance Floor to prevent negative balances
Advance Notice to require 2 weeks notice
Granularity to only allow full-day requests

Available usage plugins

Balance Floor Advance Notice Granularity Consecutive Days Limit Yearly Usage Limit Rolling Period Limit Blackout Periods Requires Approval Conditional Approval

Validation result types

Usage plugins can return three types of results:

Type	Behavior
Error	Request is blocked and cannot be submitted
Warning	Request can proceed, but user sees a warning
Info	Informational message (e.g., “requires approval”)