# Languages by Country and Territory

Source language-use percentages and official-status labels linked to territory identifiers.

## Contents

| File | Records | Format |
|---|---:|---|
| territory-languages.json | 1,589 | JSON array |

The download contains the populated data, a field dictionary, source metadata, reuse terms, a change log and file digests. It contains no scripts, libraries, executables or conversion tools.

## Coverage

All languagePopulation entries in the pinned CLDR territoryInfo file. The source combines estimates of differing ages and does not provide a per-row observation date. Retrieval time must not be treated as a census date. Percentages are not additive across languages.

## Sources and dates

- [Unicode CLDR](https://raw.githubusercontent.com/unicode-org/cldr-json/48.2.1/cldr-json/cldr-core/supplemental/territoryInfo.json): 48.2.1. Retrieved 2026-09-08T02:02:41.505743+00:00.

## Read the data

JSON tables are arrays of records. GeoJSON files are FeatureCollections, with data fields under each feature’s properties. `data-dictionary.json` defines the fields, units, nulls and observed types. `metadata.json` supplies primary keys and source hashes. Preserve identifiers as text and distinguish missing values from zero.

## Example record

This is an actual record from the data. For map layers, the example shows properties; the downloaded GeoJSON also contains the complete geometry.

```json
{
  "territory_code": "AC",
  "language_id": "en",
  "population_percent": 99.0,
  "official_status": null,
  "literacy_percent": null,
  "writing_percent": null
}
```

## Reuse terms

Unicode-3.0. Copyright Unicode, Inc. and contributors. Derived from Unicode CLDR JSON release 48.2.1. Normalized by Arcomm on 2026-09-08.

[Publisher terms](https://www.unicode.org/license.txt). License notices are included where supplied.

## Tracking changes

Compare (territory_code, language_id), source percentages and official-status labels after CLDR releases.

This publication is a snapshot. No automatic refresh is scheduled. New imports must preserve their source version, retrieval date and hashes, then publish a new Arcomm revision.

## Download

[Download the file](/files/8f812b56a4f78a9487d0106167fe44423c0a1e0d03ddc0e68e980f82f40fcf71)

SHA-256: `8f812b56a4f78a9487d0106167fe44423c0a1e0d03ddc0e68e980f82f40fcf71`

Size: 18739 bytes.

## Revisions

[Revision history](/agent/docs/languages-by-territory/history)