> ## Documentation Index
> Fetch the complete documentation index at: https://docs.peopledatalabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Canonical Field Values

# Overview

Canonical field values are the normalized, enumerated values we use for schema fields that support a fixed set of choices, autocomplete, or controlled vocabulary.

Many `Enum (String)` and `Array [Enum (String)]` fields in our [Person Schema](https://docs.peopledatalabs.com/docs/fields) and [Company Schema](https://docs.peopledatalabs.com/docs/company-schema) are backed by published canonical datasets. For example, the values for `education.degrees` are defined in [Education Degrees](https://docs.peopledatalabs.com/docs/education-degrees).

## What are canonical field values?

Canonical values are the standard allowed values for certain fields. They are not raw source text; they are curated, normalized terms that help keep search, autocomplete, and schema validation consistent.

Examples include:

* `education.degrees`
* `education.majors`
* `company.types`
* `industry`
* `location.countries`
* `job_title_roles`
* `language_names`

## Why this matters

Using canonical values helps you:

* build queries that align with our searchable values
* avoid mismatches from raw text or alternate spellings
* understand what values are accepted for fields with fixed vocabularies

Our schema pages usually link fields to their canonical value docs when available. If you see a field with a canonical reference, follow that link to see the exact permitted values.

## Common canonical data pages

* [Education Degrees](https://docs.peopledatalabs.com/docs/education-degrees)
* [Education Majors](https://docs.peopledatalabs.com/docs/education-majors)
* [Company Types](https://docs.peopledatalabs.com/docs/company-types)
* [Industries](https://docs.peopledatalabs.com/docs/industries)
* [NAICS Codes](https://docs.peopledatalabs.com/docs/naics-codes)
* [Job Title Roles](https://docs.peopledatalabs.com/docs/job-title-roles)
* [Language Names](https://docs.peopledatalabs.com/docs/language-names)
* [Location Countries](https://docs.peopledatalabs.com/docs/location-countries)
* [Remote Work Policies](https://docs.peopledatalabs.com/docs/remote-work-policies)

<Callout icon="📘" theme="info">
  For a complete list of canonical datasets, browse the subpages under **Data Standardization > Canonical Field Values** on the left-hand navigation bar!
</Callout>

<br />

## Where to access canonical data

Datasets of possible values for many fields are stored in our public Amazon S3 bucket:

* [https://s3.console.aws.amazon.com/s3/buckets/pdl-prod-schema/](https://s3.console.aws.amazon.com/s3/buckets/pdl-prod-schema/)
* current data version: [34.1](https://us-west-2.console.aws.amazon.com/s3/buckets/pdl-prod-schema?region=us-west-2\&prefix=34.1/enums/\&showversions=false\&tab=objects)

We update canonical data quarterly, either by moving files into a new version folder or by updating an existing file. We note updated or changed files in the [Release Notes](https://docs.peopledatalabs.com/changelog).

<br />