# Where Insights data comes from and how often it refreshes

> The source and refresh cadence behind every Insights metric, the monthly ingestion calendar, hand-entered fields, and what happens when a source is down.

## Before you start

- Insights is public reference data plus Incenti's own datasets. It is not
  your account's data, and nobody on your account can edit it.
- Different geography levels are built from different sources, because not
  every publisher releases figures at every grain. A metric that exists at
  State level may not exist at County level, and vice versa.
- **Insights does not display a "last refreshed" date anywhere in the
  product.** The one exception is the City detail panel's **More
  indicators** section, which shows a source and period per row. This page
  is where the cadence for everything else is recorded.

## State metrics

Twenty-six metrics are required for a state to be served at all — if any one
is missing, the whole state is left off the map, table, and comparisons
rather than shown with a hole in it.

| Metric                      | Unit / direction       | Source                 | Refresh           |
| --------------------------- | ---------------------- | ---------------------- | ----------------- |
| Population                  | Count, neutral         | Census ACS             | Annual            |
| Population Growth (5yr)     | %, higher better       | Census ACS             | Annual            |
| Median Age                  | Years, neutral         | Census ACS             | Annual            |
| Median Household Income     | $, higher better       | Census ACS             | Annual            |
| Poverty Rate                | %, lower better        | Census ACS             | Annual            |
| Freight Volume Index        | 0–100, higher better   | BTS FAF                | Never — see below |
| Unemployment Rate           | %, lower better        | BLS LAUS               | Monthly           |
| Labor Force Participation   | %, higher better       | Census ACS             | Annual            |
| Bachelor's Degree+          | %, higher better       | Census ACS             | Annual            |
| HS Graduation Rate          | %, higher better       | NCES                   | Never — see below |
| Avg Commute Time            | Minutes, lower better  | Census ACS             | Annual            |
| Electricity Rate            | ¢/kWh, lower better    | EIA                    | Monthly           |
| Natural Gas Price           | $/MCF, lower better    | EIA                    | Monthly           |
| Tax Climate Rank            | Rank, lower better     | Tax Foundation         | Never — see below |
| Workers' Comp Rate          | $/$100, lower better   | Oregon DCBS            | Never — see below |
| Health Premium (Annual)     | $, lower better        | AHRQ MEPS-IC           | Annual            |
| Disaster Declarations (5yr) | Count, lower better    | FEMA                   | Monthly           |
| Avg Air Quality Index       | Index, lower better    | EPA AQS                | Annual            |
| Health Ranking              | Rank, lower better     | County Health Rankings | Annual            |
| Broadband Access            | %, higher better       | FCC BDC                | Semiannual        |
| Physicians per 10k          | Count, higher better   | HRSA AHRF              | Annual            |
| Violent Crime Rate          | Per 100k, lower better | FBI CDE                | Annual            |
| Housing Affordability       | Ratio, lower better    | Census ACS             | Annual            |
| Economic Freedom Score      | /10, higher better     | CATO Institute         | Never — see below |
| Right-to-Work State         | Yes/No, yes better     | NRTW                   | Never — see below |
| Regulatory Burden Rank      | Rank, lower better     | QuantGov RegData       | With each release |

Regulatory Burden covers 48 states from QuantGov; Arkansas and West
Virginia keep a hand-entered CATO rank instead.

## Metro metrics

Eighteen metrics must be present for a metro to be served, plus four
inherited from the metro's state and two that only exist for 34 large
metros.

| Metric                      | Unit / direction       | Source                                  | Refresh    |
| --------------------------- | ---------------------- | --------------------------------------- | ---------- |
| Population                  | Count, neutral         | Census ACS                              | Annual     |
| Unemployment Rate           | %, lower better        | BLS LAUS                                | Monthly    |
| Labor Force Participation   | %, higher better       | Census ACS                              | Annual     |
| Bachelor's Degree+          | %, higher better       | Census ACS                              | Annual     |
| Avg Commute Time            | Minutes, lower better  | Census ACS                              | Annual     |
| Median Annual Wage          | $, higher better       | BLS OEWS                                | Annual     |
| Total Employment            | Count, higher better   | BLS QCEW                                | Quarterly  |
| Per Capita Income           | $, higher better       | BEA Regional                            | Annual     |
| Metro GDP ($M)              | $M, higher better      | BEA Regional                            | Annual     |
| Median Rent (2BR)           | $, lower better        | Census ACS, else HUD FMR                | Annual     |
| Median Home Value           | $, lower better        | Census ACS                              | Annual     |
| Elec Rate (¢/kWh)           | ¢/kWh, lower better    | EIA — state rate applied                | Monthly    |
| Disaster Declarations (5yr) | Count, lower better    | FEMA                                    | Monthly    |
| Avg Air Quality Index       | Index, lower better    | EPA AQS                                 | Annual     |
| Violent Crime Rate          | Per 100k, lower better | FBI CDE — state rate applied            | Annual     |
| Broadband Access            | %, higher better       | FCC BDC                                 | Semiannual |
| Home Value / Income         | Ratio, lower better    | Census ACS                              | Annual     |
| Colleges & Universities     | Count, higher better   | NCES IPEDS                              | Annual     |
| County Health Ranking       | Rank, lower better     | County Health Rankings — 34 metros only | Annual     |
| Physicians per 10k          | Count, higher better   | HRSA AHRF — 34 metros only              | Annual     |
| Tax Climate Rank            | Rank, lower better     | Inherited from the state                | See State  |
| Right-to-Work               | Yes/No, yes better     | Inherited from the state                | See State  |
| Economic Freedom            | /10, higher better     | Inherited from the state                | See State  |
| Workers' Comp Rate          | $/$100, lower better   | Inherited from the state                | See State  |

Two of these are measured for the whole state and applied to every metro in
it — **Elec Rate** and **Violent Crime Rate** — because no publisher
releases them at metro grain. See
[County and metro data quality](https://kb.incenti.co/insights/county-and-metro-data-quality.md).

## County metrics

Twenty-four metrics appear in the County catalogue. Twenty of them can be
replaced by live source values county by county; the four regulatory fields
always follow the county's state.

| Metric               | Unit / direction          | Source                        | Refresh    |
| -------------------- | ------------------------- | ----------------------------- | ---------- |
| Population           | Count, neutral            | Census ACS                    | Annual     |
| Pop. Growth (5yr)    | %, higher better          | Census ACS                    | Annual     |
| Unemployment         | %, lower better           | BLS LAUS                      | Monthly    |
| Labor Force Part.    | %, higher better          | Census ACS                    | Annual     |
| Bachelor's+          | %, higher better          | Census ACS                    | Annual     |
| Median Wage          | $, higher better          | BLS OEWS                      | Annual     |
| Total Employment     | Count, higher better      | BLS QCEW                      | Quarterly  |
| Per Capita Income    | $, higher better          | BEA Regional                  | Annual     |
| Median Home Value    | $, lower better           | Census ACS                    | Annual     |
| Median Rent (2BR)    | $, lower better           | Census ACS, else HUD FMR      | Annual     |
| Electricity Rate     | ¢/kWh, lower better       | EIA — state rate applied      | Monthly    |
| Cost of Living Index | Index, lower better       | BEA RPP — metro or state rate | Annual     |
| Disasters (5yr)      | Count, lower better       | FEMA                          | Monthly    |
| Air Quality Index    | Index, lower better       | EPA AQS — monitored counties  | Annual     |
| Health Percentile    | Percentile, higher better | County Health Rankings        | Annual     |
| Violent Crime        | Per 100k, lower better    | FBI CDE agency roll-up        | Annual     |
| Physicians /10k      | Count, higher better      | HRSA AHRF                     | Annual     |
| Broadband Access     | %, higher better          | FCC BDC                       | Semiannual |
| Home/Income Ratio    | Ratio, lower better       | Census ACS                    | Annual     |
| Avg Commute          | Minutes, lower better     | Census ACS                    | Annual     |
| Tax Climate Rank     | Rank, lower better        | State-level reference value   | See below  |
| Economic Freedom     | /10, higher better        | State-level reference value   | See below  |
| Right-to-Work        | Yes/No, yes better        | State-level reference value   | See below  |
| Workers' Comp        | $/$100, lower better      | State-level reference value   | See below  |

> **Warning:** County numbers are not all measured at county grain. Where a source has no
> value for a county, Insights falls back to a modelled figure derived from
> that county's state, and the four regulatory fields always come from a
> stored state-level reference rather than the live state row. Read
> [County and metro data quality](https://kb.incenti.co/insights/county-and-metro-data-quality.md)
> before quoting a county figure in a client deliverable.

## City metrics

City level is built from a single family of sources. Fourteen indicators are
measured for the place itself, all from the Census American Community Survey
5-Year estimates (with the 2020 Decennial count as the population anchor):
**Population**, **Pop. Growth (5yr)**, **Median Age**, **Poverty Rate**,
**Median HH Income**, **Per Capita Income**, **Median Home Value**, **Median
Rent**, **Home/Income Ratio**, **Median Wage**, **Labor Force Part.**,
**Bachelor's+**, **Avg Commute**, and **Broadband Access**. These refresh
annually when the ACS 5-Year release lands.

Everything under **More indicators** is either a city-grain upgrade from a
separate source (BLS LAUS unemployment, Zillow home value and asking rent,
FBI municipal crime) or a county figure inherited by the place. See
[City-level data](https://kb.incenti.co/insights/city-level-data.md) for the full list and for
what the **County** pill means.

## Reference fields that never refresh

Six State metrics have no machine-readable publisher, so they are
transcribed by hand and stay frozen until someone updates them:

- **HS Graduation Rate**
- **Tax Climate Rank**
- **Workers' Comp Rate**
- **Economic Freedom Score**
- **Right-to-Work State**
- **Freight Volume Index**

These values carry the publication year of the reference they were taken
from, not the month of the last ingestion run. Two fields that used to be on
this list — **Health Premium (Annual)** and **Regulatory Burden Rank** — now
come from live sources, with the transcribed values kept only as a fallback.

Because these four also flow through to Metro (as **Regulatory (State)**)
and County, a frozen state field is frozen at every level.

## What happens when a source is unavailable

Each metric is resolved through the same three-step chain on every
ingestion run:

1. **Live** — this run fetched a fresh value from the source.
2. **Reference** — no fresh value, so the hand-entered reference value is
   used.
3. **Carryover** — neither of the above, so the previous run's value keeps
   serving.

A carried-over value looks exactly like a fresh one in the product; nothing
in the interface marks it. If every tier fails for a required metric, the
consequence depends on the level:

- **State and Metro** — the location is dropped entirely. A state or metro
  is either complete or absent; it is never shown with a gap.
- **County** — the county still appears and the uncovered field falls back
  to a modelled value.
- **City** — the cell shows **—**. A withheld city value is never replaced
  by its county's number.

## The refresh calendar

Metric ingestion runs monthly, one level per day, at 06:00 UTC:

| Dataset                 | When it runs            |
| ----------------------- | ----------------------- |
| States                  | 2nd of each month       |
| Metros                  | 3rd of each month       |
| Counties                | 4th of each month       |
| Cities                  | 5th of each month       |
| Map boundaries          | Once a year, 6 November |
| Program catalogue check | Every Monday            |

A monthly run does not mean every number changes monthly. It means each
source is asked for its latest release on that date; an annual source simply
returns the same figure until it publishes again.

Three datasets are not on a schedule at all and update only when a new
extract is loaded:

- **EDD regions** — the coded economic development district priorities.
- **Incenti Subsidy Intelligence** — the incentive award dataset behind
  **Incentives**. Extracts have historically arrived a few times a year, and
  an automated check flags the dataset internally once it is more than 90
  days old.
- **The verified program catalogue** — re-checked weekly, with each program
  carrying its own **Verified** month.

## Common questions

**Q: Where does a specific number come from, and what year is it?**
A: The tables above name the publisher and the refresh cadence for every
metric at each level. The product itself only prints a source and period on
the City panel's **More indicators** rows and in the expanded row of the
Metro table; for everything else this page is the reference.

**Q: When was the data last updated? Is there a page in the product that
shows the last refresh date?**
A: No — there is no "last refreshed" display in Insights. Metric ingestion
runs monthly on the calendar above (states on the 2nd, metros the 3rd,
counties the 4th, cities the 5th), and each source contributes its newest
published release on that date.

**Q: Do the EDD priorities and the incentive award data refresh monthly
too?**
A: No. Both are loaded from extracts rather than run on a schedule.
Incentive award extracts typically arrive a few times a year; EDD region
coding is refreshed when a new dataset is published. The verified program
catalogue is the exception — it is re-checked weekly.

**Q: Why does my state's Tax Climate Rank never change?**
A: Tax Climate Rank is one of six state fields with no machine-readable
publisher, so it is transcribed by hand and carries the publication year of
the source it came from. It changes when the underlying index is
re-published and the reference value is updated, not on the monthly cycle.

**Q: A number looks out of date even though the monthly run happened. What
does that mean?**
A: Most sources publish annually or semiannually, so a monthly run usually
re-fetches the same figure. If a source is briefly unreachable, the previous
value keeps serving rather than the metric disappearing — the product does
not flag that, so treat the cadence column above as the real update rhythm.

**Q: Can I get the raw data or an API?**
A: Not directly. You can download your current selection as a CSV from
**Explore** at any level — see
[Export and CSV formats](https://kb.incenti.co/insights/export-and-csv-formats.md) — or generate a
report. There is no customer-facing Insights API.

## Related

- [Insights overview and data coverage](https://kb.incenti.co/insights/overview-and-data-coverage.md)
- [How Insights scores are calculated](https://kb.incenti.co/insights/how-scores-are-calculated.md)
- [County and metro data quality](https://kb.incenti.co/insights/county-and-metro-data-quality.md)
- [City-level data](https://kb.incenti.co/insights/city-level-data.md)
- [Export and CSV formats](https://kb.incenti.co/insights/export-and-csv-formats.md)
