How do I map a 401(k) or other deduction for accounting?
Understanding what mapping does in Eddy—and where your CPA comes in.
Who can use this feature?
Available with Payroll plan
When you add a new benefit or deduction in Eddy — like a Vestwell 401(k) — you may get a reminder to map it before your next payroll posts to your accounting system. If you've opened the mapping screen, scrolled to the 401(k) line, and weren't sure what to pick from the dropdown, this article is for you.
The short version: your mapping choice tells Eddy which account to file the item under when it sends your payroll journal entry to QuickBooks. It does not change how anyone gets paid, how much is withheld, or when money moves. So you can't "break" payroll by choosing the wrong account here — the worst case is that an item lands in an account your CPA would rather it didn't, which is easy to change later.
What "mapping" actually does
Mapping connects each pay item in Eddy (wages, taxes, benefits, deductions) to an account in your accounting system so your payroll can post as a journal entry. It's a labeling step for the accounting export only. Choosing "401(k)" to map to one account versus another does not:
- change the employee's paycheck or the amount deducted,
- change when or how the money is remitted to your provider, or
- send any money on its own.
It only affects how that dollar amount is categorized when Eddy pushes the entry to QuickBooks. (For the full picture of how the sync works, see How does the QuickBooks Online integration work?.)
The 401(k) example
Here's the flow most customers see with a provider like Vestwell:
- Eddy runs payroll and withholds the employee's 401(k) contribution from their check.
- A day or two later, the provider pulls the contribution from your bank account separately. That's why you'll typically see two charges — your Eddy payroll debit, and then a separate Vestwell debit.
Between step 1 and step 2, your business is holding money that belongs to the employee's retirement account. In accounting terms, that's a liability — money you owe to a third party until it's paid out.
That's the key idea: an employee 401(k) contribution is money you're holding on someone's behalf, so it's generally mapped to a liability account. When the provider pulls the funds, that liability is cleared.
If your plan also includes an employer match, that piece is different — it's a cost to your business, so an employer contribution is generally mapped to a benefit expense account rather than a liability. This mirrors how Eddy handles contributions and deductions generally: employer contributions post as expenses; employee contributions and post-tax deductions post as liabilities because the funds are held for a third party.
So what do I put in the dropdown?
There isn't one universally "correct" answer that Eddy enforces — it depends on how your books are set up. As a starting point:
- Employee 401(k) contribution → a liability account (money held until remitted to the provider).
- Employer 401(k) match → a benefit/expense account (a cost to the business).
Avoid mapping a 401(k) to an unrelated category just because it's the first familiar option in the list (for example, "employee health benefits"). It'll still sync, but it can muddy your reports.
If you already have accounts in QuickBooks named for retirement or 401(k), those are usually the natural fit. If you're not sure which account to use, that's a great question for your CPA (see below).
What Eddy handles vs. what your CPA handles
This is the part that can cause confusion, because two different questions get bundled together:
Eddy handles:
- Withholding the deduction on the paycheck.
- Sending the payroll journal entry to your accounting system, using the account you map here.
- Making sure the mapping is valid so the sync runs.
Your CPA (or accountant) handles:
- Which specific account each item should map to in your chart of accounts.
- How you want the 401(k) to appear in your books (for example, as a liability that's cleared when the provider debits your account).
- Anything about your overall accounting treatment or reporting.
If your question is "which account should this go to?" or "how should this show up in QuickBooks?", that's an accounting-treatment decision — your CPA is the right person to confirm it. Once they tell you the account, mapping it in Eddy takes just a moment, and Eddy will use it going forward.
Does this apply to other deductions too?
Yes. The same logic works for most benefits and deductions, not just 401(k)s:
- Amounts withheld from an employee and paid to a third party (retirement, garnishments, most post-tax deductions) are generally liabilities until remitted.
- Amounts that are a cost to your business (employer contributions and matches) are generally expenses.
When in doubt, ask: "Is this our money going out as a cost, or money we're holding for someone else?" Costs map to expense accounts; held funds map to liability accounts.
Related articles
Was this article helpful?
