PolicyEngine · anth-volk · Jan 6, 2026 · Jan 9, 2026 · Jan 9, 2026
diff --git a/changelog_entry.yaml b/changelog_entry.yaml
@@ -1,4 +1,4 @@
-- bump: minor
+- bump: patch
   changes:
     added:
-      - Add Florida Temporary Cash Assistance (TCA) program.
+      - Add breakdown_labels metadata to parameters with range() dimensions for semantic labelling.
diff --git a/policyengine_us/parameters/gov/aca/state_rating_area_cost.yaml b/policyengine_us/parameters/gov/aca/state_rating_area_cost.yaml
@@ -2,10 +2,13 @@ description: Second Lowest Cost Silver Plan (SLCSP) premiums by rating area, nor
 metadata:
 
   period: month
-  unit: currency-USD 
+  unit: currency-USD
   breakdown:
      - state_code
      - range(1, 68) #max rating areas +1
+  breakdown_labels:
+     - State
+     - Rating area
   documentation: For NY and VT below is base adult premium
   label: Second Lowest Cost Silver Plan premiums by rating area
   uprating: gov.aca.benchmark_premium_uprating

diff --git a/policyengine_us/parameters/gov/contrib/additional_tax_bracket/bracket.yaml b/policyengine_us/parameters/gov/contrib/additional_tax_bracket/bracket.yaml
@@ -6,6 +6,8 @@ rates:
     propagate_metadata_to_children: true
     breakdown:
       - range(1, 8)
+    breakdown_labels:
+      - Bracket
     label: Individual income tax rates
     reference:
       # TCJA adjustments applied in (j)
@@ -42,6 +44,9 @@ thresholds:
     breakdown:
       - range(1, 8)
       - filing_status
+    breakdown_labels:
+      - Bracket
+      - Filing status
     period: year
     propagate_metadata_to_children: true
     reference:

diff --git a/policyengine_us/parameters/gov/contrib/harris/capital_gains/thresholds.yaml b/policyengine_us/parameters/gov/contrib/harris/capital_gains/thresholds.yaml
@@ -6,6 +6,9 @@ metadata:
   breakdown:
     - range(1, 4)
     - filing_status
+  breakdown_labels:
+    - Bracket
+    - Filing status
   propagate_metadata_to_children: true
   reference:
     - title: Internal Revenue Code §1(j)(5)(B)

diff --git a/policyengine_us/parameters/gov/hud/ami_limit/family_size.yaml b/policyengine_us/parameters/gov/hud/ami_limit/family_size.yaml
@@ -47,3 +47,6 @@ metadata:
   breakdown:
     - hud_income_level
     - range(1, 5)
+  breakdown_labels:
+    - Income level
+    - Family size
diff --git a/...arameters/gov/irs/deductions/itemized/salt_and_real_estate/state_sales_tax_table/tax.yaml b/...arameters/gov/irs/deductions/itemized/salt_and_real_estate/state_sales_tax_table/tax.yaml
@@ -6,6 +6,10 @@ metadata:
   - state_code
   - range(1,7)
   - range(1,20)
+  breakdown_labels:
+  - State
+  - Family size
+  - Income bracket
   label: Optional state sales tax table
   # IRS updates this from the Consumer Expenditure Survey annually.
   # Assume this follows IRS indexing for now.

diff --git a/policyengine_us/parameters/gov/irs/income/bracket.yaml b/policyengine_us/parameters/gov/irs/income/bracket.yaml
@@ -6,6 +6,8 @@ rates:
     propagate_metadata_to_children: true
     breakdown:
       - range(1, 8)
+    breakdown_labels:
+      - Bracket
     label: Individual income tax rates
     reference:
       # TCJA adjustments applied in (j)
@@ -34,6 +36,9 @@ thresholds:
     breakdown:
       - range(1, 7)
       - filing_status
+    breakdown_labels:
+      - Bracket
+      - Filing status
     period: year
     propagate_metadata_to_children: true
     reference:

diff --git a/policyengine_us/parameters/gov/local/ca/riv/general_relief/needs_standards/food.yaml b/policyengine_us/parameters/gov/local/ca/riv/general_relief/needs_standards/food.yaml
@@ -3,6 +3,8 @@ metadata:
   unit: currency-USD
   breakdown:
     - range(1,6)
+  breakdown_labels:
+    - Household size
   period: month
   label: Riverside County General Relief food needs standard
   reference:

diff --git a/policyengine_us/parameters/gov/local/ca/riv/general_relief/needs_standards/housing.yaml b/policyengine_us/parameters/gov/local/ca/riv/general_relief/needs_standards/housing.yaml
@@ -3,6 +3,8 @@ metadata:
   unit: currency-USD
   breakdown:
     - range(1,6)
+  breakdown_labels:
+    - Household size
   period: month
   label: Riverside County General Relief housing needs standard
   reference:

diff --git a/...yengine_us/parameters/gov/local/ca/riv/general_relief/needs_standards/personal_needs.yaml b/...yengine_us/parameters/gov/local/ca/riv/general_relief/needs_standards/personal_needs.yaml
@@ -3,6 +3,8 @@ metadata:
   unit: currency-USD
   breakdown:
     - range(1,6)
+  breakdown_labels:
+    - Household size
   period: month
   label: Riverside County General Relief personal needs standard
   reference:

diff --git a/policyengine_us/parameters/gov/states/ar/dhs/tea/payment_standard/amount.yaml b/policyengine_us/parameters/gov/states/ar/dhs/tea/payment_standard/amount.yaml
@@ -5,6 +5,8 @@ metadata:
   period: month
   breakdown:
     - range(1, 20)
+  breakdown_labels:
+    - Assistance unit size
   label: Arkansas TEA payment standard amount
   reference:
     - title: 208.00.13 Ark. Code R. Section 001, Section 6.1.1 - Monthly Cash Assistance Payment Amount

diff --git a/...yengine_us/parameters/gov/states/ca/cdss/tanf/cash/income/monthly_limit/region1/main.yaml b/...yengine_us/parameters/gov/states/ca/cdss/tanf/cash/income/monthly_limit/region1/main.yaml
@@ -5,6 +5,8 @@ metadata:
   period: month
   breakdown:
     - range(1, 11)
+  breakdown_labels:
+    - Household size
   label: California CalWORKs monthly income limit for region 1
   reference:
     - title: Los Angeles Department of Public Social Services E-Policy | CalWORKs Minimum Basic Standard of Adequate Care

diff --git a/...yengine_us/parameters/gov/states/ca/cdss/tanf/cash/income/monthly_limit/region2/main.yaml b/...yengine_us/parameters/gov/states/ca/cdss/tanf/cash/income/monthly_limit/region2/main.yaml
@@ -5,6 +5,8 @@ metadata:
   period: month
   breakdown:
     - range(1, 11)
+  breakdown_labels:
+    - Household size
   label: California CalWORKs monthly income limit for region 2
   reference:
     - title: Los Angeles Department of Public Social Services E-Policy | CalWORKs Minimum Basic Standard of Adequate Care

diff --git a/policyengine_us/parameters/gov/states/ca/cdss/tanf/cash/monthly_payment/region1/exempt.yaml b/policyengine_us/parameters/gov/states/ca/cdss/tanf/cash/monthly_payment/region1/exempt.yaml
@@ -5,6 +5,8 @@ metadata:
   period: month
   breakdown:
     - range(1, 11)
+  breakdown_labels:
+    - Household size
   label: California CalWORKs monthly payment level - exempt map region 1
   reference:
     - title: County of San Diego CalWORKS Program Guide | CalWORKs Payment Standards Chart

diff --git a/...engine_us/parameters/gov/states/ca/cdss/tanf/cash/monthly_payment/region1/non_exempt.yaml b/...engine_us/parameters/gov/states/ca/cdss/tanf/cash/monthly_payment/region1/non_exempt.yaml
@@ -5,6 +5,8 @@ metadata:
   period: month
   breakdown:
     - range(1, 11)
+  breakdown_labels:
+    - Household size
   label: California CalWORKs monthly payment level - non-exempt map region 1
   reference:
     - title: County of San Diego CalWORKS Program Guide | CalWORKs Payment Standards Chart

diff --git a/policyengine_us/parameters/gov/states/ca/cdss/tanf/cash/monthly_payment/region2/exempt.yaml b/policyengine_us/parameters/gov/states/ca/cdss/tanf/cash/monthly_payment/region2/exempt.yaml
@@ -5,6 +5,8 @@ metadata:
   period: month
   breakdown:
     - range(1, 11)
+  breakdown_labels:
+    - Household size
   label: California CalWORKs monthly payment level - exempt map region 2
   reference:
     - title: County of San Diego CalWORKS Program Guide | CalWORKs Payment Standards Chart

diff --git a/...engine_us/parameters/gov/states/ca/cdss/tanf/cash/monthly_payment/region2/non_exempt.yaml b/...engine_us/parameters/gov/states/ca/cdss/tanf/cash/monthly_payment/region2/non_exempt.yaml
@@ -5,6 +5,8 @@ metadata:
   period: month
   breakdown:
     - range(1, 11)
+  breakdown_labels:
+    - Household size
   label: California CalWORKs monthly payment level - non-exempt map region 2
   reference:
     - title: County of San Diego CalWORKS Program Guide | CalWORKs Payment Standards Chart

diff --git a/policyengine_us/parameters/gov/states/co/cdhs/tanf/grant_standard/main.yaml b/policyengine_us/parameters/gov/states/co/cdhs/tanf/grant_standard/main.yaml
@@ -107,6 +107,10 @@ metadata:
   breakdown:
     - range(0, 3)
     - range(0, 11)
+  breakdown_labels:
+    - Number of caretakers
+    - Number of children
+  label: Colorado TANF grant standard
   reference:
     - title: CODE OF COLORADO REGULATIONS 9 CCR 2503-6 | Income Maintenance (Volume 3)
       href: https://www.sos.state.co.us/CCR/GenerateRulePdf.do?ruleVersionId=10321#page=52

diff --git a/policyengine_us/parameters/gov/states/co/cdhs/tanf/need_standard/main.yaml b/policyengine_us/parameters/gov/states/co/cdhs/tanf/need_standard/main.yaml
@@ -74,6 +74,10 @@ metadata:
   breakdown:
     - range(0, 3)
     - range(0, 11)
+  breakdown_labels:
+    - Number of caretakers
+    - Number of children
+  label: Colorado TANF need standard
   reference:
     - title: CODE OF COLORADO REGULATIONS 9 CCR 2503-6 | Income Maintenance (Volume 3)
       href: https://www.sos.state.co.us/CCR/GenerateRulePdf.do?ruleVersionId=10321#page=52
diff --git a/policyengine_us/parameters/gov/states/ct/dss/tfa/payment/amount.yaml b/policyengine_us/parameters/gov/states/ct/dss/tfa/payment/amount.yaml
@@ -5,6 +5,8 @@ metadata:
   period: month
   breakdown:
     - range(0, 9)
+  breakdown_labels:
+    - Household size
   label: Connecticut TFA standard payment amount
   reference:
     - title: State of Connecticut TANF State Plan 2024-2026

diff --git a/policyengine_us/parameters/gov/states/dc/dhs/tanf/standard_payment/amount.yaml b/policyengine_us/parameters/gov/states/dc/dhs/tanf/standard_payment/amount.yaml
@@ -5,6 +5,8 @@ metadata:
   period: month
   breakdown:
     - range(0, 20)
+  breakdown_labels:
+    - Household size
   label: DC TANF standard payment amount
   reference:
     - title: TANF for District Families

diff --git a/policyengine_us/parameters/gov/states/dc/doee/liheap/payment/electricity.yaml b/policyengine_us/parameters/gov/states/dc/doee/liheap/payment/electricity.yaml
@@ -206,10 +206,14 @@ metadata:
   period: year
   unit: currency-USD
   label: DC LIHEAP Electricity payment
-  breakdown: 
+  breakdown:
   - dc_liheap_housing_type
   - range(1,11) # income level
   - range(1,5) # household size
+  breakdown_labels:
+  - Housing type
+  - Income level
+  - Household size
   reference:
     - title: DOEE Regular Benefits Table for FY 2024
       href: https://doee.dc.gov/sites/default/files/dc/sites/doee/service_content/attachments/DOEE%20FY24%20LIHEAP_REGULAR_Benefits_Table-Matrix.pdf
diff --git a/policyengine_us/parameters/gov/states/dc/doee/liheap/payment/gas.yaml b/policyengine_us/parameters/gov/states/dc/doee/liheap/payment/gas.yaml
@@ -207,10 +207,14 @@ metadata:
   period: year
   unit: currency-USD
   label: DC LIHEAP Gas payment
-  breakdown: 
+  breakdown:
   - dc_liheap_housing_type
   - range(1,11) # income level
   - range(1,5) # household size
+  breakdown_labels:
+  - Housing type
+  - Income level
+  - Household size
   reference:
     - title: DOEE Regular Benefits Table for FY 2024
       href: https://doee.dc.gov/sites/default/files/dc/sites/doee/service_content/attachments/DOEE%20FY24%20LIHEAP_REGULAR_Benefits_Table-Matrix.pdf
diff --git a/policyengine_us/parameters/gov/states/de/dhss/tanf/payment_standard/amount.yaml b/policyengine_us/parameters/gov/states/de/dhss/tanf/payment_standard/amount.yaml
@@ -5,6 +5,8 @@ metadata:
   period: month
   breakdown:
     - range(0, 9)
+  breakdown_labels:
+    - Household size
   label: Delaware TANF payment standard amount
   reference:
     - title: Delaware TANF State Plan 2017 - Payment Standard Table

diff --git a/...engine_us/parameters/gov/states/ga/dfcs/tanf/financial_standards/family_maximum/base.yaml b/...engine_us/parameters/gov/states/ga/dfcs/tanf/financial_standards/family_maximum/base.yaml
@@ -5,6 +5,8 @@ metadata:
   period: month
   breakdown:
     - range(1, 12)
+  breakdown_labels:
+    - Family size
   label: Georgia TANF family maximum base amount
   reference:
     # These values have not changed since 1997 (and likely since 1990 under AFDC).

diff --git a/...gine_us/parameters/gov/states/ga/dfcs/tanf/financial_standards/standard_of_need/base.yaml b/...gine_us/parameters/gov/states/ga/dfcs/tanf/financial_standards/standard_of_need/base.yaml
@@ -5,6 +5,8 @@ metadata:
   period: month
   breakdown:
     - range(1, 12)
+  breakdown_labels:
+    - Family size
   label: Georgia TANF standard of need base amount
   reference:
     # These values have not changed since 1997 (and likely since 1990 under AFDC).

diff --git a/policyengine_us/parameters/gov/states/hi/dhs/tanf/standard_of_need/amount.yaml b/policyengine_us/parameters/gov/states/hi/dhs/tanf/standard_of_need/amount.yaml
@@ -5,6 +5,8 @@ metadata:
   period: month
   breakdown:
     - range(1, 11)
+  breakdown_labels:
+    - Household size
   label: Hawaii TANF Standard of Need amount
   reference:
     - title: Hawaii TANF State Plan 11.1 Income and Benefit Standards (Effective October 1, 2023)

diff --git a/policyengine_us/parameters/gov/states/id/tafi/work_incentive_table/amount.yaml b/policyengine_us/parameters/gov/states/id/tafi/work_incentive_table/amount.yaml
@@ -5,6 +5,8 @@ metadata:
   period: month
   breakdown:
     - range(1, 11)
+  breakdown_labels:
+    - Family size
   label: Idaho TAFI work incentive table amount
   reference:
     - title: IDAPA 16.03.08.251 - Work Incentive Table

diff --git a/policyengine_us/parameters/gov/states/il/dhs/aabd/asset/disregard/base.yaml b/policyengine_us/parameters/gov/states/il/dhs/aabd/asset/disregard/base.yaml
@@ -3,6 +3,8 @@ metadata:
   unit: currency-USD
   breakdown:
     - range(1,3)
+  breakdown_labels:
+    - Household size
   period: month
   label: Illinois AABD asset disregard base amount
   reference:

diff --git a/policyengine_us/parameters/gov/states/il/dhs/aabd/payment/personal_allowance/active.yaml b/policyengine_us/parameters/gov/states/il/dhs/aabd/payment/personal_allowance/active.yaml
@@ -3,6 +3,8 @@ metadata:
   unit: currency-USD
   breakdown:
     - range(1,9)
+  breakdown_labels:
+    - Household size
   period: month
   label: Illinois AABD active applicant personal allowance  
   reference:

diff --git a/policyengine_us/parameters/gov/states/il/dhs/aabd/payment/personal_allowance/bedfast.yaml b/policyengine_us/parameters/gov/states/il/dhs/aabd/payment/personal_allowance/bedfast.yaml
@@ -3,6 +3,8 @@ metadata:
   unit: currency-USD
   breakdown:
     - range(1,9)
+  breakdown_labels:
+    - Household size
   period: month
   label: Illinois AABD bedfast applicant personal allowance  
   reference:

diff --git a/policyengine_us/parameters/gov/states/il/dhs/aabd/payment/utility/bottled_gas.yaml b/policyengine_us/parameters/gov/states/il/dhs/aabd/payment/utility/bottled_gas.yaml
@@ -4,6 +4,9 @@ metadata:
   breakdown:
     - il_aabd_area
     - range(1,20)
+  breakdown_labels:
+    - AABD area
+    - Household size
   period: month
   label: Illinois AABD bottled gas allowance by area 
   reference:

diff --git a/policyengine_us/parameters/gov/states/il/dhs/aabd/payment/utility/coal.yaml b/policyengine_us/parameters/gov/states/il/dhs/aabd/payment/utility/coal.yaml
@@ -4,6 +4,9 @@ metadata:
   breakdown:
     - il_aabd_area
     - range(1,20)
+  breakdown_labels:
+    - AABD area
+    - Household size
   period: month
   label: Illinois AABD coal allowance by area 
   reference:

diff --git a/policyengine_us/parameters/gov/states/il/dhs/aabd/payment/utility/cooking_fuel.yaml b/policyengine_us/parameters/gov/states/il/dhs/aabd/payment/utility/cooking_fuel.yaml
@@ -4,6 +4,9 @@ metadata:
   breakdown:
     - il_aabd_area
     - range(1,20)
+  breakdown_labels:
+    - AABD area
+    - Household size
   period: month
   label: Illinois AABD cooking fuel allowance by area 
   reference:

diff --git a/policyengine_us/parameters/gov/states/il/dhs/aabd/payment/utility/electricity.yaml b/policyengine_us/parameters/gov/states/il/dhs/aabd/payment/utility/electricity.yaml
@@ -4,6 +4,9 @@ metadata:
   breakdown:
     - il_aabd_area
     - range(1,20)
+  breakdown_labels:
+    - AABD area
+    - Household size
   period: month
   label: Illinois AABD electricity allowance by area 
   reference:

diff --git a/policyengine_us/parameters/gov/states/il/dhs/aabd/payment/utility/fuel_oil.yaml b/policyengine_us/parameters/gov/states/il/dhs/aabd/payment/utility/fuel_oil.yaml
@@ -4,6 +4,9 @@ metadata:
   breakdown:
     - il_aabd_area
     - range(1,20)
+  breakdown_labels:
+    - AABD area
+    - Household size
   period: month
   label: Illinois AABD fuel oil allowance by area 
   reference:

diff --git a/policyengine_us/parameters/gov/states/il/dhs/aabd/payment/utility/metered_gas.yaml b/policyengine_us/parameters/gov/states/il/dhs/aabd/payment/utility/metered_gas.yaml
@@ -4,6 +4,9 @@ metadata:
   breakdown:
     - il_aabd_area
     - range(1,20)
+  breakdown_labels:
+    - AABD area
+    - Household size
   period: month
   label: Illinois AABD metered gas allowance by area 
   reference:

diff --git a/policyengine_us/parameters/gov/states/il/dhs/aabd/payment/utility/water.yaml b/policyengine_us/parameters/gov/states/il/dhs/aabd/payment/utility/water.yaml
@@ -4,6 +4,9 @@ metadata:
   breakdown:
     - il_aabd_area
     - range(1,20)
+  breakdown_labels:
+    - AABD area
+    - Household size
   period: month
   label: Illinois AABD water allowance by area 
   reference: