Skip to content

Smart Tags

Smart Tags are similar in function to standard, user-submitted (site) tags, but we derive them by machine learning models and apply them automatically to all new posts that meet our criteria:

  • The post must contain at least 300 words. From there, we will only analyze the article body for tags. We do not factor in the title, URL, subtitle, etc.
  • The post must have a publication date after April 1, 2021.

Types of Tags

Site tags are the tags you’ve added in your CMS. You define them. They have a blue background and no border.

High-level Smart Tags are broad categories (Sports, Health & Fitness, etc). They’re roughly analogous to sections and are based on the Internet Advertising Bureau’s content taxonomy. We display them on a blue background with a dotted blue line and a blue 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. We’ve built their taxonomy on the basis of Wikipedia entries. We display these on a white background, with the same dotted line and corner.

Viewing Tags

You can view Smart Tags on the Tags page, post detail pages, reports, and exports.

Tags Page

Selecting Smart Tags

Post Detail Page

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

Smart Tags on Post Details Page

Reports

When creating a report that delivers results per tag, we will identify each smart tag with “(high-level smart tag)” or “(low-level smart tag).” Site tags, the ones that you’ve added via metadata, will have no

Exports

Exports that focus on tags will include a column called “Tag Type.” This column will contain values of “site tag”, “low-level smart tag”, or “high-level smart tag.”

FAQs

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 we surface post details (analytics endpoint, recommendations, etc). You can find them co-located 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 languages other than English?

No, except for proper nouns, we only support smart tags in English. However, you can display other metadata from your site in other languages.

If I edit a post, will the Smart Tags update?

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.

I don’t like some of these tags and others are missing!

We refine the machine learning models 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. With this feature tagging content in the background, 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?

You can enable or disable this feature 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: September 09, 2024