hua7450 · Oct 13, 2026 · Sep 21, 2026 · Sep 23, 2026 · Sep 24, 2026 · Sep 29, 2026
diff --git a/changelog.d/state-ui-income-flow-integration.added.md b/changelog.d/state-ui-income-flow-integration.added.md
@@ -0,0 +1 @@
+Integrated modeled Alabama, New Jersey, New York, Oklahoma, Pennsylvania, and Utah unemployment insurance into unemployment compensation income flows, including federal and state taxes, SNAP, TANF, SSI, WIC, school meals, Head Start, HUD, child care, and other means-tested program income sources.
diff --git a/changelog.d/state-ui-income-flow-integration.fixed.md b/changelog.d/state-ui-income-flow-integration.fixed.md
@@ -0,0 +1 @@
+Virginia now subtracts only taxable unemployment compensation (tax year 2020 changes), and Hawaii child care assistance now counts strike benefits.
diff --git a/policyengine_us/parameters/gov/hhs/head_start/income/sources.yaml b/policyengine_us/parameters/gov/hhs/head_start/income/sources.yaml
@@ -6,7 +6,7 @@ values:
     - employment_income
     # Business income.
     - self_employment_income
-    - unemployment_compensation
+    - total_unemployment_compensation
     # Pension or annuity payments.
     - pension_income
     # Military income. The exclusions for hostile fire or imminent danger

diff --git a/policyengine_us/parameters/gov/hhs/tanf/cash/income/sources/unearned.yaml b/policyengine_us/parameters/gov/hhs/tanf/cash/income/sources/unearned.yaml
@@ -11,7 +11,7 @@ values:
     - interest_income
     - miscellaneous_income
     - pension_income
-    - unemployment_compensation
+    - total_unemployment_compensation
     - gi_cash_assistance
     - social_security
 

diff --git a/policyengine_us/parameters/gov/household/cbo_social_insurance_benefits.yaml b/policyengine_us/parameters/gov/household/cbo_social_insurance_benefits.yaml
@@ -3,7 +3,7 @@ values:
   0000-01-01:
     - social_security
     - medicare_gross_cost
-    - unemployment_compensation
+    - total_unemployment_compensation
     - workers_compensation
 
 metadata:

diff --git a/policyengine_us/parameters/gov/household/household_benefits.yaml b/policyengine_us/parameters/gov/household/household_benefits.yaml
@@ -13,7 +13,7 @@ values:
     - tanf
     - high_efficiency_electric_home_rebate
     - residential_efficiency_electrification_rebate
-    - unemployment_compensation
+    - total_unemployment_compensation
     - child_support_received
     - workers_compensation
     - educational_assistance
@@ -43,7 +43,7 @@ values:
     - tanf
     - high_efficiency_electric_home_rebate
     - residential_efficiency_electrification_rebate
-    - unemployment_compensation
+    - total_unemployment_compensation
     - child_support_received
     - workers_compensation
     - educational_assistance

diff --git a/policyengine_us/parameters/gov/hud/annual_income/sources/unearned.yaml b/policyengine_us/parameters/gov/hud/annual_income/sources/unearned.yaml
@@ -20,7 +20,7 @@ values:
     - social_security
     - ssi
     - general_assistance
-    - unemployment_compensation
+    - total_unemployment_compensation
     - child_support_received
     - veterans_benefits
     # - workers_compensation: excluded per 24 CFR 5.609(b)(5) — insurance

diff --git a/policyengine_us/parameters/gov/local/ca/ala/general_assistance/countable_income/sources.yaml b/policyengine_us/parameters/gov/local/ca/ala/general_assistance/countable_income/sources.yaml
@@ -5,7 +5,7 @@ values:
     - self_employment_income
     - sstb_self_employment_income
     - social_security
-    - unemployment_compensation
+    - total_unemployment_compensation
     - veterans_benefits
 
 metadata:

diff --git a/policyengine_us/parameters/gov/local/ca/cc/general_assistance/countable_income/sources.yaml b/policyengine_us/parameters/gov/local/ca/cc/general_assistance/countable_income/sources.yaml
@@ -5,7 +5,7 @@ values:
     - self_employment_income
     - sstb_self_employment_income
     - social_security
-    - unemployment_compensation
+    - total_unemployment_compensation
     - veterans_benefits
 
 metadata:

diff --git a/policyengine_us/parameters/gov/local/ca/la/dwp/ez_save/income_sources.yaml b/policyengine_us/parameters/gov/local/ca/la/dwp/ez_save/income_sources.yaml
@@ -19,5 +19,5 @@ values:
     - tanf
     - snap
     - veterans_benefits
-    - unemployment_compensation
+    - total_unemployment_compensation
     - pension_income
diff --git a/policyengine_us/parameters/gov/local/ca/la/general_relief/income_sources.yaml b/policyengine_us/parameters/gov/local/ca/la/general_relief/income_sources.yaml
@@ -4,7 +4,7 @@ values:
     # Veterans benefits.
     - veterans_benefits
     # Unemployment Insurance Benefits (UIB) : 
-    - unemployment_compensation # match?
+    - total_unemployment_compensation # match?
     - ca_state_disability_insurance
     # Income from a job of any type.
     - irs_employment_income

diff --git a/policyengine_us/parameters/gov/local/ca/marin/general_relief/income_sources.yaml b/policyengine_us/parameters/gov/local/ca/marin/general_relief/income_sources.yaml
@@ -17,7 +17,7 @@ values:
     - retirement_distributions
     - railroad_benefits
     # Unemployment Insurance Benefits.
-    - unemployment_compensation
+    - total_unemployment_compensation
     # State Disability Insurance.
     - ca_state_disability_insurance
     # Disability and workers' compensation benefits.

diff --git a/policyengine_us/parameters/gov/local/ca/oc/general_relief/income/sources/unearned.yaml b/policyengine_us/parameters/gov/local/ca/oc/general_relief/income/sources/unearned.yaml
@@ -5,7 +5,7 @@ values:
     - interest_income
     - dividend_income
     - social_security
-    - unemployment_compensation
+    - total_unemployment_compensation
     - ca_state_disability_insurance
     - veterans_benefits
     - pension_income

diff --git a/policyengine_us/parameters/gov/local/ca/riv/cap/liheap/countable_income/sources.yaml b/policyengine_us/parameters/gov/local/ca/riv/cap/liheap/countable_income/sources.yaml
@@ -7,7 +7,7 @@ values:
     - alimony_income
     - child_support_received
     - pension_income
-    - unemployment_compensation
+    - total_unemployment_compensation
     - social_security
     - ssi 
     - ca_tanf

diff --git a/policyengine_us/parameters/gov/local/ca/riv/cap/share/countable_income/sources.yaml b/policyengine_us/parameters/gov/local/ca/riv/cap/share/countable_income/sources.yaml
@@ -7,7 +7,7 @@ values:
     - alimony_income
     - child_support_received
     - pension_income
-    - unemployment_compensation
+    - total_unemployment_compensation
     - social_security
     - ssi 
     - ca_tanf

diff --git a/policyengine_us/parameters/gov/local/ca/riv/general_relief/income/sources/unearned.yaml b/policyengine_us/parameters/gov/local/ca/riv/general_relief/income/sources/unearned.yaml
@@ -5,7 +5,7 @@ values:
     - interest_income
     - social_security
     - ca_state_disability_insurance
-    - unemployment_compensation
+    - total_unemployment_compensation
     - veterans_benefits
     # assistance from other programs
     # benefits from life insurance or burial payments

diff --git a/policyengine_us/parameters/gov/local/ca/sbd/general_relief/income/sources/unearned.yaml b/policyengine_us/parameters/gov/local/ca/sbd/general_relief/income/sources/unearned.yaml
@@ -8,7 +8,7 @@ values:
     # Social Security retirement, survivors, and disability benefits.
     - social_security
     # Unemployment Insurance Benefits.
-    - unemployment_compensation
+    - total_unemployment_compensation
     # State Disability Insurance.
     - ca_state_disability_insurance
     # Disability and workers' compensation benefits.

diff --git a/..._us/parameters/gov/local/ca/scc/general_assistance/countable_income/unearned_sources.yaml b/..._us/parameters/gov/local/ca/scc/general_assistance/countable_income/unearned_sources.yaml
@@ -5,7 +5,7 @@ values:
     - ca_state_disability_insurance
     - disability_benefits
     - railroad_benefits
-    - unemployment_compensation
+    - total_unemployment_compensation
     - veterans_benefits
     - workers_compensation
     - taxable_pension_income

diff --git a/policyengine_us/parameters/gov/local/ca/sf/caap/countable_income/sources/unearned.yaml b/policyengine_us/parameters/gov/local/ca/sf/caap/countable_income/sources/unearned.yaml
@@ -2,7 +2,7 @@ description: San Francisco County counts these unearned income sources under the
 values:
   2017-01-01:
     - social_security
-    - unemployment_compensation
+    - total_unemployment_compensation
     - veterans_benefits
     - pension_income
     - child_support_received

diff --git a/policyengine_us/parameters/gov/local/ca/smc/general_assistance/income/sources.yaml b/policyengine_us/parameters/gov/local/ca/smc/general_assistance/income/sources.yaml
@@ -4,7 +4,7 @@ values:
     - employment_income
     - self_employment_income
     - sstb_self_employment_income
-    - unemployment_compensation
+    - total_unemployment_compensation
     - workers_compensation
     - disability_benefits
     - ca_state_disability_insurance

diff --git a/policyengine_us/parameters/gov/local/co/denver/dhs/property_tax_relief/income_sources.yaml b/policyengine_us/parameters/gov/local/co/denver/dhs/property_tax_relief/income_sources.yaml
@@ -12,7 +12,7 @@ values:
     - interest_income
     - dividend_income
     - workers_compensation
-    - unemployment_compensation
+    - total_unemployment_compensation
 
 metadata:
 

diff --git a/policyengine_us/parameters/gov/ssa/ssi/income/sources/unearned.yaml b/policyengine_us/parameters/gov/ssa/ssi/income/sources/unearned.yaml
@@ -8,7 +8,7 @@ values:
     - veterans_benefits
     - survivor_benefits
     - workers_compensation
-    - unemployment_compensation
+    - total_unemployment_compensation
     - retirement_distributions
     - gi_cash_assistance
     # (b) Alimony and support payments.

diff --git a/...engine_us/parameters/gov/states/ak/dpa/ccap/income/countable_income/unearned_sources.yaml b/...engine_us/parameters/gov/states/ak/dpa/ccap/income/countable_income/unearned_sources.yaml
@@ -11,7 +11,7 @@ values:
     - alimony_income
     - social_security
     - ssi
-    - unemployment_compensation
+    - total_unemployment_compensation
     - veterans_benefits
     - rental_income
     - pension_income

diff --git a/policyengine_us/parameters/gov/states/al/dhr/ccsp/income/countable_income/sources.yaml b/policyengine_us/parameters/gov/states/al/dhr/ccsp/income/countable_income/sources.yaml
@@ -6,7 +6,7 @@ values:
     - farm_operations_income
     - social_security
     - pension_income
-    - unemployment_compensation
+    - total_unemployment_compensation
     - workers_compensation
     - ssi
     - al_ssp

diff --git a/policyengine_us/parameters/gov/states/ar/ade/oec/sra/income/sources.yaml b/policyengine_us/parameters/gov/states/ar/ade/oec/sra/income/sources.yaml
@@ -7,7 +7,7 @@ values:
     - social_security_disability
     - social_security_survivors
     - ssi
-    - unemployment_compensation
+    - total_unemployment_compensation
     - workers_compensation
     - alimony_income
     - pension_income

diff --git a/policyengine_us/parameters/gov/states/ar/tax/income/gross_income/sources/individual.yaml b/policyengine_us/parameters/gov/states/ar/tax/income/gross_income/sources/individual.yaml
@@ -49,7 +49,7 @@ values:
     - estate_income # Line 19
     - farm_rent_income # Line 19, Form 4835 rent is reported on Schedule E
     - farm_operations_income # Line 20, Schedule F
-    - unemployment_compensation # Line 21
+    - total_unemployment_compensation # Line 21
     - gambling_winnings # Line 22, other income (Form AR-OI)
   2020-01-01:
     - irs_employment_income # Line 8
@@ -92,7 +92,7 @@ values:
     - estate_income # Line 19
     - farm_rent_income # Line 19, Form 4835 rent is reported on Schedule E
     - farm_operations_income # Line 20, Schedule F
-    - unemployment_compensation # Line 21
+    - total_unemployment_compensation # Line 21
     - gambling_winnings # Line 22, other income (Form AR-OI)
 
 metadata:

diff --git a/policyengine_us/parameters/gov/states/ar/tax/income/gross_income/sources/joint.yaml b/policyengine_us/parameters/gov/states/ar/tax/income/gross_income/sources/joint.yaml
@@ -49,7 +49,7 @@ values:
     - estate_income # Line 19
     - farm_rent_income # Line 19, Form 4835 rent is reported on Schedule E
     - farm_operations_income # Line 20, Schedule F
-    - unemployment_compensation # Line 21
+    - total_unemployment_compensation # Line 21
     - gambling_winnings # Line 22, other income (Form AR-OI)
   2020-01-01:
     - irs_employment_income # Line 8
@@ -92,7 +92,7 @@ values:
     - estate_income # Line 19
     - farm_rent_income # Line 19, Form 4835 rent is reported on Schedule E
     - farm_operations_income # Line 20, Schedule F
-    - unemployment_compensation # Line 21
+    - total_unemployment_compensation # Line 21
     - gambling_winnings # Line 22, other income (Form AR-OI)
 
 metadata:

diff --git a/policyengine_us/parameters/gov/states/az/hhs/ccap/income/countable_income/sources.yaml b/policyengine_us/parameters/gov/states/az/hhs/ccap/income/countable_income/sources.yaml
@@ -5,7 +5,7 @@ values:
     - self_employment_income
     - sstb_self_employment_income
     - farm_operations_income
-    - unemployment_compensation
+    - total_unemployment_compensation
     - workers_compensation
     - child_support_received
     - alimony_income

diff --git a/policyengine_us/parameters/gov/states/ca/cdss/child_care/income/sources.yaml b/policyengine_us/parameters/gov/states/ca/cdss/child_care/income/sources.yaml
@@ -9,7 +9,7 @@ values:
     # Public assistance
     - ca_tanf
     # Unemployment and disability
-    - unemployment_compensation
+    - total_unemployment_compensation
     - workers_compensation
     - ca_state_disability_insurance
     # Social Security (excluding SSI)

diff --git a/policyengine_us/parameters/gov/states/ca/cpuc/income_sources.yaml b/policyengine_us/parameters/gov/states/ca/cpuc/income_sources.yaml
@@ -90,7 +90,7 @@ values:
   - farm_rent_income
   # Other income sources (from whatever sources derived)
   - capital_gains
-  - unemployment_compensation
+  - total_unemployment_compensation
   - miscellaneous_income
   - gi_cash_assistance
   - debt_relief
@@ -130,7 +130,7 @@ values:
   - farm_rent_income
   # Other income sources (from whatever sources derived)
   - capital_gains
-  - unemployment_compensation
+  - total_unemployment_compensation
   - miscellaneous_income
   - gi_cash_assistance
   - debt_relief

diff --git a/policyengine_us/parameters/gov/states/co/ccap/income/countable_income/sources.yaml b/policyengine_us/parameters/gov/states/co/ccap/income/countable_income/sources.yaml
@@ -11,7 +11,7 @@ values:
     - pension_income
     - retirement_distributions
     - military_retirement_pay
-    - unemployment_compensation
+    - total_unemployment_compensation
     - workers_compensation
     - child_support_received
     - alimony_income

diff --git a/policyengine_us/parameters/gov/states/co/cdhs/tanf/income/unearned.yaml b/policyengine_us/parameters/gov/states/co/cdhs/tanf/income/unearned.yaml
@@ -8,7 +8,7 @@ values:
     - interest_income
     - miscellaneous_income
     - pension_income
-    - unemployment_compensation
+    - total_unemployment_compensation
     - gi_cash_assistance
     - social_security
     - workers_compensation

diff --git a/policyengine_us/parameters/gov/states/ct/oec/c4k/income/unearned_sources.yaml b/policyengine_us/parameters/gov/states/ct/oec/c4k/income/unearned_sources.yaml
@@ -3,7 +3,7 @@ values:
   2020-01-01:
     - social_security
     - pension_income
-    - unemployment_compensation
+    - total_unemployment_compensation
     - workers_compensation
     - alimony_income
     - rental_income

diff --git a/policyengine_us/parameters/gov/states/dc/dhs/power/disqualifying_benefits.yaml b/policyengine_us/parameters/gov/states/dc/dhs/power/disqualifying_benefits.yaml
@@ -4,7 +4,7 @@ values:
     - dc_tanf
     - ssi
     - receives_ssi # Reported SSI receipt, for people the model gives a $0 payment.
-    - unemployment_compensation
+    - total_unemployment_compensation
 
 metadata:
   label: DC POWER disqualifying benefits

diff --git a/policyengine_us/parameters/gov/states/dc/dhs/tanf/income/sources/unearned.yaml b/policyengine_us/parameters/gov/states/dc/dhs/tanf/income/sources/unearned.yaml
@@ -9,7 +9,7 @@ values:
     - interest_income
     - miscellaneous_income
     - pension_income
-    - unemployment_compensation
+    - total_unemployment_compensation
     - gi_cash_assistance
     # D.C. Code 4-205.05(4) counts District and federal public assistance payments
     - general_assistance

diff --git a/policyengine_us/parameters/gov/states/de/dss/poc/income/countable_income/sources.yaml b/policyengine_us/parameters/gov/states/de/dss/poc/income/countable_income/sources.yaml
@@ -14,7 +14,7 @@ values:
     - pension_income
     - veterans_benefits
     - military_retirement_pay
-    - unemployment_compensation
+    - total_unemployment_compensation
     - workers_compensation
     - alimony_income
     - child_support_received

diff --git a/policyengine_us/parameters/gov/states/fl/doe/sr/income/sources.yaml b/policyengine_us/parameters/gov/states/fl/doe/sr/income/sources.yaml
@@ -15,7 +15,7 @@ values:
     - social_security_disability
     - social_security_survivors
     - ssi
-    - unemployment_compensation
+    - total_unemployment_compensation
     - workers_compensation
     - alimony_income
     - child_support_received

diff --git a/policyengine_us/parameters/gov/states/ga/decal/caps/income/countable_income/sources.yaml b/policyengine_us/parameters/gov/states/ga/decal/caps/income/countable_income/sources.yaml
@@ -3,7 +3,7 @@ values:
   2026-03-02:
     - employment_income
     - self_employment_income
-    - unemployment_compensation
+    - total_unemployment_compensation
     - workers_compensation
     - alimony_income
     - child_support_received

diff --git a/policyengine_us/parameters/gov/states/hi/bessd/ccap/income/countable_income/sources.yaml b/policyengine_us/parameters/gov/states/hi/bessd/ccap/income/countable_income/sources.yaml
@@ -18,7 +18,9 @@ values:
     # Military retirement pay maps to HAR 17-798.2-10(b) item (5)
     # (pensions and annuities), not item (7) (allotments).
     - military_retirement_pay
-    - unemployment_compensation
+    - total_unemployment_compensation
+    # Strike benefits (item (3)(B)) are not unemployment compensation.
+    - strike_benefits
     - workers_compensation
     - alimony_income
     - child_support_received
@@ -30,7 +32,6 @@ values:
     # - royalties (item (17))
     # - free rent converted to cost compensation (item (19));
     #   we don't track in-kind rent-for-activity at the moment
-    # - strike benefits (item (3)(B); captured via unemployment_compensation)
     # HAR 17-798.2-10(b)(11) counts Hawaii public assistance (TANF), but we do
     # NOT add `tanf` here to avoid the CCAP<->TANF circular dependency (CCAP
     # income -> tanf -> TANF dependent-care deduction -> childcare_expenses ->
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		Integrated modeled Alabama, New Jersey, New York, Oklahoma, Pennsylvania, and Utah unemployment insurance into unemployment compensation income flows, including federal and state taxes, SNAP, TANF, SSI, WIC, school meals, Head Start, HUD, child care, and other means-tested program income sources.
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		Virginia now subtracts only taxable unemployment compensation (tax year 2020 changes), and Hawaii child care assistance now counts strike benefits.