Episodes

Valid sources

In some cases, there might be multiple sources that conflict with each other. When that happens, they should be considered in the following order:

  1. Data shown on-screen during the episode's announcement, intro, or credits
  2. Data in a press release or press kit
  3. Data on the show's official website
  4. Data in TV guides/TV listings/EPG's for the show's country
  5. Statements by show crew in articles / interviews

Rewriting history after an episode has premiered is never accepted. For example, if a show's official website indicates that a certain episode belongs to season 1, but changes it to season 2 a year afterwards, it should remain listed as season 1.

Inclusion Policy

An episode should only be added to TVmaze after it has been announced by one of the valid sources above, or once it has premiered. Either the episode name or release date has to be known before a future episode can be added. Adding "TBA" episodes beyond that point is not welcome.

A few examples:

Episode Type

This is either a Regular Episode or a Special. For most shows, deciding whether an episode should be classified as special is fairly easy: if the premise of an episode significally differs from normal episodes and if you can skip it without missing out on any story arcs, it's a special. For example, a scripted show airing a "recap" episode at the beginning of the season that only consists out of fragments from earlier episodes. Or an episode using the same actors as normal, but with a script completely unrelated to the show's regular plot or arcs.

But in some cases it can be more complicated to tell whether an episode is a special or not. If so, refer to the order of the valid sources as described above.

Specials

Specials should be rare. Unless unequivocally declared as such by the original network, if a season has nearly as much specials as regular episodes, you're most likely doing it wrong. Specials should be standalone and not in a serial format with other specials. For example, if each episode in a season is followed by an "after show" or "webisode", those episodes should be in a dedicated show entry.

The inclusion policy for Shows applies to specials as well. This means only content that has premiered on a Network or Web Channel may be added; theatrical movies related to a show may not be added.

Episodes that consist merely of footage duplicated from other episodes (such as trailers, previews, sneak peeks, clip shows) are only allowed when their length is the same as of a regular episode.

Season

The season number for the episode. For the vast majority of shows, the network or web channel announces and assigns season numbers to each episode.

However, some shows like daily soaps or daily talk shows don't have any notion of season numbers. In such a case, the premiere year of the episode should be used as season number. For example, the season number for an episode that aired on June 1st, 2015 should simply be "2015". This also goes for shows that only air once a year, such as award shows: each episode should be placed in its own separate season.

It's not allowed for two seasons to run simultaneously. For example, there cannot be an episode in season 2 with an airdate that's before the last aired episode in season 1. If a source provides season numbering like this, it should be discarded and you should look at the next best source instead. If none of them offer a valid season numbering, fall back to year-based numbering.

Episode number

The unique sequence number of the episode within its season. This should always reflect the order in which episodes were originally premiered. The first non-special episode in a season should always be numbered "1"; specials don't have an episode number.

Two-part episodes can cause contention on whether they should take up a single episode number, or two separate consecutive episode numbers. If this happens, refer to the order of the valid sources as listed above and note that on-screen indicators are considered the primary official source and trump anything else. A few examples:

In all other cases, it should almost definitely be a single entry/episode number. Only if on-screen indicators are unavailable or inconclusive, the other valid sources should be considered in their respective order. Note that DVD numbering should never be considered. Production codes as found on official sites or in press releases can be used as an indicator, but specifically do not trump the on-screen indicators listed above.

Name

The name/title for the episode. For the vast majority of shows, the network or web channel assigns episode titles to each episode. In such a case, the original episode title should be used, without any changes to e.g. the punctuation or capitalization. If a future episode for such a show is officially announced but no title is known yet, "TBA" may be used as name until the title has been announced as well. Suffixes that are not part of the original episode title are strictly forbidden. Examples of that are "(Part 1)", "(Pilot)" or "(a.k.a. Previous Working Title)".

If no official episode titles are available, the rules are as follows. In all these cases, the chosen format must be applied consistently within a show. For these shows, "TBA" may never be used as name.

For talk shows, a list of guests which appeared in the episode may be put in the name.

For sports or documentaries, a very brief unique identifier of the episode may be used. For example, the names of the teams competing in a sports match, or the name of a person or location that's the subject of this episode.

For award shows or other events, the official title of the event should be used. For example, "The 87th Academy Awards".

In all other scenarios, the fallback is to name the episode "Episode X", where X is the episode number for that episode. In case of a foreign (non-English) show, the local translation of "episode" may be used. In no case should the season number be included in the episode name.

Airdate

The date this episode premiered (was first made available). The airdate may be left empty, to indicate that the episode never premiered or the date is not known yet.

Airdates normally always follow the world premiere. If a show premieres in Japan and airs in the United States later on, the Japanese airdates must be used. If a show premieres on a Web Channel like Netflix and is aired on a TV Network later on, the Netflix premiere dates must be used. However, some exceptions apply as noted below.

Only sources available to the general public are considered for premiere dates. This means premieres on a film festival or screeners sent to critics don't count.

Season consistency

The source (a specific Network or a specific Web Channel) of episode airdates must be consistent within a season. If episodes within a season premiere on multiple sources, the source with the most amount of premieres wins. The airdates for all episodes in the season must follow the winning source, or the airdate must be left empty if the episode never premiered on that source.

For example, a show airs 10 episodes on FOX after which it's cancelled. A few months later, the final 3 episodes air on a foreign network. In this case, the airdate for those final 3 episodes must be left empty. Or; a show's pilot premieres on a Web Channel after which the rest of the season premieres on a Network. In that case, the Network's airdates must be used for all of the episodes.

In cases where premieres within a season are almost evenly split over different sources (Mythbusters would be a notorious example of this), a ruling must be made specifically for that show. Please consult the show's edit wiki when it exists, or open a thread in the Data forums otherwise.

Airdate owner

A show's owner is the entity that commissioned the show. Usually, this is the same entity that airs the show's world premieres: a show commissioned by NBC will premiere on NBC. But occasionally, episodes have their world premiere on an outlet that's completely unrelated to the show's owner.

If a show has a single unambiguous owner throughout its lifetime, the episode airdates should be set to the premiere dates on the owner's TV Network or Web Channel as described above. However, if a show's owner is ambiguous - because it's co-produced by multiple entities - or if the ownership changes throughout its lifetime, the world premiere dates must be used. For example:

Use owner's premiere dates:

Use world premiere dates:

Airtime

The exact time at which the episode premiered. In 24-hour format; which means 10:00 for 10AM, 20:00 for 8PM, or 00:00 for midnight. The time should be in the local timezone where the episode premiered. If the show's network exists in multiple timezones, the earliest timezone should be used; for example in the United States this is Eastern time. If there is no exact conclusive time for the episode's premiere, it should be left empty.

Episodes that premiere on a Web Channel can have their airtime set when the Web Channel only operates in a single country. For Web Channels that operate in multiple countries (such as Netflix), the airtime cannot be stored.

Special care should be taken when episodes air after midnight. To ensure that the episode airdates on TVmaze are in line with the dates used by TV guides and listings worldwide, episodes that start airing after midnight but before 5:00 are considered part of the previous day. For example, if an episode airs after midnight between Monday the 1st and Tuesday the 2nd, the airdate should be set to the 1st; even though technically the proper date would be the 2nd. (API users should take note that the property "airdate" uses the date as described here; while "airstamp" uses the technically correct date). This only applies to broadcast TV shows or Web Channels that operate in a single country; global Web Channel shows should have their airdate set to the exact date that's announced for them.

Runtime

The runtime of the episode's timeslot, in minutes. This means that if the episode premiered on a network with commercial breaks, the entire timeslot length should be used without deducting time for the commercials. In most cases this will be either 30 or 60 minutes.

Summary

A brief description of the episode. It should be concise, and generally not exceed the length of one paragraph. It's explicitly not a subsitute for actually watching the episode. The episode summary should be free of major spoilers. The summary should not contain duplicate information that's already available elsewhere on the episode page. For example, a list of actors guest starring in the episode should be withheld from the summary and added as Guest Cast entries instead.

A summary should always be in English, regardless of the Show's language.

The summary may be from an official source - like a network's press release -, may be hand-written or may be a combination of the two. Neither form is preferred over the other; replacing an official summary with a hand-written one is welcome if the hand-written one is of a higher quality, but doing so is not a goal in itself. If the summary was fully copied from an official source, it should be marked as such by checking the proper checkbox.