This page summarizes how the Remote Work Tax Checker produces its answers. The full technical version lives on the methodology page, which is generated from the published dataset itself.
The dataset
All rules come from a single versioned JSON dataset
(remote-work-tax-rules-2026.0, rule set 0.2.0) covering:
- 51 jurisdictions — 50 states plus DC, each with a profile: wage income tax applicability, sourcing mechanism, convenience-of-the-employer rule, credit rule, reciprocity forms, withholding notes and sources.
- Published reciprocity agreements — the bilateral graph of state pairs with real agreements, each citing the departments of revenue behind it.
- Federal notes — the single-return context and absence of a federal credit for state taxes.
Every profile and agreement carries a status
(verified/estimate) and a lastVerified date. The dataset is
currently in estimate status pending full human review — all
module pages are noindex until verification completes.
The lookup pipeline
- Validate — state codes against the 51 jurisdictions; tax
year against the coverage window; optional fields normalized.
Invalid input returns an explicit
unavailableresult. - Resolve states — residence, employer and optional work-location mapped to their profiles.
- Evaluate pairs — each pair of involved states is checked against the agreement graph: existence, kind, directionality, effective/repeal dates, exemption forms, scope conditions.
- Assemble — obligations checklist, warnings, sources, confidence and coverage stamps.
The engine version and dataset versions are stamped on every result.
What is deliberately not modeled
- No monetary amounts — the assessment type is
rules_determination; no tax, credit or withholding figure is ever computed or displayed. - Wages only — self-employment and business income excluded.
- No proration — part-year residency flagged, not allocated.
- No local taxes — city/county layers flagged, not computed.
- No employer nexus — informational warning only.
- Max three states — residence, employer, work-location.
Sources and verification
Each profile cites its state department of revenue (or equivalent) pages with retrieval dates. Agreement sources are bilateral where marked. Absence of an agreement is reported as verified only when both states' published lists confirm it. The review workflow and versioning rules are documented in the project contracts.
FAQ
Why is everything marked "estimate"?
Because the dataset has not yet completed human verification of every profile and agreement against its cited sources. Estimate status is displayed on every page and drives the noindex/sitemap gates — it flips automatically when the dataset is verified.
How often is the dataset updated?
Rules change when states publish or repeal agreements and revise sourcing guidance. Each update bumps the dataset version; pages show the version and last-verified dates so staleness is visible.
Can I cite this data?
The sources behind every rule are linked on each page — cite the state tax authority sources directly for authoritative use. This site is an informational lookup, not a tax authority.
How a result is produced
- 1
Validate input
State codes are checked against the 51 covered jurisdictions; the tax year is checked against the dataset coverage window; optional fields (arrangement, days worked, filer role, partial-year residency, self-employment) are normalized. Invalid input returns an explicit unavailable result — never a guess.
- 2
Resolve states involved
Residence, employer and optional work-location states are mapped to their dataset profiles: wage income tax applicability, sourcing mechanism, convenience-of-the-employer rule, credit rule, reciprocity forms, withholding and local-tax notes — each with its own status and last-verified date.
- 3
Evaluate reciprocity pairs
For each pair of involved states, the dataset's agreement graph is consulted: whether an agreement exists, its kind (statutory, regulatory, administrative or informal published), directionality, effective and repeal dates, exemption forms per resident direction and scope conditions. Absence of an agreement is reported only as verified when both states' published lists confirm it.
- 4
Assemble obligations & warnings
The engine emits a checklist of obligations that may apply — resident return, nonresident return, credit claim, exemption form, employer certificate, local tax check — plus warnings for estimate status, unverified profiles, asymmetric agreements, day-count thresholds and modeling limits (self-employment, part-year residency, local taxes).
- 5
Attach sources & coverage
Every result carries the source references behind each profile and agreement, the dataset version, rule set version, engine version, coverage window and confidence. No monetary value is ever computed — the assessment type is rules_determination.
Dataset & coverage
- Dataset
- remote-work-tax-rules-2026.0
- Rule set version
- 0.4.1
- Status
- estimate
- Last verified
- 2026-11-27
- Tax years
- 2024–2026
- Jurisdictions
- 51
- Wage income tax jurisdictions
- 42 (manifest expects 42)
- No wage income tax
- 9
- Reciprocity agreements
- 30
- Bilateral / unilateral
- 30 / 0
- Generated at
- 2026-11-27T00:00:00.000Z
- Manifest version
- 0.4.1
Known limits — read before relying on a result
- No monetary modeling. v1 determines which rules may apply — it never computes tax, credit or withholding amounts.
- Wages only. Self-employment and business income are out of scope; see the self-employment topic.
- No proration. Part-year residency and domicile allocation are flagged, not computed — see moving states mid-year.
- Local taxes not modeled. City and county income taxes are flagged on state pages but never computed.
- Employer obligations informational. Nexus and payroll withholding determinations are out of scope.
- Estimate status. The dataset is under human review; profiles and agreements carry their own status and last-verified dates shown on every page.
Federal layer
All wages are reported on Form W-2 by the employer regardless of the state where services are performed. The work-state employer may withhold that state's income tax per its own rules (see state profiles); the employee reconciles on resident/nonresident returns. All multi-state complexity sits at the state level — that is what this module models.
- Topic no. 503, Deductible taxesIRS Topic 503: state and local income taxes are an itemized deduction (SALT cap), not a credit — no federal credit for state income taxes — retrieved 2026-11-10
- Instructions for Schedule A (Form 1040), state and local taxesIRS Schedule A instructions: SALT deduction is capped (see instructions for current amounts) — deduction mechanism, not a credit — retrieved 2026-11-10
Root sources
The dataset's root corpus — federal and cross-state references. Each state profile and agreement carries its own source list on its page.
- IRS Topic no. 503, Deductible taxesSALT = itemized deduction capped; no federal credit for state income taxes — retrieved 2026-11-10
- Instructions for Schedule A (Form 1040), state and local taxesIRS Schedule A instructions: SALT deduction is capped (see instructions for current amounts) — deduction mechanism, not a credit — retrieved 2026-11-10