Address Count Listing Files Record Layouts and File Naming Convention

Skip Navigation
Within Technical Documentation

Address Count Listing Files Record Layouts and File Naming Convention

This page describes the file naming convention and record layout for the Address Count Listing Files. The Current Address Count Listing Files are updated biannually and include total housing units (including transitory units) and total group quarters counts by current census tabulation block. These files are created for all 50 States, District of Columbia, Puerto Rico, and Island Areas. The total housing units in the 2023 and 2024 files do not include transitory units.

On This Page:

File Naming Convention for 2025 Current Address Count Listing Files

These pipe delimited text files are named using the following convention: <st>_<name>_AddressBlockCountList_<mm><yyyy>.txt,  where:

  • <st> = Two-digit state Federal Information Processing Series (FIPS) code
  • <name> = Concatenated state (or equivalent) name
  • <mm> = Two-digit month the file was created
  • <yyyy> = Four-digit year the file was created

An example file name is: 

44_RhodeIsland_AddressBlockCountList_072025.txt

Record Layout for 2025 Current Address Count Listing Files

Field Name Field Description
STATE Two-digit FIPS State code. This represents the current state. It may differ from the first two digits of the BLOCK_GEOID.
COUNTY Three-digit FIPS County code. This represents the current county. It may differ from digits 3-5 of the BLOCK_GEOID.
TRACT The Census Tract Number consist of six digits with an implied decimal between the fourth and fifth digit corresponding to the basic census tract number but with leading zeroes and trailing zeroes for census tracts without a suffix. This represents the current tract. It may differ from digits 6-11 of the BLOCK_GEOID.
BLOCK Four-digit census block number and one-character alpha suffix (where applicable). Census blocks are numbered uniquely from 0000 to 9999 within census tract, which nest within state and county. The first digit of the census block number identifies the block group.
BLOCK_GEOID Concatenation of the 2020 state, county, and tract, and the current BLOCK field. The BLOCK_GEOID consists of up to 16 characters (when including block suffix) and is used in joining the block level feedback data to the blocks in the partnership shapefiles.
TOTAL HOUSING UNITS Total number of addresses in the entity count list identified as housing units or transitory units by data in the MAF
TOTAL GROUP QUARTERS Total number of addresses in the entity count list identified as group quarters by data in the MAF

Back to Top

File Naming Convention for 2024 Address Count Listing Files

These pipe delimited text files are named using the following convention: <st>_<name>_AddressBlockCountList_<mm><yyyy>.txt,  where:

  • <st> = Two-digit state Federal Information Processing Series (FIPS) code
  • <name> = Concatenated state (or equivalent) name
  • <mm> = Two-digit month the file was created
  • <yyyy> = Four-digit year the file was created

An example file name is: 

44_RhodeIsland_AddressBlockCountList_072024.txt

Record Layout for 2024 Address Count Listing Files

Field Name Field Description
STATE Two-digit FIPS State code. This represents the current state. It may differ from the first two digits of the BLOCK_GEOID.
COUNTY Three-digit FIPS County code. This represents the current county. It may differ from digits 3-5 of the BLOCK_GEOID.
TRACT The Census Tract Number consist of six digits with an implied decimal between the fourth and fifth digit corresponding to the basic census tract number but with leading zeroes and trailing zeroes for census tracts without a suffix. This represents the current tract. It may differ from digits 6-11 of the BLOCK_GEOID.
BLOCK Four-digit census block number. Census blocks are numbered uniquely from 0000 to 9999 within census tract, which nest within state and county. A census block that has been split since the 2020 Census includes a one-character alpha suffix (A-Z). The first digit of the census block number identifies the block group.
BLOCK_GEOID Concatenation of the 2020 state, county, and tract, and the current BLOCK field. The BLOCK_GEOID consists of up to 16 characters (when including block suffix) and is used in joining the block level feedback data to the blocks in the partnership shapefiles.
TOTAL HOUSING UNITS Total number of addresses in the entity count list identified as housing units by data in the Master Address File (MAF).
TOTAL GROUP QUARTERS Total number of addresses in the entity count list identified as group quarters by data in the MAF.

Back to Top

File Naming Convention for 2023 Address Count Listing Files

These pipe delimited text files are named using the following convention: <st>_<name>_AddressBlockCountList_<mm><yyyy>.txt,  where:

  • <st> = Two-digit state Federal Information Processing Series (FIPS) code
  • <name> = Concatenated state (or equivalent) name
  • <mm> = Two-digit month the file was created
  • <yyyy> = Four-digit year the file was created

An example file name is: 

44_RhodeIsland_AddressBlockCountList_072023.txt

Record Layout for 2023 Address Count Listing Files

Field Name Field Description
STATE Two-digit FIPS State code. This represents the current state. It may differ from the first two digits of the BLOCK_GEOID.
COUNTY Three-digit FIPS County code. This represents the current county. It may differ from digits 3-5 of the BLOCK_GEOID.
TRACT The Census Tract Number consist of six digits with an implied decimal between the fourth and fifth digit corresponding to the basic census tract number but with leading zeroes and trailing zeroes for census tracts without a suffix. This represents the current tract. It may differ from digits 6-11 of the BLOCK_GEOID.
BLOCK Four-digit census block number. Census blocks are numbered uniquely from 0000 to 9999 within census tract, which nest within state and county. A census block that has been split since the 2020 Census includes a one-character alpha suffix (A-Z). The first digit of the census block number identifies the block group.
BLOCK_GEOID Concatenation of the 2020 state, county, and tract, and the current BLOCK field. The BLOCK_GEOID consists of up to 16 characters (when including block suffix) and is used in joining the block level feedback data to the blocks in the partnership shapefiles.
TOTAL HOUSING UNITS Total number of addresses in the entity count list identified as housing units by data in the Master Address File (MAF).
TOTAL GROUP QUARTERS Total number of addresses in the entity count list identified as group quarters by data in the MAF.

Back to Top

File Naming Convention for 2020 Address Count Listing Files

These pipe delimited text files are named using the following convention: <st>_<name>_AddressBlockCountList_<mm><yyyy>.txt,  where:

  • <st> = Two-digit state FIPS code
  • <name> = Concatenated state (or equivalent) name
  • <mm> = Two-digit month the file was created
  • <yyyy> = Four-digit year the file was created 

An example file name is: 

44_RhodeIsland_AddressBlockCountList_062022.txt 

Record Layout for 2020 Address Count Listing Files

Field Name Field Description
STATE Two-digit state FIPS code
COUNTY Three-digit county FIPS code
TRACT The census tract number consists of six digits with an implied decimal between the fourth and fifth digits corresponding to the basic census tract number but with leading zeroes and trailing zeroes for census tracts without a suffix.
BLOCK Four-digit census block number. Census blocks are numbered uniquely from 0000 to 9999 within census tract, which nest within state and county. The first digit of the census block number identifies the block group.
BLOCK_GEOID Concatenation of STATE, COUNTY, TRACT, and BLOCK fields, described above, for use in joining the census block-level feedback data to the census blocks in the partnership shapefiles.
TOTAL HOUSING UNITS Total number of addresses in the entity count list identified as housing units or transitory units by data in the Master Address File (MAF).
TOTAL GROUP QUARTERS Total number of addresses in the entity count list identified as group quarters by data in the MAF.
TOTAL CORRECTIONAL FACILITIES FOR ADULTS Total number of addresses in the entity count list identified as group quarters correctional facilities for adults by data in the MAF.
TOTAL FACILITIES FOR JUVENILES Total number of addresses in the entity count list identified as group quarters juvenile facilities by data in the MAF.
TOTAL NURSING FACILITIES/SKILLED-NURSING FACILITIES Total number of addresses in the entity count list identified as group quarters nursing facilities/skilled-nursing facilities by data in the MAF.
TOTAL OTHER INSTITUTIONAL FACILITIES Total number of addresses in the entity count list identified as group quarters other institutional facilities by data in the MAF.
TOTAL COLLEGE/UNIVERSITY STUDENT HOUSING Total number of addresses in the entity count list identified as group quarters college/university student housing by data in the MAF.
TOTAL MILITARY QUARTERS Total number of addresses in the entity count list identified as group quarters military quarters by data in the MAF.
TOTAL OTHER NONINSTITUTIONAL FACILITIES Total number of addresses in the entity count list identified as group quarters other noninstitutional facilities by data in the MAF.

Back to Top

Page Last Revised - August 22, 2025