Documentation

Start typing to search.

Browse documentation

Breaking change Y Yext Ready in Improvado

Yext: Common Terms Insights retired, replaced by Review Keywords Insights

Updated
October 22, 2026
Affected
Common Terms Insights (retired) Review Keywords Insights (new)
What to do
Action required — add Review Keywords Insights to your extraction. The retired report cannot be repaired and will not resume, so nothing happens automatically. Your existing Common Terms Insights data stays where it is and is not deleted.

In its February 2025 release Yext deprecated the Frequent Words review dimension and removed it from the platform. Improvado's Common Terms Insights report was built on that dimension, so Yext rejected every request and the report returned no rows from 19 February 2025 onward.

Yext's replacement is its Keywords dimension. Because the retired report had produced nothing for more than a year, and because Keywords is a different extraction rather than a renamed one, we published a new report instead of altering the old one in place — so that your historical data keeps one clear meaning and the new data keeps another.

What you need to do

Add Review Keywords Insights to your Yext extraction. This does not happen automatically. The retired report stays visible on existing extractions but cannot be repaired, and it can no longer be added to new ones.

What the new report gives you

  • Keywords instead of frequent words. Yext's Keywords dimension returns extracted review keywords, including multi-word phrases such as customer service or loan officer. It also drops the bare filler words the old dimension surfaced — the previous report could return was or and as a term.
  • Two new measures. Keyword Mentions counts how often a keyword appears, and Keyword Sentiment scores it from 0 to 1. Sentiment is an average Yext has already calculated across mentions, so it should be read as-is rather than added up.
  • Rating is a column, not five columns. The old report spread review counts across 1 stars … 5 stars. The new one has a single Rating column, so each row is one date, location, rating and keyword. Dashboards built on the old star columns need rebuilding against the new shape.

Counting reviews in this report

A review that mentions five keywords appears on five rows, so the review count is per keyword and does not add up to the location's true review total. This was equally true of the retired report. For an unduplicated count of reviews by rating, use Reviews Overview.

Your existing data

Rows collected up to 19 February 2025 are untouched and stay queryable where they are. The new report writes to its own table, so the two are never mixed. There is no backfill of the period when Yext was rejecting the request — whether any of that range can still be retrieved depends on Yext's own retention for the Keywords dimension, so contact your Improvado customer success manager if you need it.

If the new report returns nothing

Keywords requires Yext's Reviews analytics on the account, the same entitlement the retired report needed. If your Yext account has lost access to Reviews analytics, the new report will be rejected too until that access is restored. Your customer success manager can confirm which of your locations are affected.