🎉 New mobile experience now live for all employee iOS & Android users! See what's new

Time Off Code Configuration

Prev Next

You can create rules at the company, group, or employee level to control how time off is tracked, paid out, or adjusted when employees work during an approved time-off period. These rules determine how the system records time-off hours, converts worked hours during time-off periods, and handles time-off cash-outs for payroll and reporting purposes.

  1. Go to Global Settings > Time Tracking > Time Off Code Configuration.

  2. In the Time Off Configuration list, select the time-off type you want to configure.

  3. Select Create Rule.

  4. Enter the rule details:

    1. Enter a name for the rule.

    2. Select the Starting on date.

    3. Select the audience level for the rule:

      • Everyone applies the rule company-wide.

      • Specific group applies the rule only to selected groups.

      • Specific employee applies the rule only to selected employees.

    4. If applicable, select the group or employee assignment.

Rule Name examples

Use clear and descriptive rule names so administrators can easily identify the purpose, audience, and behavior of each time-off configuration rule. Recommended naming structure:

[Audience or Department] + [Time-Off Type or Behavior]

  • Company Default PTO

  • Hourly Employees Vacation Rule

  • Operations Team Sick Time

  • Field Staff Holiday Rule

  • Comp Time Cash Out Rule

  • Weekend Time-Off Conversion

Use consistent naming conventions across time tracking rules to make configurations easier to manage and troubleshoot.

  1. Under Time codes, select the Time-off Code used when employees take this type of time off.

  2. If employees can receive a cash payout instead of taking time off, select the appropriate Cash out Code.

    If your organization does not use cash-outs for this time-off type, leave this setting unconfigured.

  3. If employees may work during an approved time-off period, under Hours worked during time off, turn on Transform worked hours while time off is in effect.

  4. Select Add Transformation.

  5. For each transformation:

    1. Under Consider hours of, select the source time code.

    2. Under As, select the time code the worked hours should be converted to.

  6. Repeat as needed to configure up to five transformations.

  7. Select Save.

Note: If no transformation rows remain, Transform worked hours while time off is in effect automatically turns off.

Note: Turning off Transform worked hours while time off is in effect without saving does not delete previously saved transformations. Turning it back on restores the saved transformations until you save your changes.

Understand transformation validation rules

When configuring time-off code transformations, the system validates your selections to prevent duplicate or conflicting configurations.

Duplicate source time codes

Each Consider hours of time code can only be used once within the same rule.

Ambiguous transformation chains

A time code selected under As cannot also be selected under Consider hours of in another transformation row within the same rule.

Why this happens

The system requires different behaviors for:

  • The time-off code used when employees take time off.

  • The worked-hours code that should be converted while the time-off rule is active.

  • The destination time code used after the transformation is applied.

This validation helps prevent duplicate, circular, or invalid payroll calculations.

Example configuration

Setting

Example value

Time-off Code

PTO

Cash out Code

PTO Payout

Consider hours of

Worked Hours

As

Overtime

Common time-off scenarios

Scenario

Recommended setup

Employee takes time off

Record the absence using the appropriate Time-off Code

Employee receives a payout instead of taking time off

Use a dedicated Cash out Code

Employee works during an approved time-off period

Convert worked hours to the appropriate earning or payroll code

View rule assignments

You can review which employees or groups are assigned to a time-off configuration rule.

  1. Select the rule from the configuration list.

  2. Select View Assignments.

  3. Select an employee to view the assigned rule details, effective dates, and assignment level.

Edit a time-off configuration rule

  1. Select the existing rule from the configuration list.

  2. Select the Edit icon.

  3. Update the rule settings as needed.

  4. Select Save to apply the changes.