Skip to content

Smart Tags

Smart Tags are similar in function to standard, user-submitted (site) tags, but have been derived by machine learning models and are applied automatically to all new posts that meet our criteria:

  • The post must contain at least 300 words in order for content to be meaningfully extracted, and only the article body will be analyzed for tags. The title, URL, subtitle, etc. will not be factored in.
  • The post must have been published after April 1, 2021.

Types of Smart Tags

Smart Tags appear alongside any tags you’ve added in your CMS (aka “site tags”) on the Tags page and post details pages.

Site tags are the tags you’ve added in your CMS. You define what they are and how they’re structured. They have a blue background and no border.

High-level Smart Tags are aggregated into broad categories (Sports, Health & Fitness, etc). They’re roughly analogous to sections and are based on the Internet Advertising Bureau’s content taxonomy. They’re displayed on a blue background with a dotted blue line and arrow in the top left corner.

Low-level Smart Tags are typically based on individual entities and subjects within a post, like company names, individuals, objects, events, and places. Their taxonomy is built on Wikipedia entries. They are displayed on a white background, with the same dotted line and arrow.

Viewing Smart Tags

Smart Tags can be viewed from both the Tags page, as well as in post detail pages beneath the title.

Selecting Smart Tags

On post detail pages, we default to showing all tag types (Site, High, & Low) for all posts.

Smart Tags on Post Details Page


Is this a paid feature?

Smart Tags are free for all customers as a core offering of our product.

Can you add Smart Tags to older posts?

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

Are Smart Tags available in the API?

Yes, you will be able to see Smart Tags in API calls wherever post details are surfaced (analytics endpoint, recommendations, etc). Smart Tags are co-located in the tags field alongside your regular site tags but with the following format:

parsely_smart:tag_type:Example Tag where tag_type refers to either High or Low levels.

High-Level Tags are typed as “iab” and will appear as “parsely_smart:iab:Example”.

Low-Level tags are typed as “entity” and will appear as: “parsely_smart:entity:Example”.

Are Smart Tags available in Data Pipeline (DPL)?

Yes, Smart Tags are colocated with regular site tags in the metadata_tags field using the same format mentioned above.

Are Smart Tags available in Reports?

Yes. Smart Tags show up in the same way that Tags show up in reports.

Are Smart Tags available in languages other than English?

No, at present smart tags are only supported in English. We will add tags around proper names, but topic-related tags are limited to English at this time. However, metadata from your site can be displayed in other languages.

If I edit a post, will the Smart Tags be updated?

No, we only analyze and tag a post once during the first crawl. Any edits/changes made to a page will not trigger a tag update.

Can I add/remove/edit/replace a Smart Tag?

Not at this time, Smart Tags placed on a post are immutable. We are looking to change this in the future to allow for more flexibility.

An incorrect/irrelevant/duplicate tag was added! | An obvious tag wasn’t added!

The machine learning models are being refined regularly and we hope to produce better results with time.

How can Smart Tags help me?

We hope that Smart Tags will provide you and your business with additional insights about your content without requiring additional effort from editors and content creators. Once the feature is enabled, it simply works, tagging content in the background so you can focus on what matters most. We expect most users will use Smart Tags in conjunction with their own tag taxonomy, or just let it roll and skip tagging content entirely.

How do I disable Smart Tags?

Smart Tags can be enabled/disabled from the Preferences Panel under the “Tag Listing” setting. From there, you may choose to view only site tags or Smart Tags and site tags.

Last updated: February 23, 2024