National indicators column dictionary
Field definitions for the approved national CSV schema in snapshot 2026-10-22-30bf3753, and for the corresponding displayed-view exports. Documentation reviewed October 4, 2026; the acquired files retain their original version and checksums.
Download this dictionary CSV Data files and checksums
| Field | Meaning and interpretation |
|---|---|
series_id | Stable publication identity for a curated concept. The adjustment variant is distinguished by producer_code, rather than changing the concept ID. |
producer_code | Exact original producer series or table code. Adjusted and unadjusted variants have distinct codes. |
geography | United States for national files. These values do not supply state, county or metro estimates. |
period | Producer reference period: YYYY-MM for months, YYYY-Qn for quarters, YYYY-MM-DD for days or week-ending dates. Frequency is retained in JSON series metadata. |
value | Raw source level in frozen raw CSVs; selected calculated value in displayed-view exports. Blank means unavailable, corresponding to JSON null. Blank is never zero. |
units | The unit applying to this row, including dollar/reference-year/annual-rate conventions. Growth exports use Percent; differences between rates use Percentage points. |
adjustment | Original seasonal-adjustment convention of the selected producer series. Use matching conventions at both endpoints and for earnings deflation. |
price_basis | Price reference basis when relevant, such as chained dollars or current dollars; Not applicable otherwise. Present in raw distribution CSVs, omitted from displayed indicator exports. |
transformation | Raw level in acquired distribution files. Displayed exports identify Published level, Year-over-year change, Previous-period percentage change, Previous-period absolute change, or Quarterly annualized growth as selected. Quarterly GDP may use the published growth companion; indexing is a separate comparison view. |
snapshot | Immutable approved site acquisition ID. Distinct from reference period, producer publication date and this documentation's date. |
status | Preserved source qualifier, for example Published, Preliminary or Revised. Missing/unavailable calculations stay blank in value. Not every historical observation has its own preliminary qualifier. |
source_publication_date | Known producer publication associated with the acquired input, YYYY-MM-DD, or Unknown. It is not an inferred first-publication timestamp for each historical observation. |
acquired_at | UTC timestamp when the site retained the source response. It does not prove that the file was the newest producer release. |
source_url | Original acquisition endpoint or input-file URL. A request endpoint may require the preserved request parameters from the JSON source manifest. |
source_checksum | SHA-256 of the exact acquired source input supplying the observation. It is different from the checksum of a generated CSV; distribution checksums are listed separately. |
original_producer | Original statistical producer, retained even when the acquisition channel has an intermediary. |
attribution | Source attribution and any required source-specific notice. Retain it when redistributing rows and consult the source-rights register. |
Distinguish raw levels from the chart view
The full raw downloads preserve producer units and values, including available seasonal variants. An indicator's default headline may be a monthly difference or growth rate. A displayed CSV follows the selected transformation, range and basis; its values are rounded to the same three decimal places as the table. The snapshot identifies the approved acquired input, while transformation identifies what the website did with it.
Reproduce a row
Use the producer code, period, units, adjustment and transformation together. For example, unemployment LNS14000000 at a raw level is a percentage of the civilian labor force; its previous-period absolute change is in percentage points. Payroll raw levels are thousands of jobs; a displayed monthly difference is a change in those thousands, rather than total employment. Keep unavailable values blank and preserve source status and attribution.
Versions and precision
Existing acquired distributions remain immutable. This dictionary is supplied separately to repair the missing reference in the reviewed README. Observation-level provenance points to exact retained source responses; the approved distribution manifest supplies SHA-256 hashes for generated files. Neither acquisition time nor a displayed update date turns historical observations into an authentic pre-acquisition as-of dataset.
Transformation formulas · Source permissions and attribution · Revision and archive limits.