PolicyEngine · hua7450 · Jan 7, 2026 · Jan 7, 2026 · Jan 8, 2026 · Jan 8, 2026
diff --git a/changelog_entry.yaml b/changelog_entry.yaml
@@ -1,4 +1,4 @@
 - bump: minor
   changes:
     added:
-      - Add Florida Temporary Cash Assistance (TCA) program.
+      - Implement Virginia TANF program.
diff --git a/policyengine_us/parameters/gov/states/va/dss/tanf/income/deductions/child_support.yaml b/policyengine_us/parameters/gov/states/va/dss/tanf/income/deductions/child_support.yaml
@@ -0,0 +1,15 @@
+description: Virginia excludes this amount of monthly child support when computing unearned income under the Temporary Assistance for Needy Families program.
+
+values:
+  2008-10-01: 50
+  2016-07-01: 100
+
+metadata:
+  unit: currency-USD
+  period: month
+  label: Virginia TANF child support exclusion
+  reference:
+    - title: Virginia TANF Manual Section 302 - Child Support Disregard
+      href: https://www.dss.virginia.gov/files/division/bp/tanf/manual/300_11-20.pdf#page=57
+    - title: 22 VAC 40-295-50 - Income Eligibility (historical $50 value)
+      href: https://law.lis.virginia.gov/admincode/title22/agency40/chapter295/section50/
diff --git a/...gine_us/parameters/gov/states/va/dss/tanf/income/deductions/dependent_care/full_time.yaml b/...gine_us/parameters/gov/states/va/dss/tanf/income/deductions/dependent_care/full_time.yaml
@@ -0,0 +1,25 @@
+description: Virginia deducts anticipated expenses for care of each dependent child or incapacitated adult for full-time employed applicants under the Temporary Assistance for Needy Families program.
+
+metadata:
+  unit: currency-USD
+  period: month
+  label: Virginia TANF monthly care expenses per child/disabled adult for full-time employment
+  type: single_amount
+  threshold_unit: year
+  amount_unit: currency-USD
+  reference:
+    - title: Virginia TANF Manual Section 302 - Care Expenses
+      href: https://www.dss.virginia.gov/files/division/bp/tanf/manual/300_11-20.pdf#page=51
+
+# $175 per month, for care of each child, age 2 and older/incapacitated adult. 
+# $200 per month, for care of each child under 2.
+
+brackets:
+  - amount:
+      2016-01-01: 200
+    threshold:
+      2016-01-01: 0
+  - amount:
+      2016-01-01: 175
+    threshold:
+      2016-01-01: 2
diff --git a/policyengine_us/parameters/gov/states/va/dss/tanf/income/deductions/earned/flat.yaml b/policyengine_us/parameters/gov/states/va/dss/tanf/income/deductions/earned/flat.yaml
@@ -0,0 +1,30 @@
+description: Virginia excludes this amount of earnings from countable income under the Temporary Assistance for Needy Families program.
+
+metadata:
+  unit: currency-USD
+  period: month
+  label: Virginia TANF monthly flat earnings exclusion
+  type: single_amount
+  threshold_unit: person
+  amount_unit: currency-USD
+  reference:
+    - title: Virginia TANF Manual Section 302 - Earned Income Deductions
+      href: https://www.dss.virginia.gov/files/division/bp/tanf/manual/300_11-20.pdf#page=29
+
+brackets:
+  - amount:
+      2016-01-01: 167
+    threshold:
+      2016-01-01: 1
+  - amount:
+      2016-01-01: 178
+    threshold:
+      2016-01-01: 4
+  - amount:
+      2016-01-01: 209
+    threshold:
+      2016-01-01: 5
+  - amount:
+      2016-01-01: 240
+    threshold:
+      2016-01-01: 6
diff --git a/policyengine_us/parameters/gov/states/va/dss/tanf/income/deductions/earned/percentage.yaml b/policyengine_us/parameters/gov/states/va/dss/tanf/income/deductions/earned/percentage.yaml
@@ -0,0 +1,13 @@
+description: Virginia excludes this share of earnings from countable income under the Temporary Assistance for Needy Families program, after a flat deduction.
+
+values:
+  2016-01-01: 0.2
+
+metadata:
+  unit: /1
+  period: month
+  label: Virginia TANF earnings exclusion percent
+  reference:
+    - title: Virginia TANF Manual Section 302 - Earned Income Deductions
+      href: https://www.dss.virginia.gov/files/division/bp/tanf/manual/300_11-20.pdf#page=29
+
diff --git a/policyengine_us/parameters/gov/states/va/dss/tanf/localities/group3.yaml b/policyengine_us/parameters/gov/states/va/dss/tanf/localities/group3.yaml
@@ -0,0 +1,38 @@
+description: Virginia lists these localities as group III under the Temporary Assistance for Needy Families program.
+values:
+  2016-01-01:
+    # Counties
+    - ALBEMARLE_COUNTY_VA
+    - ARLINGTON_COUNTY_VA
+    - AUGUSTA_COUNTY_VA
+    - CAROLINE_COUNTY_VA
+    - FAIRFAX_COUNTY_VA
+    - FAUQUIER_COUNTY_VA
+    - JAMES_CITY_COUNTY_VA
+    - KING_GEORGE_COUNTY_VA
+    - MONTGOMERY_COUNTY_VA
+    - PRINCE_WILLIAM_COUNTY_VA
+    - SPOTSYLVANIA_COUNTY_VA
+    - STAFFORD_COUNTY_VA
+    - YORK_COUNTY_VA
+    # Cities
+    - ALEXANDRIA_CITY_VA
+    - CHARLOTTESVILLE_CITY_VA
+    - COLONIAL_HEIGHTS_CITY_VA
+    - FAIRFAX_CITY_VA
+    - FALLS_CHURCH_CITY_VA
+    - FREDERICKSBURG_CITY_VA
+    - HAMPTON_CITY_VA
+    - MANASSAS_CITY_VA
+    - MANASSAS_PARK_CITY_VA
+    - NEWPORT_NEWS_CITY_VA
+    - POQUOSON_CITY_VA
+    - STAUNTON_CITY_VA
+    - WAYNESBORO_CITY_VA
+metadata:
+  unit: list
+  period: year
+  label: Virginia TANF group III localities
+  reference:
+    - title: Virginia TANF Manual Section 302 - Locality Groups
+      href: https://www.dss.virginia.gov/files/division/bp/tanf/manual/300_11-20.pdf#page=24
diff --git a/policyengine_us/parameters/gov/states/va/dss/tanf/max_unit_size.yaml b/policyengine_us/parameters/gov/states/va/dss/tanf/max_unit_size.yaml
@@ -0,0 +1,12 @@
+description: Virginia sets this maximum unit size for determining grant and need standards under the Temporary Assistance for Needy Families program.
+
+values:
+  2016-01-01: 10
+
+metadata:
+  unit: person
+  period: year
+  label: Virginia TANF maximum unit size for standards lookup
+  reference:
+    - title: Virginia TANF Manual Section 302 - Unit Size
+      href: https://www.dss.virginia.gov/files/division/bp/tanf/manual/300_11-20.pdf#page=47
diff --git a/policyengine_us/parameters/gov/states/va/dss/tanf/need_standard/group2/addition.yaml b/policyengine_us/parameters/gov/states/va/dss/tanf/need_standard/group2/addition.yaml
@@ -0,0 +1,12 @@
+description: Virginia provides this additional need standard amount for each person above 10 in a household living in group II localities under the Temporary Assistance for Needy Families program.
+
+values:
+  2020-07-01: 162
+
+metadata:
+  unit: currency-USD
+  period: month
+  label: Virginia TANF additional need standard for group II localities
+  reference:
+    - title: Virginia TANF Manual Section 302 - Need Standards
+      href: https://www.dss.virginia.gov/files/division/bp/tanf/manual/300_11-20.pdf#page=83
diff --git a/policyengine_us/parameters/gov/states/va/dss/tanf/need_standard/group2/main.yaml b/policyengine_us/parameters/gov/states/va/dss/tanf/need_standard/group2/main.yaml
@@ -0,0 +1,32 @@
+description: Virginia provides this need standard amount for households living in group II localities under the Temporary Assistance for Needy Families program.
+
+metadata:
+  unit: currency-USD
+  period: month
+  breakdown:
+    - range(1, 11)
+  label: Virginia TANF need standard for group II localities
+  reference:
+    - title: Virginia TANF Manual Section 302 - Need Standards
+      href: https://www.dss.virginia.gov/files/division/bp/tanf/manual/300_11-20.pdf#page=83
+
+1: 
+  2020-07-01: 453
+2: 
+  2020-07-01: 663 
+3: 
+  2020-07-01: 836 
+4: 
+  2020-07-01: 997
+5: 
+  2020-07-01: 1_178 
+6: 
+  2020-07-01: 1_317 
+7: 
+  2020-07-01: 1_473 
+8: 
+  2020-07-01: 1_645
+9: 
+  2020-07-01: 1_790
+10: 
+  2020-07-01: 1_950
diff --git a/policyengine_us/parameters/gov/states/va/dss/tanf/need_standard/group3/addition.yaml b/policyengine_us/parameters/gov/states/va/dss/tanf/need_standard/group3/addition.yaml
@@ -0,0 +1,12 @@
+description: Virginia provides this additional need standard amount for each person above 10 in a household living in group III localities under the Temporary Assistance for Needy Families program.
+
+values:
+  2020-07-01: 162
+
+metadata:
+  unit: currency-USD
+  period: month
+  label: Virginia TANF additional need standard for group III localities
+  reference:
+    - title: Virginia TANF Manual Section 302 - Need Standards
+      href: https://www.dss.virginia.gov/files/division/bp/tanf/manual/300_11-20.pdf#page=83
diff --git a/policyengine_us/parameters/gov/states/va/dss/tanf/need_standard/group3/main.yaml b/policyengine_us/parameters/gov/states/va/dss/tanf/need_standard/group3/main.yaml
@@ -0,0 +1,32 @@
+description: Virginia provides this need standard amount for households living in group III localities under the Temporary Assistance for Needy Families program.
+
+metadata:
+  unit: currency-USD
+  period: month
+  breakdown:
+    - range(1, 11)
+  label: Virginia TANF need standard for group III localities
+  reference:
+    - title: Virginia TANF Manual Section 302 - Need Standards
+      href: https://www.dss.virginia.gov/files/division/bp/tanf/manual/300_11-20.pdf#page=83
+
+1: 
+  2020-07-01: 631
+2: 
+  2020-07-01: 842 
+3: 
+  2020-07-01: 1_017 
+4: 
+  2020-07-01: 1_178
+5: 
+  2020-07-01: 1_403 
+6: 
+  2020-07-01: 1_534
+7: 
+  2020-07-01: 1_696 
+8: 
+  2020-07-01: 1_868
+9: 
+  2020-07-01: 2_013
+10: 
+  2020-07-01: 2_171
diff --git a/...cyengine_us/parameters/gov/states/va/dss/tanf/payment/grant_standard/group2/addition.yaml b/...cyengine_us/parameters/gov/states/va/dss/tanf/payment/grant_standard/group2/addition.yaml
@@ -0,0 +1,12 @@
+description: Virginia provides extra assistance for each person above 10 in a family living in group II localities under the Temporary Assistance for Needy Families program.
+
+values:
+  2020-07-01: 81
+
+metadata:
+  unit: currency-USD
+  period: month
+  label: Virginia TANF extra assistance for group II localities
+  reference:
+    - title: Virginia TANF Manual Section 302 - Grant Standards
+      href: https://www.dss.virginia.gov/files/division/bp/tanf/manual/300_11-20.pdf#page=25
diff --git a/policyengine_us/parameters/gov/states/va/dss/tanf/payment/grant_standard/group2/main.yaml b/policyengine_us/parameters/gov/states/va/dss/tanf/payment/grant_standard/group2/main.yaml
@@ -0,0 +1,32 @@
+description: Virginia provides up to this amount to families living in group II localities under the Temporary Assistance for Needy Families program.
+
+metadata:
+  unit: currency-USD
+  period: month
+  breakdown:
+    - range(1, 11)
+  label: Virginia TANF assistance for group II localities
+  reference:
+    - title: Virginia TANF Manual Section 302 - Grant Standards
+      href: https://www.dss.virginia.gov/files/division/bp/tanf/manual/300_11-20.pdf#page=25
+
+1: 
+  2020-07-01: 226
+2: 
+  2020-07-01: 332 
+3: 
+  2020-07-01: 417 
+4: 
+  2020-07-01: 499
+5: 
+  2020-07-01: 589 
+6: 
+  2020-07-01: 658 
+7: 
+  2020-07-01: 736 
+8: 
+  2020-07-01: 822
+9: 
+  2020-07-01: 895
+10: 
+  2020-07-01: 975
diff --git a/policyengine_us/parameters/gov/states/va/dss/tanf/payment/grant_standard/group2/max.yaml b/policyengine_us/parameters/gov/states/va/dss/tanf/payment/grant_standard/group2/max.yaml
@@ -0,0 +1,12 @@
+description: Virginia provides up to this maximum assistance for families living in group II localities under the Temporary Assistance for Needy Families program.
+
+values:
+  2020-07-01: 625
+
+metadata:
+  unit: currency-USD
+  period: month
+  label: Virginia TANF maximum assistance for group II localities
+  reference:
+    - title: Virginia TANF Manual Section 302 - Grant Standards
+      href: https://www.dss.virginia.gov/files/division/bp/tanf/manual/300_11-20.pdf#page=25
diff --git a/...cyengine_us/parameters/gov/states/va/dss/tanf/payment/grant_standard/group3/addition.yaml b/...cyengine_us/parameters/gov/states/va/dss/tanf/payment/grant_standard/group3/addition.yaml
@@ -0,0 +1,12 @@
+description: Virginia provides extra assistance for each person above 10 in a family living in group III localities under the Temporary Assistance for Needy Families program.
+
+values:
+  2020-07-01: 81
+
+metadata:
+  unit: currency-USD
+  period: month
+  label: Virginia TANF extra assistance for group III localities
+  reference:
+    - title: Virginia TANF Manual Section 302 - Grant Standards
+      href: https://www.dss.virginia.gov/files/division/bp/tanf/manual/300_11-20.pdf#page=25
diff --git a/policyengine_us/parameters/gov/states/va/dss/tanf/payment/grant_standard/group3/main.yaml b/policyengine_us/parameters/gov/states/va/dss/tanf/payment/grant_standard/group3/main.yaml
@@ -0,0 +1,32 @@
+description: Virginia provides up to this amount to families living in group III localities under the Temporary Assistance for Needy Families program.
+
+metadata:
+  unit: currency-USD
+  period: month
+  breakdown:
+    - range(1, 11)
+  label: Virginia TANF assistance for group III localities
+  reference:
+    - title: Virginia TANF Manual Section 302 - Grant Standards
+      href: https://www.dss.virginia.gov/files/division/bp/tanf/manual/300_11-20.pdf#page=26
+
+1: 
+  2020-07-01: 316
+2: 
+  2020-07-01: 422 
+3: 
+  2020-07-01: 508 
+4: 
+  2020-07-01: 589
+5: 
+  2020-07-01: 701 
+6: 
+  2020-07-01: 767 
+7: 
+  2020-07-01: 847 
+8: 
+  2020-07-01: 933
+9: 
+  2020-07-01: 1_007
+10: 
+  2020-07-01: 1_085
diff --git a/policyengine_us/parameters/gov/states/va/dss/tanf/payment/grant_standard/group3/max.yaml b/policyengine_us/parameters/gov/states/va/dss/tanf/payment/grant_standard/group3/max.yaml
@@ -0,0 +1,12 @@
+description: Virginia provides up to this maximum assistance for families living in group III localities under the Temporary Assistance for Needy Families program.
+
+values:
+  2020-07-01: 745
+
+metadata:
+  unit: currency-USD
+  period: month
+  label: Virginia TANF maximum assistance for group III localities
+  reference:
+    - title: Virginia TANF Manual Section 302 - Grant Standards
+      href: https://www.dss.virginia.gov/files/division/bp/tanf/manual/300_11-20.pdf#page=26
diff --git a/...ngine_us/parameters/gov/states/va/dss/tanf/payment/up_grant_standard/group2/addition.yaml b/...ngine_us/parameters/gov/states/va/dss/tanf/payment/up_grant_standard/group2/addition.yaml
@@ -0,0 +1,12 @@
+description: Virginia provides additional assistance for each person above 10 in a family living in group II localities under the Temporary Assistance for Needy Families Unemployed Parent program.
+
+values:
+  2020-07-01: 71
+
+metadata:
+  unit: currency-USD
+  period: month
+  label: Virginia TANF-UP group II localities additional assistance
+  reference:
+    - title: Virginia TANF Manual Section 302 - UP Grant Standards
+      href: https://www.dss.virginia.gov/files/division/bp/tanf/manual/300_11-20.pdf#page=25