> ## 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.

# October 2024 Release Notes

| Release Name | Dataset Version | Publish Date |
| :----------- | :-------------- | :----------- |
| October 2024 | `v28.0`         | 10/01/2024   |

*v28.0 was released on **October 1, 2024**.*

Welcome to our October 2024 release notes! We have exciting updates to share as we head into the final quarter of 2024!

Here are some of the key highlights:

* A new [headline field](#headline-person-schema) in our Person schema
* Our new [taxonomy for Job Roles and Subroles](#-new-role-and-sub-role-job-title-taxonomy-person--company--ip) has entered **General Availability** (bringing a [20% increase in coverage](#taxonomy-stats) !)
* A new [CSV Batch Enrichment tool](#api-dashboard-batch-enrichment-tool) for self-serve customers coming later this month
* Significant [QA improvements](#commentary) in our Company Dataset
* Over [329M job updates](#freshness) with [11M job changes](#job-changes) tracked globally in our dataset from this past quarter

Excited yet? Read on to learn more, or jump to a specific section using the table of contents below.

## 📣 Key Announcements

### Schema Changes

#### `headline` ([Person Schema](/docs/person-schema#headline))

| FIELD NAME | FIELD TYPE | FIELD DESCRIPTION                                    | EXAMPLE                                                  |
| :--------- | :--------- | :--------------------------------------------------- | :------------------------------------------------------- |
| `headline` | `String`   | The brief headline associated with a person profile. | `"headline": "senior data engineer at people data labs"` |

We’ve added a new `headline` field to our Person Data schema that represents the text headline associated with person profiles.

This field is available in our **premium** resume field bundles. Any customers currently receiving `summary` fields will also have access to the new `headline` field. To get access to these field bundles, please reach out to your Customer Success team.

***

## ❗Breaking Changes

### ❗ New Role and Sub Role Job Title Taxonomy (Person / Company / IP)

Change expected in: **v29.1 / February 2025** **Previous Announcements:** [v26 / April 2024](/changelog/april-2024-release-announcement-v260#title-tagging-updates)**,** [v27.0 / July 2024](/changelog/july-2024-release-announcement-v270#title-taxonomy), [v27.1 / August 2024](/changelog/august-2024-release-announcement-v271#title-taxonomy), [v27.2 / September 2024](/changelog/september-2024-release-announcement-v272#title-taxonomy)

Products Impacted: **Person** / **Company** / **IP Schema**

| Person Fields Impacted                                                                  | Company Fields Impacted                                                                                                                                                                                 | IP Fields Impacted                                   |
| :-------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------- |
| job\_title\_role job\_title\_sub\_role experience.title.role experience.title.sub\_role | average\_tenure\_by\_role employee\_count\_by\_month\_by\_role employee\_count\_by\_role recent\_exec\_departures recent\_exec\_hires top\_next\_employers\_by\_role top\_previous\_employers\_by\_role | person.job\_title\_role person.job\_title\_sub\_role |

Over the past few months, we have been making significant changes to our `job_title_role` and `job_title_subrole` enum values in order to improve our fill rates and categorization of job titles. In August 2024 (v27.1) we launched the first beta version of this new taxonomy to give customers an early opportunity to evaluate the data and provide feedback. **As of this October release (v28.0), this new taxonomy has now entered General Availability (<a id="taxonomy-stats" />[see coverage stats below](#special-coverage-stats-new-role--sub-role-taxonomy-fill-rates))**.

The new taxonomy is now fully available to all customers via API and flat file deliveries. To access these new fields customers will have the option to explicitly opt-in for v28.0, v28.1, and v28.2 (Oct - Dec releases) by reaching out to your CS / TS team to enable these fields in your data deliveries or by using a parameter in the API.

The previous (legacy) taxonomy has now entered its deprecation period with support fully ending as of February 2025 (v29.1). Existing customers using the legacy taxonomy can choose to delay opting-in to receive the new taxonomy until the legacy taxonomy is fully deprecated in the v29.1 release. **In February 2025 (v29.1), all PDL datasets for all customers will be transitioned to the new taxonomy**.

**Our Recommendations** If you are an existing customer who has not yet evaluated the new taxonomy:

* Please reach out to receive a sample as soon as possible
* Opt-in to the new taxonomy and begin transitioning your systems to the new taxonomy. The January 2025 (v29.0) release will be the last supported release that you will be able to receive the legacy taxonomy. In February (v29.1), all customers will be transitioned to the new taxonomy. Connect with your CS and TS team to plan and coordinate your migration process.

If you an existing customer who has already begun evaluating the data or participated in the beta release:

* Continue or begin your migration process. We strongly encourage you to fully transition your systems to using the new taxonomy as early as possible ahead of the February 2025 deprecation to provide time to address any unforeseen transition challenges you run into.

If you are a new customer or you do not currently use any of the fields impacted by this change:

* Please opt-in to the new taxonomy as this will be the taxonomy supported moving forward.

**Timeline**

Given the scope of the changes, our goal is to provide clear visibility on the process and ample opportunity to work through this transition together. The timeline for this release is as follows:

**✅ V27.0 (July 2024) - Breaking Change Announcement and Resource Launch:**

* Public notice of our planned role / subrole transition and initial resources provided (see below)

**✅ V27.1 (August 2024) - Beta:**

* We will open up beta access to the new role / subrole taxonomy as well as a new data field `title.class`
* Customers will be able to test sample data by our Technical Services team to explore the new taxonomy and the potential data impacts
* We will release a guide documenting our recommended best practices for transitioning to the new taxonomy with the beta release as well

**✅ V28.0 (October 2024) - General Availability:**

* We will make the new role / subrole taxonomy generally available for all customers and begin the deprecation process for the previous taxonomy
* Customers can opt in to accessing the new taxonomy via API and flat file deliveries (but will have the option to delay transitioning until their systems are updated)

**V29.1 (February 2025) - Final Deprecation:**

* We will fully deprecate and officially end support for the previous taxonomy
* All new and existing customers will be moved onto the new role / subrole taxonomy.

**Resources**

Please use the following resources to better understand the upcoming changes and to start preparing for the transition. As always, reach out to your Customer Success and Technical Services teams for questions and support.

The new set of canonical classes, roles, and subroles is here:

* [Job Title Class \[post-v27.1\]](/docs/job-title-class-post-v271)
* [Job Title Roles \[post-v27.1\]](/docs/job-title-roles-post-v271)
* [Job Title Subroles \[post-v27.1\]](/docs/job-title-subroles-post-v271)
* [Mapping of Job Title Class to Roles to Subroles \[post-v27.1\]](/docs/mapping-job-title-class-to-roles-to-subroles-post-v271)

The mapping from the legacy role/subrole taxonomy to the new taxonomy is here: [Role / Subrole Taxonomy Restructure \[post-v27.1\]](https://docs.google.com/spreadsheets/d/1XCYraEJnMIG5AgmVCzZOpdWZZMlIG7_xq5LXbSY-9b8/edit?usp=sharing)

A set of sample records illustrating this new role / subrole taxonomy is here:

* [Example Person Record \[New Role / Subrole Taxonomy\]](/docs/example-person-record-new-role-subrole-taxonomy)
* [Example Company Record \[New Role / Subrole Taxonomy\]](/docs/example-company-record-new-role-subrole-taxonomy)
* [Example IP Record \[New Role / Subrole Taxonomy\]](/docs/example-ip-record-new-role-subrole-taxonomy)

### ❗ Location Country Enum Updates

Change expected in: **v28.0 / October 2024** Previous Announcements: [v27.0 / July 2024](/changelog/july-2024-release-announcement-v270#location-updates), [v27.1 / August 2024](/changelog/august-2024-release-announcement-v271#location-updates), [v27.2 / September 2024](/changelog/september-2024-release-announcement-v272#location-updates)

Products Impacted: **Person** / **Company** / **IP Schema**

| Person Fields Impacted                                                                                                                                                                 | Company Fields Impacted                       | IP Fields Impacted                              |
| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------- | :---------------------------------------------- |
| location\_country countries street\_addresses.country possible\_street\_addresses.country job\_company\_location\_country experience.company.location.country education.school.country | location.country employee\_count\_by\_country | ip.location.country Ip.company.location.country |

This quarter we have updated the set of [canonical countries](/docs/location-countries) values to better accommodate geographical renamings as well as correct redundancies in our set of country values.

This change is part of an ongoing effort to improve our overall location standardization process within our data. As such it impacts the location country values in our Person, Company and IP datasets, as shown in the table above.

The updated set of country values is available here:

* [Location Countries](/docs/location-countries)

In addition a mapping from the current country values to the upcoming country values can be found here:

| Country (pre-v28.0) | Change Type | Country (post-v28.0) | Comments                       |
| :------------------ | :---------- | :------------------- | :----------------------------- |
| `swaziland`         | Renamed     | `eswatini`           |                                |
| `antarctica`        | Deleted     | –                    |                                |
| `macedonia`         | Renamed     | `north macedonia`    |                                |
| `pitcairn`          | Renamed     | `pitcairn islands`   |                                |
| `gambia`            | Renamed     | `the gambia`         |                                |
| `ivory coast`       | Deleted     | –                    | Redundant with `côte d'ivoire` |

### ❗ Company Type Enum Change

Products Impacted: **Person** / **Company** **Schema** Previous Announcements: [v27.0 / July 2024](/changelog/july-2024-release-announcement-v270#company-type-updates), [v27.1 / August 2024](/changelog/august-2024-release-announcement-v271#company-type-updates), [v27.2 / September 2024](/changelog/september-2024-release-announcement-v272#company-type-updates)

Change expected in: **v28.0 / October 2024**

| Person Fields Impacted                     | Company Fields Impacted |
| :----------------------------------------- | :---------------------- |
| job\_company\_type experience.company.type | type                    |

This quarter, we have updated the set of [canonical company type](/docs/company-types) values to include a new `public_subsidiary` value in the set of canonical values:

| Canonical Company Types (pre-v28.0)             | Canonical Company Types (post-v28.0)                                   |
| :---------------------------------------------- | :--------------------------------------------------------------------- |
| educational government nonprofit private public | educational government nonprofit private public **public\_subsidiary** |

This change is part of an ongoing effort to [improve the coverage and accuracy of our stock ticker fields](/changelog/september-2024-release-announcement-v272#company-data-improvements). The addition of the `public_subsidiary` company type is intended to provide customers a mechanism to easily filter and pull public companies and their subsidiaries, and to provide a more specific label indicating that the company is owned by a public company. Previously, companies like Slack (which is owned by Salesforce) would have been labeled as `private` in our data. With this release, Slack will be labeled as a `public_subsidiary`.

### ⚠️ Upcoming Breaking Changes <a id="upcoming-breaking-changes" />

<Warning>
  **Upcoming Breaking Changes**

  **Upcoming breaking changes** may impact your current processes. We are announcing them here to provide ample time for you to adjust your processes accordingly.
</Warning>

##### ⚠️ New Release Schedule (All Products)

Change expected in: **v29.0 / January 2025** Products Impacted: **All PDL Products**

Beginning in January 2025 (v29.0), we will be modifying the schedule for our releases, shifting the release date by 15 days to the middle of the month.

Currently, all releases (major and minor) occur on the first Tuesday of every month. Under the new schedule, all releases will occur on the **third Tuesday of the month**, with the first release following this new schedule occurring on January 21, 2024 (v29.0).

**Why are we making this change?** The primary goal for this change is to increase the freshness of our company insights data, which is built off the “last completed month” of data. Shifting our release schedule by half a month allows us to build our data immediately after the completion of a month. The end result is that we will be able to report our insights data with an extra month’s worth of freshness.

**Timeline** Here is a preview of the timeline for this change as we transition to the new release schedule:

| Release Version          | Release Date     | Comments                       |
| :----------------------- | :--------------- | :----------------------------- |
| v28.0                    | October 1, 2024  | First Tuesday of the month     |
| v28.1                    | Nov 5, 2024      | First Tuesday of the month     |
| v28.2                    | Dec 3, 2024      | First Tuesday of the month     |
| **v29.0 (new schedule)** | **Jan 21, 2025** | **Third Tuesday of the month** |
| v29.1                    | Feb 18, 2025     | Third Tuesday of the month     |

<Warning>
  Notice that between v28.2 and v29.0 there will be an additional gap of half a month as we shift from one release schedule to the other.
</Warning>

##### ⚠️ Deprecation of `gics_sector` (Company)

Change expected in: **v29.0 / January 2025** Products Impacted: **Company**

|              Company Fields Impacted             |
| :----------------------------------------------: |
| [gics\_sector](/docs/company-schema#gics_sector) |

In January 2025 (v29.0), we will be removing the `gics_sector` field from our data. This change will only impact a subset of records in our company dataset.

Currently, this field is only populated in 27.8k PDL company records (0.003% of our company dataset) since it is derived from the self-identified industry sector reported in the filings of public companies. This field is redundant with other self-reported industry fields contained in our company records (and with much higher coverage). As a result, we have made the decision to deprecate this field in favor of our other industry field representations.

For customers interested in continuing to source public company sector information, we recommend the following resources:

* Free web sources:
  * [Finbox.com](http://finbox.com): Presents the GICS sector label on each company profile ([example](https://finbox.com/NASDAQGS:NVDA/))
  * [Yahoo! Finance](http://finance.yahoo.com): Presents the Morningstar sector label on each company profile ([example](https://finance.yahoo.com/quote/NVDA/))
* Paid API and programmatic resources:
  * [SEC-API.io](http://SEC-API.io): Provides an API endpoint that returns the Morningstar sector label among the company attributes returned ([documentation](https://sec-api.io/docs/mapping-api/map-ticker-to-company-details))
  * [Financial Modeling Prep](http://financialmodelingprep.com): Provides an API endpoint that returns the Morningstar sector label among the company attributes returned ([documentation](https://site.financialmodelingprep.com/developer/docs#company-profile-company-information))

##### ⚠️ Deprecation of `version_status` (Person)

Change expected in: **v29.0 / January 2025** Previous Announcements: [v17.0 / January 2022](/changelog/january-2022-release-notes-v17#deprecations-a-namedeprecationsa)

Products Impacted: **Person**

| Person Fields Impacted                         |
| :--------------------------------------------- |
| [version\_status](/docs/fields#version_status) |

In January 2025 (v29.0), we will be removing the `version_status` field from our person dataset.

We officially deprecated this field in [January 2022 (v17.0)](/changelog/january-2022-release-notes-v17#deprecations-a-namedeprecationsa). While this field has continued to exist in our data since then, we have introduced more reliable references to a profile’s history / lineage across releases via the recommended alternatives below. As such, we are fully removing this field from our schema.

**Recommended Alternatives** For customers that were using the `version_status` field to lookup the current version of the data, please use the `dataset_version` field available in both our [Person](/docs/fields#dataset_version) and [Company](/docs/company-schema#dataset_version) records.

For customers using this field to understand the change history of records, please use the ID Changelog for the relevant monthly / quarterly time period that you are looking to compare against.

##### ⚠️ Free-Tier Restructure for Self-Serve Plans

Change expected in: **v29.0 / January 2025** Products Impacted: **Person**

| Person Fields Impacted                                                                                                                                                                                                                                                                                                                                                                                                                    |
| :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [work\_email](/docs/fields#work_email) [recommended\_personal\_email](/docs/fields#recommended_personal_email) [personal\_emails](/docs/fields#personal_emails) [emails](/docs/fields#emails) [phone\_numbers](/docs/fields#phone_numbers) [mobile\_phone](/docs/fields#mobile_phone) All [locations](/docs/fields#location) (except country and continent) [birth\_date](/docs/fields#birth_date) [birth\_year](/docs/fields#birth_year) |

In January 2025, we will be restructuring all existing free-tier plans to limit access to specific fields in our Person datasets. This change impacts all self-serve customers with free tier plans created before July 29, 2024.

Back in July 2024, we made the decision to limit access for new free tier plans to certain person fields that were prone to exploitation for unauthorized and potentially nefarious use cases. Based on the usage patterns we’ve observed since then, we have made the decision to migrate all legacy free tier users to this new free tier plan.

This migration will go into effect in January 2025, after which the person fields shown in the table above will be converted from values to True/False flags. To continue accessing these fields, customers will need to upgrade to a Pro plan with at least \$100 minimum monthly commitment.

**Example Free Tier Field**

| Legacy Plan (Pre-Migration)                                             | New Plan (Post-Migration) |
| :---------------------------------------------------------------------- | :------------------------ |
| `”work_email”: “[sr49@chang-fisher.com](mailto:sr49@chang-fisher.com)”` | `”work_email”: true`      |

***

## ✨  New Products and Features

### API Dashboard Batch Enrichment Tool

This month, we will be launching a new batch enrichment tool in our API dashboard for Free and Pro-tier self-serve users. This service will allow users to run their own batch enrichments on a CSV file without writing a single line of code.

This new Batch Enrichment tool will replace our existing Data Stats tool which allows users to understand fill and match rates across our Person, Company and IP datasets. The Batch Enrichment tool will follow a similar workflow, where users can upload a CSV of Person/Company/IP records to process. After processing, users will be able to view a fill rate report as well as purchase the enriched records and premium field add-ons.

This service will be launching later this month in our self-serve dashboard, so stay tuned!

<Info>
  **Enterprise Customer? Try our Professional Services!**

  Note that this batch enrichment tool through the API Dashboard will only be available to self-serve users. For enterprise customers, our Technical Services team offers a variety of Professional Services including bulk enrichment of data as well as customizable reporting, query building support, and more.  If you are interested in learning more, please reach out to your Customer Success or Data Consultant team members.
</Info>

***

## 🚀 Data Updates

### Freshness

*The number of jobs and locations verified in our datasets over the past **quarter** (based on the `job_last_verified` and `location_last_updated` fields).*

| Dataset | Geography     | Field        | Records Updated |
| :------ | :------------ | :----------- | --------------- |
| Resume  | Global        | `experience` | 329,930,531     |
| Resume  | Global        | `location`   | 414,033,487     |
| Resume  | United States | `experience` | 82,498,685      |
| Resume  | United States | `location`   | 102,331,975     |

#### Job Changes

*The number of person records where the primary job experience changed in our Person Dataset over the past **quarter** (based on the `job_last_changed` field).*

| Dataset | Geography     | Records Updated |
| :------ | :------------ | --------------- |
| Resume  | Global        | 11,218,923      |
| Resume  | United States | 4,547,294       |

### Coverage (Full Stats: [Person](/docs/datasets), [Company](/docs/company-stats))

**[Resume Dataset](/docs/resume-stats)**

| Linkage        | Coverage in v27.0 | Coverage in v28.0 | Increase (%) |
| :------------- | :---------------- | :---------------- | :----------- |
| total\_records | 721,091,212       | 727,795,179       | 0.93%        |
| mobile\_phone  | 53,145,648        | 67,619,579        | 27.23%       |
| birth\_date    | 8,953,517         | 10,061,983        | 12.38%       |

[API Dataset](/docs/stats)

| Linkage           | Coverage in v27.0 | Coverage in v28.0 | Increase (%) |
| :---------------- | ----------------- | ----------------- | ------------ |
| total\_records    | 2,794,528,725     | 2,466,332,645     | -11.74%      |
| street\_addresses | 763,464,633       | 495,472,458       | -35.10%      |
| birth\_year       | 510,506,896       | 379,611,616       | -25.64%      |
| emails            | 890,326,394       | 699,856,550       | -21.39%      |
| phones            | 1,156,838,256     | 930,152,340       | -19.60%      |
| sex               | 2,009,628,718     | 1,762,357,934     | -12.30%      |

[Email Dataset](/docs/email-stats)

| Linkage           | Coverage in v27.0 | Coverage in v28.0 | Increase (%) |
| :---------------- | ----------------- | ----------------- | ------------ |
| total\_records    | 824,742,873       | 636,349,647       | -22.84%      |
| street\_addresses | 353,772,740       | 238,136,599       | -32.69%      |
| personal\_emails  | 564,084,125       | 407,345,043       | -27.79%      |
| birth\_year       | 198,081,215       | 147,086,729       | -25.74%      |

[Company Dataset](/docs/company-stats)

| Linkage              | Coverage in v27.0 | Coverage in v28.0 | Increase (%) |
| :------------------- | ----------------- | ----------------- | ------------ |
| total\_records       | 66,496,323        | 71,340,278        | 7.28%        |
| affiliated\_profiles | 708,110           | 277,363           | -60.83%      |
| summary              | 55,880,200        | 23,520,617        | -57.91%      |
| industry             | 35,376,284        | 45,736,801        | 29.29%       |
| mic\_exchange        | 22,792            | 27,907            | 22.44%       |
| ticker               | 23,633            | 27,907            | 18.08%       |

#### Special Coverage Stats: New Role / Sub Role Taxonomy Fill Rates

| Metric                                      | Legacy Taxonomy | New Taxonomy | Increase (%) |
| :------------------------------------------ | --------------- | ------------ | ------------ |
| Overall Fill Rate for experience.title.role | 37.5%           | 57.5%        | 20.0%        |

### Commentary

* **Person**
  * We saw a 20% increase in our coverage for roles across our Person data as a result of our recent Role / Subrole taxonomy improvements that have now entered General Availability. See the sections above for additional details on [coverage](#special-coverage-stats-new-role--sub-role-taxonomy-fill-rates) and [access](#-new-role-and-sub-role-job-title-taxonomy-person--company--ip).
  * A 27% increase in our coverage of mobile phones in our resume dataset based on previous improvements to our mobile phone sourcing and QA processes from [September](/changelog/september-2024-release-announcement-v272#commentary).
  * A 35% decrease in street address coverage in our API dataset as a result of our removal of a low-quality, legacy data source last [month](/changelog/september-2024-release-announcement-v272#commentary).
* **Company**
  * We removed \~600k low quality records from our company dataset, the vast majority of which represented LinkedIn “Showcase” pages that had been inadvertently canonicalized as companies. This can be seen in the 60% decrease in `affiliated_profile` coverage highlighted above.
  * An 18% increase in our coverage of stock tickers in our company dataset as part of our ticker improvements released in [September](/changelog/september-2024-release-announcement-v272#company-data-improvements).
  * In our v27.1 August release we had removed \~35 million “autogenerated” or low quality company summaries, which is reflected in the decrease in `summary` field coverage seen in our company stats.

***

## 🛠  Improvements and Bug Fixes

### Improvements

* **Person**
  * We have released the `headline` field to all customers who are receiving the `summary` field
  * Based on customer feedback and poor user experience, we have removed a small percentage of person records that have a LinkedIn ID but no LinkedIn URL.
  * Inversely, we have also removed a small number of company profiles that had LinkedIn URLs but no LinkedIn ID
  * We improved our ability to deconstruct frankenstein records (i.e. falsely merged profiles), which will allow us to start removing them over time
* **Company**
  * We launched a new canonical company type, `public_subsidiary`, that is applied to any company that has an `ultimate_parent` company that is public.
  * In response to user feedback, when a company has provided a Twitter, LinkedIn, Instagram, or Crunchbase URL as its primary website, we now also populate that website in the profiles and top-level social fields of those company records. This added 187,827 new social profiles, including 156,093 Instagram URLs. If there are other other social URL linkages that you’d like to see us target, please provide that feedback on the [PDL Feature Request page](https://feedback.peopledatalabs.com/feature-requests?selectedCategory=company-data).

### Bug Fixes

* We addressed a bug responsible for missing values in the `ultimate_parent_ticker` field.
* We fixed an issue where a large number of VC investors were being dropped from the `funding_details.investing_companies` field.


## Related topics

- [October 2023 Release Notes](/changelog/october-2023-release-notes-v24.md)
- [June 2024 Release Notes](/changelog/june-2024-release-announcement-v262.md)
- [May 2024 Release Notes](/changelog/may-2024-release-announcement-v26-1.md)
- [September 2024 Release Notes](/changelog/september-2024-release-announcement-v272.md)
- [August 2024 Release Notes](/changelog/august-2024-release-announcement-v271.md)