Healthcare Taxonomy Update (March '22 Release)

In order to simplify our taxonomy, better align it with our publisher network, and support more streamlined Answers experiences, we will be consolidating several duplicate categories within the healthcare vertical. Any listings that are currently using the categories set to be deprecated will be switched over to the remaining category; this process should be seamless and will have no impact on your listings.

ACTION REQUIRED: Clients who use the Yext Knowledge API to update their healthcare location and/or providers’ data will need to update their ETL to stop referencing any of the merged categories and use only the remaining categories instead. Failure to do so will result in API errors.

The specific changes can be seen below. This change is set for May 11th, any necessary Yext Knowledge API updates should be completed prior to this date. Please reach out to your Yext point of contact with any questions.

Merged Category ID Merged Category Name Remaining Category ID Remaining Category Name
1505902 Medical Bariatrician 2167 Bariatric Medicine
1505880 Breast Medical Oncology 20000002 Breast Medical Oncologist
1355 Cardiology 1505881 Cardiologist
1505912 Pediatric Psychology 1512875 Child Psychologist
1250 Dentistry 1437822 Dentist
1135541 Dermatopathology 1505887 Dermatopathologist
1505895 Geriatric Medicine 2177 Geriatrician
1360 Neurology 1359997 Neurologist
1361 Oncology 1359944 Oncologist
1364 Pathology 1359927 Pathologist
1135566 Pediatric Internal Medicine 1257 Pediatrician
1120596 Physiatry 1359750 Physiatrist
320 Podiatry 1359761 Podiatrist
1366 Proctology 1359746 Proctologist
1326 Psychiatry 1505916 Psychiatrist
1327 Psychology 1505917 Psychologist
1505891 Family Medicine 1135560 Family Practice Physician
20000006 Hematology-Oncology 1505899 Hematology & Oncology
1135568 Pediatric Allergist 20000018 Pediatric Allergy and Immunology
1 Like


I wanted to confirm that the Categories that fall under the Merged Category Name will be replaced/updated by the Remaining Category Name.

For example, an entity that currently has the Category, “Breast Medical Oncology” will be replaced by “Breast Medical Oncologist,” correct?

Thanks for clarifying!


Hi Miriam,

That is correct! Any listings that are currently using the categories set to be deprecated (listed above in the merged Category Name column) will be switched over to the remaining category (listed above in the Remaining Category Name.

Let us know if you have any other questions here!

1 Like


My client has the attached question related to the Hematology Category update. Would you all be able to please clarify? It looks like we are still able to select all three of the following Categories in Yext: Hematology, Hematology & Oncology, Hematology-Oncology.

Thank you very much for your help!


Hi Kate,

Great question, and welcome to the community!

This update is going into effect on May 11th, so you will still see both Hematology & Oncology, and Hematology-Oncology until then. This announcement was intended to give people enough lead time to make the relevant changes. They will want to select the new category so they are all set on May 11th when the change takes place.

As for the Hematology category, that is not changing as part of this update. That is an existing category today that will continue to remain after May 11th.

Let me know if that clarifies, or if you have any other questions here!

Thank you so much, @Caroline_Gould !

Hi there, this change refers to listings. Could you confirm if this will impact entities that are a location entity and also any that use the specific healthcare entities.

Many thanks

Hi Laura,

Any entity that is currently using one of the categories in the “Merged Category Name” column will automatically be switched over to the corresponding category listed in the “Remaining Category Name” column. This will not have an impact on listings (meaning there will be no downtime, etc.), as listings that are currently using the categories set to be deprecated will be switched over to the remaining categories.

The only action that is required is for anyone who is using an ETL, as they will need to update the ETL to reference the “Remaining Category” instead of the “Merged Category”.

Let me know if that clarifies, or if you have any other questions here!

Thanks for confirming Caroline.


Just wanted to confirm, if a client already has an existing ETL where we’re mapping client’s specialties to Yext categories, is it up to Yext to update these codes in the taxonomy?

For example: in the ETL there is a mapping to “Hematology / Oncology” → “1361”. How should this be changed to reflect these Taxonomy updates?

Thank you!
Julie Helenek
CC: @Kate_Edson

Hi Julie,

ETLs will need to be updated to reference the Remaining Category ID from the original post, so in this case you should have “Hematology / Oncology” > “1359944” since that is what corresponds to the old “1361” ID.

But if this doesn’t match your client’s taxonomy, you can choose from one of the other categories.