---
title: Payroll Deduction File Errors & How to Resolve Them
description: Learn how to identify and resolve common payroll deduction file errors, including archived users, employees not in the roster, and accounts not connected to your program, with step-by-step resolution options.
---

[Skip to content](https://help.uncommongiving.com/knowledge/payroll-deduction-file-errors-how-to-resolve-them#main-content)

English

Show submenu for translations

![UNCOMMON GIVING tm\_giv\_blk\_rgb\_ (1).png\]](https://help.uncommongiving.com/hs-fs/hubfs/UNCOMMON%20GIVING%20tm_giv_blk_rgb_%20(1).png?height=40&name=UNCOMMON%20GIVING%20tm_giv_blk_rgb_%20(1).png)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- Go to uncommongiving.com

 Go to uncommongiving.com

 Hello. How can we help you?

- There are no suggestions because the search field is empty.

1. [Help Center](https://help.uncommongiving.com/knowledge?hsLang=en)
2. [Workplaces & Employers](https://help.uncommongiving.com/knowledge/workplaces-employers?hsLang=en)
3. [Payroll Deduction](https://help.uncommongiving.com/knowledge/workplaces-employers?hsLang=en#payroll-deduction)

# Payroll Deduction File Errors & How to Resolve Them

## When uploading a payroll deduction file, you may encounter exceptions that must be resolved before the file can be fully processed.

**Common Reasons for Payroll Deduction Errors**

**1. Employee is not connected to the program**

The employee may have an account but is not properly linked to your workplace program.

**2. Employee has not joined / is not in your roster**

The employee either has not joined your organization’s giving program or is missing from your roster entirely

**3. Employee is archived**

The employee exists in your roster but is currently archived, which prevents payroll deductions from processing.

 

**Your Options When a File Has Errors**

When errors appear, you have two ways to proceed:

**Option 1 — Process the File As-Is**

-Process the file with the valid entries

-Note the employees with errors

-Upload a separate correction file later once those issues are resolved

**Option 2 — Discard the File and Reupload**

-Discard the file

-Resolve all employee errors first

-Reupload a clean file with no errors

 

**How to Resolve Each Error Type**

🔹 **Archived Employee**

-Go to your roster

-Restore (unarchive) the employee

-Upload and process the payroll file

-Return to the roster and archive the employee again if needed

🔹 **Employee Not Joined / Not in Roster**

If the employee is NOT in your roster:

-Add the employee to your roster

-Have them join your giving program

-Once they’ve joined, reupload or process the correction file

If the employee IS in your roster but not joined:

-Reach out and ask them to join the program

-If they say they already have an account, the account may not be properly linked to your program

-Contact our support team to help link the account correctly

- [Workplaces & Employers](https://help.uncommongiving.com/knowledge/workplaces-employers?hsLang=en#main-content)

    - [Getting Started](https://help.uncommongiving.com/knowledge/workplaces-employers?hsLang=en#getting-started)
    - [Frequently Asked Questions](https://help.uncommongiving.com/knowledge/workplaces-employers?hsLang=en#frequently-asked-questions)
    - [What's New](https://help.uncommongiving.com/knowledge/workplaces-employers?hsLang=en#whats-new)
    - [Volunteer](https://help.uncommongiving.com/knowledge/workplaces-employers?hsLang=en#volunteer)
    - [Payroll Deduction](https://help.uncommongiving.com/knowledge/workplaces-employers?hsLang=en#payroll-deduction)
    - [Single Sign On SSO](https://help.uncommongiving.com/knowledge/workplaces-employers?hsLang=en#single-sign-on-sso)
    - [Donations](https://help.uncommongiving.com/knowledge/workplaces-employers?hsLang=en#donations)
- [Nonprofits](https://help.uncommongiving.com/knowledge/nonprofits?hsLang=en#main-content)

    - [Getting Started](https://help.uncommongiving.com/knowledge/nonprofits?hsLang=en#getting-started)
    - [Frequently Asked Questions](https://help.uncommongiving.com/knowledge/nonprofits?hsLang=en#frequently-asked-questions)
    - [What's New](https://help.uncommongiving.com/knowledge/nonprofits?hsLang=en#whats-new)
- [Employees & Donors](https://help.uncommongiving.com/knowledge/employees-donors?hsLang=en#main-content)

    - [Getting Started](https://help.uncommongiving.com/knowledge/employees-donors?hsLang=en#getting-started)
    - [Frequently Asked Questions](https://help.uncommongiving.com/knowledge/employees-donors?hsLang=en#frequently-asked-questions)
    - [What's New](https://help.uncommongiving.com/knowledge/employees-donors?hsLang=en#whats-new)
    - [UGIV (You Give) Funds](https://help.uncommongiving.com/knowledge/employees-donors?hsLang=en#ugiv-you-give-funds)
- [Legal](https://help.uncommongiving.com/knowledge/legal?hsLang=en#main-content)

    - [Software and Web Services Licensing](https://help.uncommongiving.com/knowledge/legal?hsLang=en#software-and-web-services-licensing)
    - [Terms of Use](https://help.uncommongiving.com/knowledge/legal?hsLang=en#terms-of-use)
    - [Privacy](https://help.uncommongiving.com/knowledge/legal?hsLang=en#privacy)
- [General](https://help.uncommongiving.com/knowledge/general?hsLang=en)

[![](https://help.uncommongiving.com/hs-fs/hubfs/UncommonGivingLogoB.png?width=1920&height=1080&name=UncommonGivingLogoB.png)](http://uncommongiving.com)

uncommongiving.com Help Center

Copyright © 2026, Uncommon Giving