Title: Smart tag FAQs
Author: bethurban
Published: June 9, 2025
Last modified: November 6, 2025

---

 1. [User handbook](https://docs.parse.ly/user-handbook/)
 2. [The Parse.ly Dashboard](https://docs.parse.ly/user-handbook/dashboard/)
 3. [Content Menu](https://docs.parse.ly/user-handbook/dashboard/content-menu/)
 4. [Tags page](https://docs.parse.ly/user-handbook/dashboard/content-menu/tags-tab/)
 5. [Smart tags](https://docs.parse.ly/user-handbook/dashboard/content-menu/tags-tab/smart-tags/)
 6. Smart tag FAQs

#  Smart tag FAQs

## What content types support smart tags?

Smart tags are available for both [posts and non-posts](https://docs.parse.ly/installation-developer-resources/parsely-integration/metadata/#h-post-vs-non-post),
as long as they meet the [eligibility criteria](https://docs.parse.ly/dashboard/content-menu/tags-tab/smart-tags/#0-eligibility-criteria).

## Why don’t some of my posts or non-posts have smart tags?

Smart tags are only added to **new** content that meets both of the following requirements:

 * The [post or non-post](https://docs.parse.ly/installation-developer-resources/parsely-integration/metadata/#h-post-vs-non-post)
   must contain at least 300 words. Only the article body is analyzed for tags.
 * The [post or non-post](https://docs.parse.ly/installation-developer-resources/parsely-integration/metadata/#h-post-vs-non-post)
   must have a publication date after April 1, 2021.

## Can smart tags be added to older 󠀁[posts and non-posts](https://docs.parse.ly/installation-developer-resources/parsely-integration/metadata/#h-post-vs-non-post)󠁿?

Please reach out to your Relationship Manager to discuss pricing for historical 
back-population.

## Are smart tags available in the Parse.ly API?

Yes, smart tags are seen in [Parse.ly API](https://docs.parse.ly/api/) calls wherever
post details are delivered (the [analytics endpoint](https://docs.parse.ly/api-analytics-endpoint/),
[recommendations endpoint](https://docs.parse.ly/content-recommendations/), etc.).
Smart tags are colocated alongside site tags with the following format:

`parsely_smart:tag_type:Example Tag`

In the above API format example, `tag_type` refers to smart tag levels:

 * High-level smart tags are typed as `iab` and appear as `parsely_smart:iab:Example
   Tag`.
 * Low-level smart tags are typed as `entity` and appear as `parsely_smart:entity:
   Example Tag`.

**Note**

While smart tags work for both [posts and non-posts](https://docs.parse.ly/installation-developer-resources/parsely-integration/metadata/#h-post-vs-non-post)
in the Dashboard, the Parse.ly API only returns posts. Non-post smart tags are not
accessible via the API.

## Are smart tags available in Parse.ly’s Data Pipeline?

Yes, smart tags are colocated with site tags in the `metadata_tags` field of the
[Data Pipeline](https://docs.parse.ly/data-pipeline/) using the same format as the
Parse.ly API: `parsely_smart:tag_type:Example Tag` (further described above).

## Are smart tags available in languages other than English?

No, except for proper nouns, smart tags can only be generated in English. However,
other [metadata in languages other than English](https://docs.parse.ly/dashboard/navigating/language-support/)
will display in the Parse.ly Dashboard.

## If a 󠀁[post or non-post](https://docs.parse.ly/installation-developer-resources/parsely-integration/metadata/#h-post-vs-non-post)󠁿 is edited, will its smart tags update?

No, content is analyzed and assigned smart tags once during the first crawl. Edits/
changes made after publication will not trigger a smart tag update.

## Can smart tags be added, removed, edited, or replaced?

No, smart tags assigned to a post are immutable. This capability may be possible
in future Parse.ly releases.

## Smart tags are incorrect, or some are missing!

Parse.ly is continuously refining the machine learning models used with smart tags.
Improved results will be delivered over time.

## How can smart tags help our team?

Smart tags provide insights about content without requiring additional manual effort
from editors and content creators. With this feature, tagging content in the background,
teams can focus on what matters most. Many Parse.ly users employ their own tag taxonomy
alongside smart tags, while others leave content tagging entirely up to the smart
tag system.

## How can smart tags be disabled?

Smart tags can be turned on and off via the [Preferences](https://docs.parse.ly/account-management/preferences/)
panel of the [account menu](https://docs.parse.ly/account-management/) under the“
Smart Tags” section. Options include displaying both high- and low-level smart tags,
only high- or low-level smart tags, or site tags only.

![Smart tag settings in the Preferences panel.](https://docs.parse.ly/wp-content/
uploads/sites/5/2025/05/Smart-tag-settings.png)

Smart tag settings in the Preferences panel.

Last updated: November 06, 2025