You can use Data Highlighter to tag data about a television episode, such as its title, director, reviews, and viewer ratings. Then Google can present your data more attractively -- and in new ways -- in search results and in other products. (Each Google product applies its own rules when deciding whether and how to display your data.)
TV episode tags
You can use Data Highlighter to tag any of the data described in the table below. Each tag corresponds to a property in the schema.org/TVEpisode schema. The name of each tag is followed by the name of the schema.org property in parentheses. Required tags are listed in bold.
Note that the data you can tag with Data Highlighter is a subset of the properties in the schema.org schema.
If your site is missing any of the data described below, you can add missing data from Data Highlighter. If Data Highlighter has a low level of confidence in the tagged data, an alert icon () displays while you are creating a page set. Data Highlighter will still make the low-confidence data available to Google, but other Google products might not use it.
Series Name
(partOfTVSeries)
Episode Name
(name)
Season Number
(partOfSeason)
Episode Number
(episodeNumber)
Image
(image)
Director
(director)
Actor
(actor)
Air Date
(datePublished)
Here are some examples of dates you can tag:
- A single date. For example, you can tag any of the following:
- June 4, 2012
- 4 June 2012
- 6/4/12 - Your tags can include other delimiters and four-digit years as well, such as 6-4-2012 . When numerical dates are ambiguous, Google assumes that the first number is the month. For example, 6/4/12 is intrepreted as June 4, 2012, while 13/4/12 would be interpreted as April 13, 2012.
- A range of days. For example, June 4-7 2012
Note that delimiter between the beginning and ending days needs to be a dash (-).
- Dates with times. For example, you can tag any of the following:
- June 4, 2012 3pm - a time followed by am or pm. Google uses normal business hours to interpet times not followed by am or pm. For example, 11 would be interpreted as 11am and 2 would be interpreted as 2pm.
- June 4, 2012 15:00 - military time
- June 4, 2012 3pm EST or June 4, 2012 3pm -5:00 - Times with a time zone or with a UTC/GMT offset.
- June 4, 2012 2-3pm or June 4-5, 2012 2-3pm - Time ranges with or without a date range.
- Dates in separate pieces.You can use the advanced tagging option to tag the following separate pieces of text as a single date:
- Day: Tuesday, June 4 Year: 2013
- June 4 | Time: 7:30pm-9:30pm and 2012
- June 4-5 and 2012
Official URL
(url)
Average Rating (aggregateRating)
Rating
(ratingValue
andbestRating)
If a single piece of data specifes both the best possible rating and the actual rating, you can use a single Rating tag. For example, tag 65% to indicate a score of 65 out of 100; tag 8 out of 10 to indicate a score of 8 out of 10.
If the data is in different locations on a page, specify the following tags:
-
Score (ratingValue)
- The actual rating. -
Best Possible (bestRating)
- The highest value in the rating system. For example, if the rating scale is between one and five stars, specify 5 as the best rating.
Votes
(ratingCount)
Review
(review)
Reviewer
(author)
Review text
(reviewBody)
Review Rating
(aggregateRating)
Some pages display the actual rating and the best possible rating in a single piece of text or image. Other pages display the two values in separate locations.
If a single piece of data specifes or implies both the best possible rating and the actual rating, use the following tags:
-
Rating (bestRating
andratingValue)
- The rating of the review. For example, tag 65% to indicate a score of 65 out of 100; tag 8 out of 10 to indicate a score of 8 out of 10. -
Votes (
ratingCount)
- The total number of ratings.
If the data is in different locations on a page, use the following tags:
-
Score (ratingValue)
- The actual rating. For example, tag 8 if the page lists 8 as the rating without listing the best possible rating nearby. -
Best Possible (bestRating)
- The highest value in the rating system. For example, tag 10 if the page specifies the best possible rating in the footer. -
Votes (
ratingCount)
- The total number of ratings.
Review Date
(datePublished)
Here are some examples of dates you can tag:
- A single date. For example, you can tag any of the following:
- June 4, 2012
- 4 June 2012
- 6/4/12 - Your tags can include other delimiters and four-digit years as well, such as 6-4-2012 . When numerical dates are ambiguous, Google assumes that the first number is the month. For example, 6/4/12 is intrepreted as June 4, 2012, while 13/4/12 would be interpreted as April 13, 2012.
- A range of days. For example, June 4-7 2012
Note that delimiter between the beginning and ending days needs to be a dash (-).
- Dates with times. For example, you can tag any of the following:
- June 4, 2012 3pm - a time followed by am or pm. Google uses normal business hours to interpet times not followed by am or pm. For example, 11 would be interpreted as 11am and 2 would be interpreted as 2pm.
- June 4, 2012 15:00 - military time
- June 4, 2012 3pm EST or June 4, 2012 3pm -5:00 - Times with a time zone or with a UTC/GMT offset.
- June 4, 2012 2-3pm or June 4-5, 2012 2-3pm - Time ranges with or without a date range.
- Dates in separate pieces.You can use the advanced tagging option to tag the following separate pieces of text as a single date:
- Day: Tuesday, June 4 Year: 2013
- June 4 | Time: 7:30pm-9:30pm and 2012
- June 4-5 and 2012