Odoo US Payroll in Odoo 19 and 20: State Coverage, Tax Filing, Limits
Odoo US payroll in Odoo 19 and 20: which states are covered, what Odoo files and what it does not, NACHA, ADP and Gusto options, and when to use a provider.
Most US companies asking about Odoo payroll want to know if it can replace their payroll provider. For some it can. Our Odoo US payroll implementation work starts with that question, state by state.
Related service: Odoo implementation services — HR, payroll and attendance configured for your local rules.
This guide is for US owners, controllers and HR leads on Odoo 19 or 20. It covers only the US localization. For HR, attendance and payroll setup in any country, read our Odoo payroll setup guide.
This article is general product information, not tax advice. Confirm your federal, state and local obligations with a CPA or payroll tax specialist.
What does Odoo US payroll cover in Odoo 19 and 20?
Odoo US payroll covers payslip calculation, federal and listed state withholdings, employer taxes, benefits deductions and journal entries. It is the Enterprise Payroll app plus a US localization module.
According to Odoo's US payroll documentation, it computes employee and employer taxes under federal and state rules. The main modules are:
| Module | Technical name | What it adds |
|---|---|---|
| United States - Payroll | l10n_us_hr_payroll | Tax details, US salary structure, tax rules, W-2 reporting |
| United States - Payroll with Accounting | l10n_us_hr_payroll_account | Journal entries for payroll in the US chart of accounts |
| NACHA Payments | l10n_us_payment_nacha | NACHA files for bank payments |
| United States - Payroll - Export to ADP | l10n_us_hr_payroll_adp | CSV export of worked hours for ADP (Odoo 19 docs) |
The employee form holds W-4 data, federal and state filing status, extra withholding and W-2 box 13 flags. Benefits include 401(k) with employer match, health, commuter and Roth 401(k) deductions.
Odoo posts to four default accounts: salaries and wages, employee payroll taxes, employer payroll taxes and salary payable. That accounting link is the main reason to try Odoo payroll.
Which states does Odoo US payroll support?
Odoo 20's documentation lists 25 states plus Washington, D.C.; Odoo 19's lists 19 states plus D.C. We checked both lists in Odoo's documentation source on November 19, 2026. Treat every other state as unverified.
| Coverage | Odoo 19 docs | Odoo 20 docs |
|---|---|---|
| Listed in both | Alabama, Arizona, California, Colorado, Florida, Georgia, Idaho, Illinois, Iowa, Mississippi | Same |
| Listed in both | Nevada, New Jersey, New York, North Carolina, Oregon, Texas, Vermont, Virginia, Washington and D.C. | Same |
| Added in Odoo 20 docs | Not listed | Kansas, Kentucky, Michigan, Missouri, South Carolina, Utah |
| Total | 19 states plus D.C. | 25 states plus D.C. |
Some listed states have no state income tax. Odoo's docs name Florida, Nevada, Texas and Washington among them, so the state filing status field stays blank there.
Pennsylvania, Ohio, Massachusetts, Tennessee and every other state are not listed, so treat them as unverified. Odoo says states may be added, so recheck the Odoo 19 US payroll page and the 20.0 page.
The docs for Odoo Online releases 19.3 and 19.4 show the same list as 19.0, but code can move ahead of docs. Run a test payslip for each work state on your exact version.
How does Odoo handle federal vs state payroll tax?
Federal taxes are built in for every employee, while state rules apply only when the employee's work address is in a listed state. The work address state decides which salary rules Odoo uses.
Odoo's salary structure runs in a fixed order:
- Gross pay: basic wage plus commissions, tips and bonuses.
- Pre-tax deductions: medical, commuter and 401(k) amounts reduce taxable income.
- Federal taxes: federal income tax, Social Security, Medicare and federal unemployment.
- State taxes: the rules for the employee's work state, if that state is covered.
- Post-tax deductions: Roth 401(k) and other inputs such as child support.
- Employer deductions: a separate section showing the employer share of payroll taxes.
Rates and wage caps, such as the Social Security wage base, live in rule parameters. Odoo updates them each calendar year and advises editing them only when a rate differs, such as your own unemployment rate.
Odoo 20 docs add that US payroll uses the payment date, not the work date, for tax parameters, annual limits and year-to-date totals. That matters for pay runs that cross January 1.
Does Odoo file and pay US payroll taxes?

No. Odoo calculates and reports the numbers, but you still file the returns and deposit the taxes yourself or through a third party.
| Obligation | What Odoo gives you | What you still do |
|---|---|---|
| Form 941 (quarterly federal) | CSV report by quarter | E-file through a third party, deposit taxes |
| Form 940 (annual FUTA) | CSV report by year | E-file through a third party, pay FUTA |
| W-2 for employees | CSV summary for the year | E-file with third-party software, send copies |
| Net pay to employees | NACHA file from batch payments | Upload the file to your bank |
| State withholding returns | Withholding on payslips for listed states | File and pay with each state agency |
| Local and city taxes | Not described in Odoo's US docs | Handle outside Odoo or with custom rules |
Odoo's docs say the 941 and 940 files go "through a third party for e-filing." The IRS says Form 941 is filed for each quarter and is generally due by the last day of the month after the quarter ends.
So someone on your team owns deposits, quarterly returns, state filings and year-end forms. If nobody does that today, Odoo payroll adds work.
How does Odoo pay US employees with NACHA direct deposit?
Odoo creates a NACHA ACH file from payroll payments, and you upload that file to your bank's portal. There is no documented direct bank submission for payroll files.
The NACHA setup in Odoo's US accounting docs works per bank journal. Your bank supplies the routing number, company ID, originating DFI number and entry class code (CCD or PPD).
- Trusted accounts: every employee needs a trusted bank account, or payroll and the NACHA file fail.
- Batching: all payments in one batch must use the same NACHA payment method.
- Cut-off times: same-day files must reach the bank before its cut-off, or carry a future date.
- Corrections: you can regenerate the export file from the batch payment if something changes.
Test with a one-employee batch first, and enter bank values exactly as the bank gives them.
What are the main Odoo US payroll limitations?
The limits are coverage, filing and edge cases, not the payslip engine itself. These are the gaps we check in every US scoping call.
- Unlisted states: any work state outside the documented list needs custom rules or a provider.
- Local taxes: Odoo's US payroll docs do not describe city, county or school district income taxes.
- Multi-state staff: tax rules follow the work address, so remote staff in many states need careful setup.
- Prevailing wage: not covered in the US payroll docs; certified payroll for public contracts needs extra work.
- S-corp owners: shareholder health premiums on W-2s are not described, so plan a custom input.
- Garnishments: only child support appears as a standard input; other orders need inputs and testing.
- No filing or payment service: Odoo does not file returns or deposit taxes for you.
On the Odoo forum, a 60-employee US company wanted a full-service provider integrated with Odoo to avoid the "legal risk or administrative hassles" of doing it themselves. That is a sensible position.
What changed for US payroll in Odoo 20?
Odoo 20 adds six documented states and reworks how time reaches payroll, which affects ADP exports and custom code.
Our Odoo 20 payroll release notes list 15 changes. Two matter most for US companies:
- Time data: work entries and the Planning to Payroll bridge were removed; time off and work entry types merged into one Time Type.
- Exports: provider-specific exports, including ADP, were replaced by one standard Export Time Entries file.
The 20.0 US payroll page still describes work entries and the ADP module, so the docs may lag the code. Test the new export against your ADP import before go-live.
Odoo 20 also adds guided pay runs with a pre-check and test-printed payslips before validation.
Odoo ADP integration and Gusto: when should you use a payroll provider?
Use a payroll provider when you need tax filing and payment as a service, many states, local taxes or year-round compliance support. Keep Odoo as the system for employees, time and accounting.
Gusto says it will "calculate, pay, and file all of your federal, state, and local payroll taxes," which is what Odoo does not do. ADP offers similar full-service payroll.
There are three common patterns:
- Hours out, journals in: Odoo exports hours to the provider, and the provider's payroll register comes back as a journal entry.
- Journal only: the provider runs everything, and a monthly summary entry posts to Odoo Accounting.
- Connector: an Odoo Apps Store module or a custom API sync moves employees, hours and journals.
An Odoo forum thread found no ready Gusto connector as of 2023. Apps Store modules exist now, so vet the version and who supports it. Our Odoo integration services build and test these links.
Odoo payroll or a payroll provider: how do you decide?

Run payroll in Odoo when your states are listed, your rules are simple and someone owns filing; otherwise use a provider and integrate it. The table sums up the choice.
| Your situation | Better fit | Why |
|---|---|---|
| One or two listed states, salaried and hourly staff | Odoo payroll | Payslips, taxes and journals in one system |
| Staff in many states or remote across the US | Provider | Wider state coverage and registrations |
| City or local income taxes | Provider | Odoo's US docs do not describe local taxes |
| Public contracts with prevailing wage | Provider or custom | Not in Odoo's US payroll docs |
| No one to file 941, 940 and state returns | Provider | Filing and payment as a service |
| Heavy overtime and shift rules in a listed state | Odoo payroll | Attendance and schedules feed pay directly |
Leaving QuickBooks? Our Odoo vs QuickBooks guide covers the wider switch. For a budget, try the Odoo project estimate tool.
Which US industries fit Odoo payroll best?
Odoo payroll fits single-state employers with hourly staff and simple benefits, while multi-state and public-contract employers usually need a provider.
| Industry | Pain or cost driver | Odoo approach | How iVentureTeam helps |
|---|---|---|---|
| Manufacturing | Shifts, overtime, hourly staff | Attendance feeds payslips | Set up schedules and overtime rules |
| Construction | Prevailing wage, job costing | Payroll costs to projects, provider for certified payroll | Map labor costs, connect provider |
| Professional services | Salaried staff, many remote states | Provider for taxes, Odoo for timesheets | Build the journal import |
| Retail and restaurants | Tips, part-time staff, turnover | Tips input, hourly wage type | Configure inputs, test payslips |
| Healthcare | Shift rates, multiple sites | Schedules and attendance | Model shift rules, run parallel tests |
For hourly teams, the time source matters as much as tax rules. Our guide on attendance vs timesheets in Odoo explains which one should drive pay.
What does Odoo US payroll cost?
Odoo US payroll costs the Odoo user licenses plus setup, and you still pay any third-party e-filing service. There is no separate US payroll fee in Odoo's pricing.
On Odoo's pricing page, US Standard is US$31.10 and Custom is US$61.00 per user a month billed yearly. Employees without an Odoo login count as Light Users at US$8.90 a month, so a 60-person workforce adds license cost even if few people log in.
Our published setup ranges are $3k to $9k for small projects, $9k to $27k for mid-size and $27k to $150k+ for large ones. See our US Odoo implementation partner page for how we work with US teams.
How iVentureTeam helps with Odoo US payroll
We tell you early whether Odoo payroll fits your states and rules, then build it or connect the provider that does. We have delivered 150+ ERP projects across 35+ countries with 40+ Odoo specialists, led by a consultant with 13+ years in Odoo.
- State check: every work state compared with Odoo's documented list on your exact version.
- Setup and testing: salary rules, benefits, NACHA and a parallel run against your current payroll.
- Provider integration: ADP, Gusto or another provider linked to Odoo, with hours out and journals in.
- Payroll app scope: what the Odoo Payroll app covers before you add custom rules.
- Odoo 20 upgrades: time data and export changes tested before your first pay run.
Odoo payroll data case study: Enabl Health
Clean time data is what makes payroll and billing trustworthy, and Enabl Health shows the work involved. This project ran in Australia, not the US, but the time-to-pay lessons carry over.
Enabl Health tracked work hours with manual start and stop times and needed different rates for weekdays, weekends and holidays. Its stack included Odoo Timesheets, Odoo Payroll and Odoo Invoicing on Odoo.sh.
We cleaned five data sets, including timesheets and payslips, and automated day-type classification across three rate types. Staging and production branches on Odoo.sh kept testing safe over a 10-week delivery.
Read the Enabl Health timesheet and billing case study.
The bottom line on Odoo US payroll
Odoo US payroll is a solid choice for employers in listed states with someone in-house to file and pay taxes; everyone else should pair Odoo with a payroll provider. Check your states first.
List every work state, compare it with Odoo's current docs, and decide who files the 941, 940, W-2 and state returns. If the answers are simple, run payroll in Odoo; if not, integrate a provider.
Ready to check if Odoo can run your US payroll?

Send us your states, headcount and pay rules for a straight answer. Get an Odoo US payroll fit review, call +91-90235-15208, or email business@iventureteam.com.
Frequently Asked Questions
Does Odoo support US payroll?
+
Yes. Odoo Enterprise includes a US payroll localization that calculates federal taxes, listed state taxes, benefits and employer taxes. It does not file returns or pay taxes to agencies for you.
How many states does Odoo payroll support?
+
Odoo 20's documentation lists 25 states plus Washington, D.C. Odoo 19's lists 19 states plus D.C. Check the current docs for your version before you rely on it.
Does Odoo file Form 941 and W-2s?
+
No. Odoo generates CSV files for Form 941, Form 940 and W-2s. You submit them through a third-party e-filing service and make tax deposits yourself.
Can Odoo do direct deposit for payroll?
+
Yes, through NACHA files. Odoo generates the ACH file from payroll payments, and you upload it to your bank. Each employee needs a trusted bank account.
Does Odoo integrate with ADP?
+
Odoo 19 has an ADP export of worked hours. Odoo 20 replaced provider-specific exports with one standard time export, so test it against your ADP import format.
Is there an Odoo Gusto integration?
+
There is no official Odoo connector. Apps Store modules and custom API syncs exist, or you can post Gusto's payroll register to Odoo as a journal entry.
Does Odoo handle local and city payroll taxes?
+
Odoo's US payroll documentation does not describe city, county or school district taxes. Plan custom rules or a payroll provider if you have them.
Is Odoo payroll included in the Standard plan?
+
Odoo's per-user price includes all apps, including Payroll. Employees without a login count as Light Users at US$8.90 a month in the US.
Should a small US business use Odoo payroll?
+
If you operate in one or two listed states and someone owns filing, it can work well. If not, a provider with filing included is usually safer.
Free payroll setup review
Setting up payroll in Odoo?
Tell us your headcount and pay rules. We set up salary rules, statutory files and leave in Odoo, and show what needs a custom module.
Free, with no obligation. A senior consultant replies within 12 business hours.
Free Odoo tools
All tools- Odoo Health CheckVersion, modules, findings and upgrade cost
- Odoo App SelectorWhich apps you need, by industry
- Odoo Project EstimateIndicative cost and timeline in minutes
- Odoo Implementation Cost CalculatorImplementation cost and timeline, in minutes
- Odoo Migration Cost CalculatorVersion jump or legacy ERP, priced in minutes
Continue reading
Odoo Payroll Setup: HR, Attendance and Localization in Odoo 19/20
Odoo payroll setup for Odoo 19 and 20: localizations by country, HR module, attendance, time off, pay runs, what changed in Odoo 20 and what it costs.
Odoo Attendance vs Timesheet: Which to Use for Working-Time Compliance
Odoo attendance vs timesheet for Odoo 19 and 20: EU working-time records, kiosk mode, overtime rules, payroll links and billing, and when to use both.
Odoo Employee Self Service Mobile App: Options, Build Paths, Cost
Odoo employee self service mobile app guide: leave, attendance, expenses and payslips on a phone, Light User cost, and build options on Odoo 19/20.
