Skip to main content
Sign in

List of Supported Codes (schema 3.0)

Valérie Pointet
  • Updated

The article outlines the lists of supported codes in the ISAN bulk excel form (isan3.0) and the ISAN API for the following data fields:

For further information on using these values, please refer to Instructions to bulk load excel form (isan3.0) and ISAN API Guide.

For further information on the ISAN schema, please refer to Records, relations and hierarchies in the ISAN Registry

Record Kind codes

Code Details
series The record is a Series.
group The record is a Group (e.g. a season of a series).
episode The record is an Episode of a series.
single The record is a Single work.
variant The record is a Variant version of a work or of a versions.
manifestation The record is a Manifestation version of a work or of a versions.
related_item The record is a Related Item version a work or of a versions.
related_content The record is a Related Content version a work or of a versions.

 

Title Kind codes

Code Details
original Original title.
alternate Alternate title.
working Working title, used for projects (works in development).
transliterated Roman transliteration of titles (mainly from Asian languages, Russian, Arabic, Hebrew…).
descriptive Descriptive name of a version (variant, manifestation, related content, related item).

 

Episode Number Format

Code Details   
concatenation The Episode number is a concatenation of the season number and the Episode number (ex1: 101, 102, 103,…. | ex2: 0101, 0201, 0301, …).
custom Custom episode number formatting.
house_number House number for the work
incremental The Episode number is an incremental number (ex1: 1, 2, 3, … | ex2: pilot, 1, 2,3,…).
production_id The Episode number value is the production ID.
sequence sequence number independently of a season number  (e.g. 123, 124 , 125...)
other Other unlisted schemes.

 

Record Property codes

Property codes are specific to record kinds: see properties for 1 - Group; 2 - Variants ; 3 - Manifestations

1 - Record Property codes for Groups

Only one property per group.

Code Details
season the group is a Season of the series: the original season grouping by the production.
group Original grouping  of episodes except for seasons grouping that have their own group property
alternate_grouping the group is an alternate grouping of episodes  (e.g. reshuffling of episodes within seasons or original groups, etc...).
alternate_edit  the group regroups episodes from an alternate editing of the series (e.g. 10 x 30min episodes versus 5 x 60min episodes).
compilation the group contains compilation of episodes of the series (e.g. in a series of 15 episodes: 3 compilations of 5 episodes, fixed on 3 Blu-ray disks).
thematic  
specials  
segments  
package package of segments
bundle a boundle of episodes
other other unlisted grouping of episodes.

 

2 - Record Property codes for Variants

One or more property per variant.

Code Details
2D the variant is a 2D version.
3D the variant is a 3D version.
alternate the variant is an alternate version of the parent.
anniversary the variant is an anniversary version of the parent.
audio_change the variant is an alternate audio version of the parent.
black_and_white the variant is a black and white version of the parent.
censored the variant is a censored version of the parent.
color the variant is a color version of the parent.
colorized the variant is a colorized version of the parent.
creative the variant is a creative version of the parent.
credit the variant is a credit change version of the parent.
derivative the variant is a derivative version of the parent.
alt_dialog the variant is an alternate dialogue version of the parent (dialogue change).
directors_cut the variant is a director's cut version of the parent.
edit the variant is an edit version of the parent.
extended the variant is an extended version of the parent.
extract the variant is an extract version of the parent.
logos the variant is a logo version of the parent.
long the variant is a long version of the parent.
alt_music the variant is an alternate music version of the parent (music change).
original the variant is an original version of the parent.
product_placement the variant is a product placement version of the parent.
rated the variant is a rated version of the parent.
recap the variant is a recap version of the parent.
remastered the variant is a remastered version of the parent.
replacement the variant is a replacement version of the parent.
re_release the variant is a re-release version of the parent.
short the variant is a short version of the parent.
sound the variant is a sound version of the parent.
special_edition the variant is a special edition version of the parent.
technical the variant is a technical version of the parent.
uncut the variant is an uncut version of the parent.
unrated the variant is an unrated version of the parent.
karaoke the variant is a karaoke version of the parent.
sanitized  the variant is a sanitized version of the parent.
restored the variant is a restored version of the parent. - FUTURE VERSION OF THE FORM ONLY...
resized the variant is a resized version of the parent. - FUTURE VERSION OF THE FORM ONLY...

 

3 - Record Property codes for Manifestations

One or more property per manifestation.

Code Details
media_fixation the manifestation identifies the fixation of the content on a media.
digital_package the manifestation identifies a digital package.
closed_captions the manifestation identifies content with closed cations.
dubbing the manifestation identifies content with dubbing.
language the manifestation identifies content with languages properties.
audio_description the manifestation identifies content with audio description.
sign_language the manifestation identifies content with sign language.
silent the manifestation identifies silent content.
subtitle the manifestation identifies content with subtitles.

 

Work Type (Series, Groups, Episodes, Single)

The Work Type entity applies to Series, Groups, Episodes, Single and Related Content and Items. The generic term "Work" is usually replaced by a more specific term:

1 - Series Type, Group Type, Work Type (Episode, Single) codes

Code Details
advertising Advertising – Commercials, advertising films:

Works which promotes a product, service, idea, person or company, including promotional material for consumer products, services shown in theaters, infomercials or on digital signage.
Note: Trailers and teasers are NOT included in this category and should be identified as Related Content of the work that is promoted.
compilation Compilation of finished works:

1 - A single featured work packaged with several related works (e.g. the traditional DVD with bonus features)- each work in the compilation would have its own Work record.
2 - A Boxed Set made of two or more featured works in a single package- South Park Season One, Indiana Jones Trilogy, etc... - each work in the Boxed Set Should have its own Work Record.
documentary A moving image production providing a factual archive or report depicting persons, animals, vegetables and plants, events or industrial processes.
educational

Works restricted to traditional training, coursework, classroom or distance learning. Such works are primarily intended to educate rather than entertain.
feature_film

Work, usually originally released theatrically
game

Game composed of a computer-controlled virtual universe that players may interact with in order to achieve a goal.
live_event

All non fiction works recording live events except related to sport or performances which have their own types. Examples include extensive coverage of political conventions, talk shows, live recordings of political debates, elections, space coverage, marriage, funerals, etc...
multimedia

Audiovisual work with interactivity.
news

An audio visual production which reports on topics of current interest.
Non fiction programming, reporting and commentary on current events, usually organized into reports from various correspondents.
performance

Works documenting a performance including concerts, dance, music, opera, stage production, recitation, magic, circus, stand-up comedy, burlesque, vaudeville or other variety stage act. Performance is a subset of live event (LV).
short

Fiction work, usually originally released theatrically or direct to video, with an original length less than feature film. This includes short animated works.
sport

Non fiction productions reporting on sporting events. Sport is a subset of live event (LV).
telefilm

A work intended for television broadcast.
tv_entertainment Other TV entertainment programs not covered by a dedicated ISAN Work Type. Programming intended for airing on television including reality programs, magazines, variety, game shows, except where otherwise categorized.
serial A set of fiction works often with the same main actors or on related subjects and open-ended television drama or comedy where the story continues from episode to episode.
video_clip Music video clip. Short audiovisual non live production which shows images related to a specific sound recording.

 

2 - Content Type codes (Related Content)

Code        Details
bonus bonus content related to the parent work or version
behind_the_scene behind the scene content related to the parent work or version
clip a clip of the parent work or version
compilation a compilation of content related to the parent work or version
cut_off_scene a cut off scene of the parent work or version
footage  
featurette promotional content made of interviews that is neither a trailer, nor a a teaser.
game a game related to the parent work or version
interview an interview related to the parent work or version
interactive interactive content related to the parent work or version
making_of making of content related to the parent work or version
mashup mashup content related to the parent work or version
multimedia multimedia content related to the parent work or version
policy_trailer  
promotional promotional content related to the parent work or version
scene a scene related to the parent work or version
specials specials content related to the parent work or version
supplemental supplemental content to the parent work or version
teaser teaser of the parent work or version
trailer trailer of the parent work or version
webisode webisode of the parent work or version
website website related to the parent work or version
other other content related to the parent work or version

 

3 - Item Type codes (Related Item)

Code        Details
audio_description the item is an audio description ressource related to the parent work or version.
audio_track the item is an audio track related to the parent work or version.
closed_captions the item is a closed captions ressource related to the parent work or version.
distribution_bundle the item is a distribution bundle related to the parent work or version.
dubbing the item is a dubbing ressource related to the parent work or version.
poster the item is a poster related to the parent work or version.
ring_tone the item is a ring tone related to the parent work or version.
sound_track the related item is a sound track related to the parent work or version.
subtitles the related item is a subtitle ressource related to the parent work or version.
other other unlisted related item type related to the parent work or version.
dialogues  
sound_effects  
audio_footage  
sidecar sidecar resource, such as metadata file, etc…
file  

 

Work Kind

Code Detail
live Live Action shooting
animated Animated images
mixed mix of Live Action and Animation

 

Color Kind codes

Code Details
black_and_white Black & white images.
color Color images.
colorized Colorized images.
mixed Mix of black & white and color images.
tinted Tinted images.
grayscale Grayscale images.
monochrome Monochrome images
sepia Sepia images.
bw_with_color_parts Black & white images with some color parts.
color_with_bw_parts Color images with some black & white images.
rgb RGB color space.
cmy CMY color space.
ycbcr YCBCR color space.
yuv YUV color space.
srgb SRGB color space.
palette Palette color space.
601_colorimetry color space defined by BT.601 (Rec. 601) for Standard Definition television.
709_olorimetry color space defined by BT.709 (Rec. 709) for Hight Definition television.
other Other unlisted color spaces.

 

Company Kind

Code Detail
production the named company is a production company.
distribution the named company is a distribution company.
broadcasting the named company is a broadcasting company.
post_production the named company is a post production company.

 

Participant Role

Label Description
actor The person who is is acting in films, or on television.
adaptation The person responsible for modifying an existing work in order to make it fit for a new use.
anchor The person who acts as the central moderator of the programme, responsible for following the programme script towards the audience. 
game_artist The person who creates 2D and 3D art for the visual elements of a video game, such as characters, vehicles, props, scenery, background, objects …
author The person in charge of working out details of the story-line, including talents roles and scenes descriptions. 
camera Person in charge of the operation of a camera and responsible for the device's output during a production. 
candidate A person who applied to take part of an entertainment programme  (Game show, contest,…)
casting A person responsible for selecting talent (actors, singers, dancers, etc.) for a production. 
char_designer A person that uses descriptions from the director to create the look of individual characters. 
character A person in the narrative of the audiovisual work
choreographer A person who is responsible for composition and arrangement of dance for a musical or dramatic.
coach A teacher who trains candidates in entertainment programmes (e.g. song contest) or performers in film or television productions.
conductor A person who conducts a musical work by directing a performing group such as orchestra, chorus, opera, etc. 
composer A person responsible for composing the music used in the audiovisual work. 
contributor A person that took part to the audiovisual work.
commentator A person who provides interpretation, analysis, or a discussion of the subject matter on an audiovisual work. 
creator A person who developed a significant part of the format, story, or play of an audiovisual work (e.g. the creator of a series)
editor A Person responsible for deciding which stories to include and which to leave out.
developper Game developer: A software developer specialized in video game development.
director A person in charge of the shooting of a work and the direction of actors/performers and the technical crew.
exec_producer Executive producer: The person primarily in charge of the financial aspects of a production and who may also make major creative decisions. Typically an executive producer handles business and legal issues.
game_designer A person that conceptualizes game plots and storylines, levels and environments, character interactions, and other creative aspects.
game_director A person behind the creative aspects of a video game, similar to a film director 
guest A person invited to take part in a television program, sports event, or other audiovisual entertainment.
presenter Presenter or host: a person who introduces a show, links items, interviews guests, etc
judge 1. a person within a panel of talents or recognised professionals who rates and/or eliminates participants in completions shows.
2. a real court judge (in activity or retired) that participates in its quality as judge in an audiovisual work. 
lead_programmer Lead game programmer: a person that make sure the various submodules of the game are being implemented properly and to keep track of development from a programming standpoint
stage_director A person who supervises the actors and directs the action in the production of a stage show.
music_by The author of the music in an audiovisual work.
narrator A person who delivers a commentary accompanying a film, broadcast, piece of music, etc.
participant A person who occasionally performs in a non-fiction programme with an active role.
performer A person who entertains people by acting, singing, dancing, or playing music.
post_prod_editor Post production editor: a person that help determine the look, sound and feel of the finished programme.
producer A person who is responsible for the making of an audio-visual work, including business aspects, management of the productions, and the commercial success of the work. 
scriptwriter A person who writes a script for a play, film, or broadcast.
screenwriter A person who writes a screenplay.
tv_director_assistant A person who assist the TV director
tv_director A person in charge of the shooting of a tv program.
voice A person who narrates in a film or broadcast, not accompanied by an image of the speaker.

 

Distribution (Intention) for Variant & Media Manifestations

Code  Detail
airline  
archive  
boats  
broadcasting  
catchup  
digital_signage  
e_sell_through  
event  
festival  
gaming  
home_video  
hosting  
hotel  
imax  
mobile  
no_distribution  
rental  
screening  
theatrical  
vod  
web  
airline  
archive  
boats  
broadcasting  
catchup  
digital_signage  
e_sell_through  
event  
festival  
gaming  
home_video  
hosting  
hotel  
imax  
mobile  
no_distribution  
rental  
screening  
theatrical  
vod  
web  
airline  
archive  
boats  
broadcasting  
catchup  
digital_signage  
e_sell_through  
event  
festival  
gaming  
home_video  
hosting  
hotel  
imax  
mobile  
no_distribution  
rental  
screening  
theatrical  
vod  
web  
other  

 

Media Kind for Media Manifestations

Code Detail
delivery_package  
distribution_master  
dcdm Digital Cinema Distribution Master (DCDM) :A master version of the source essence of a Digital Cinema work. DCDM Picture essence is uncompressed Tagged Image File Format (TIFF). DCDM Sound essence is WAV.
dsm Digital Source Master (DSM):  picture and data created by the post production, refers to en entiere class of data formats (.dpx, wave, .xml, .stl)
file  
film_print  
imf Distribution master delivered in the Interoperable Master Format (IMF)
mezzanine  
optical_disk  
tape  
stream  
unspecified  
other  

 

Media Format 

Code                    Detail
as11  
as11_x1_uhd  
betamax  
blu_ray  
cbhd China Blue High-Definition 
dcp Digital Cinema Package (DCP)
dpx DPX
dvd  
encoding encoded /compressed data (lossless, lossy, chroma subsampleng…)
hd_dvd  
imax  
imf_app_1 IMF application #1 : MXF, uncompressed, ACES
imf_app_2 IMF Application #2 - Studio Profile: MXF, JPEG2000, Broadcast HD
imf_app_2e IMF Application #2e - Studio Profile: MXF, JPEG2000, IMF Profiles, UHD/4K HDR
imf_app_3 IMF Application #3 : MXF, MPEG4 SSIP, Broadcast HD
imf_app_4 IMF Application #4 : MXF, JPEG2000, Film up to 8K
imf_app_5 IMF Application #5   (ACES image encoding)
jpeg2000  
map MAP
master_format Distribution master deliverd in an unspecified format
mpeg4  
mxf Material Exchange Format
proprietary  
prores  
uncompressed raw images and/or sound (tiff, wave, DPX, DNG ...)
vhs  
stl  
tiff  
wave  
xml  
unspecified  
16mm  
35mm  
70mm  
other  

 

Container

Code Detail
asf ASF
avchd AVCHD
avi AVI
divx DIVX
dv DV
flv FLV
hct HCT
mjpeg MJPEG
mj2 MJ2
mkv MKV
mov MOV
mpeg MPEG
mpg MPG
mp4 MP4
m4v M4V
mxf MXF
ogg OGG
quicktime Quicktime
raw RAW
real Real
riff RIFF
vob VOB
wmv WMV
3gp 3GP
3gp2 3GP2
other  



Image Definition

Code Detail
1440p HD (1440p)
1080ip HD (1080i/p)
720p HD (720p)
hd unspecified HD format
sd SD
ld LD
uhd unspecified UHD format
2160p UHD (2160p)
4320p UHD (4320p)
2k 2K
4k 4K
8k 8K
other  

 

Aspect Ratio

Code Detail
academy (1.37:1) 16 mm standard ratio
flat (1.85:1) Digital Cinema (pixel array size 1998x1080 = 2K , 3996x2160 = 4K)  / Theatrical US (1.85:1) 35 mm US and UK widescreen standard for theatrical film 
full_container (1:90:1) Digital cinema full container (pixel array size 2048x1080 = 2K , 4096x2160 = 4K)
scope (2.39:1) Digital Cinema (pixel array size 2048x858 = 2K , 4096x1716 = 4K) / 35 mm anamorphic from 1970 onwards
square (1:1) Square
4_3 (4:3 or 1.3:1) 35 mm original silent film ratio and standard ratio for MPEG-2 video compression
14_9 (14:9) Widescreen aspect ratio sometimes used in shooting commercials etc. as a compromise format between 4:3 and 16:9
16_9 (16:9 or 1.7:1) Video widescreen standard, used in high-definition television, one of three ratios specified for MPEG-2 video compression
1.375_1 (1.375:1) Academy (1.375:1 ). 35 mm full-screen sound film image, nearly universal in movies between 1932 and 1953. Officially adopted as the Academy ratio in 1932 by AMPAS. Rarely used in theatrical context nowadays, but occasionally used for other contex
2_1 (2:1) Univisium
2.2_1 (2.2:1) 70 mm standard
2.35_1 (2.35:1) 35 mm anamorphic prior to 1970
2.40_1 (2.40:1) Blu-ray Disc film releases (1920×800 resolution)
2.59_1 (2.59:1)Cinerama at full height (three specially captured 35 mm images projected side-by-side into one composite widescreen image)
1.44_1 (1.44:1) IMAX
1.66_1 (1.66:1) Theatrical EU (1.66:1)
other  

 

Linked ISAN Type

Code        Detail
part

the linked ISAN identifies a part of a larger work splitted in parts. Exemple: a series episode is split in two parts:

Reese Joins The Army (part 1 Of 2) [ISAN 0000-0001-8A1B-0088-2-0000-0000-V] and Reese Joins The Army (part 2 Of 2) [ISAN 0000-0001-8A1B-0091-C-0000-0000-1]
sequel The work and the linked ISAN are sequels. A sequel is a work that continues the 'story' of, or expands upon, some earlier work. Sequels can be of any type (feature film, documentary, telefilm, ...) and may have unrelated titles. Warning, sequels are different from episodes of series.
composite The linked ISAN identifies a component embedded in the work
pilot  pilot episode (series) or short (feathure film)
alternate_adaptation same story but in an alternate adaptation as different works
alternate_edit alternate edit of the work resulting in a new work (not a version), such as the telefilm counterpart of a feature film.
audio_resource  
bundle  
based_on the work is based on the linked ISAN
closed_captions  
compilation  
composition A complete exhibitable work such as a feature or a trailer or a test signal. A composition is packaged as a composition playlist file and a set of track files.
franchise A film series or movie series (also referred to as a film franchise or movie franchise) is a collection of related films in succession that share the same fictional universe, or are marketed as a series
miniserie the work is part of a miniseries
package  
promotional  
reboot a new start to an established fictional universe, work, or series
related related work, content or item as for ex: des films en marge de la série (mangas)
remake https://en.wikipedia.org/wiki/Remake
revival television series that returns to produce new episodes after being off the air for a certain amount of time, particularly due to cancellation
segment

A content that can have its own existence or be combined with other segments to form a larger content.

Example: four 5min cartoons combined into a 20min animated television program
specials  
spin_off television program, video game, film, or any narrative work, derived from already existing works that focus on more details and different aspects from the original work.
subtitles  
supplemental  
other  

 

Linked Identifiers

Linked-ID Type Linked_ID_Domain       Description
ad_id ad-id.org Advertising Digital Identification
agicoa agicoa.org Agicoa coalition identifier
cnc cnc-rca.fr RCA Identifier provided by the French CNC
vad.cnc.fr CNC ID on the VoD search platform vad.cnc.fr
cnc.fr/depotlegal CNC legal deposit identifier
crid   Content Reference Identifier
doi doi.org Digital object Identifier
eidr eidr.org Entertainment ID Registry
ean gs1us.org  
grid grid.ifpi.org Global Release Identifier
gtin gs1us.org Global Trade Item Number (including UPC = GTIN-12)
ida ida-net.org International Documentation of AV Works (http://www.ida-net.org)
imdb imdb.com Internet Movie DB (www.imdb.com)
ina inamediapro.com INA ID on inamediapro.com
isrc isrc.ifpi.org The International Standard Recording Code is the international identification system for sound recordings and music video recordings
iswc iswc.org International Standard Musical Work Code
lumiere lumiere.obs.coe.int European Audiovisual Observatory Lumière ID
private   Registrant's private Identifier. It must be unique across all the works submitted by a registrant
umid   Unique Material Identifier, is a unique identifier for locally created audiovisual material.
upc gs1us.org Universal product Code (e.g. the UPC of product such as a Blu-ray release)
uri   Uniform ressource identifier
url   Uniform Ressource Locator (e.g. the wikipedia page of the movie)
urn   Universal Ressource Name
uuid   Universal Unique Identifier
proprietary see below Proprietary identifier such as CNC, Allociné, Amazon, Netflix, …IMPORTANT: the corresponding Alt-Id Domain must containt the domaiin where the ID can be resolved and by default the domain name of the stakeholder (e.g.: Alt-Id Domain = netflix.com or Alt-Id Domain = procinema.ch/suisa )
proprietary allcinema.net Allcinema
proprietary allmovie.com  
proprietary allocine.fr/movie allocine Movie ID
proprietary allocine.fr/season allocine season ID
proprietary allocine.fr/episode allocine Episode ID
proprietary amazon.com amazon identifier
proprietary apple.com Apple ID
proprietary archiviodelcinemaitaliano.it ANICA ID
proprietary bfi.org.uk British Film Institute
proprietary bnf.fr Bibliotheque nationale de France
proprietary catalogue.bnf.fr catalogue ID of Bibliotheque Nationale de France
proprietary cbs.com CBS studio identifier
proprietary cinematheque.fr  
proprietary cineuropa.org  
proprietary dfi.dk/film Danish Film Institute
proprietary disney.com/ProductID  
proprietary film-documentaire.fr  
proprietary filmaffinity.com  
proprietary filmotv.fr  
proprietary foxipedia.com/wprid Fox Financial Title ID
proprietary foxipedia.com/vaultversionid Foxipedia Version ID
proprietary foxipedia.com/jdeversionid Fox JDE Version ID
proprietary infoicaa.mecd.es ICAA film catalogue ID
proprietary itunes.apple.com Apple iTunes ID
proprietary itv.com ITV UK broadcaster ID
proprietary lacinetek.com lacinetek.com ID
proprietary letterboxd.com Letterboxd film ID
proprietary lionsgate.com Lionsgate studio ID
proprietary microsoft.com Microsoft VoD ID
proprietary netflix.com Netflix
proprietary nfb.ca/film National Film board of Canada
proprietary paramount.com/mpm Paramount studio ID
proprietary play.google.com Google Play ID
proprietary procinema.ch/suisa Procinema SUISA ID
proprietary spe.sony.com/mpm Sony Studio MPM ID
proprietary spe.sony.com/ProductID Sony Studio Product ID
proprietary swissfilms.ch  
proprietary themoviedb.org/movie  
proprietary themoviedb.org/tv  
proprietary thetvdb.com/episode episode  ID on thetvdb.com
proprietary thetvdb.com/movie film ID on thetvdb.com
proprietary thetvdb.com/season season ID on thetvdb.com
proprietary thetvdb.com/series series ID on thetvdb.com
proprietary unifrance.org  
proprietary warnerbros.com/MPM Warner Brother MPM ID
proprietary wga.org/project Writers Guild of America project ID
proprietary wikidata.org Wikidata ID
proprietary zdf-enterprises.de ZDF German broadcaster ID
  contact cs@isan.org for adding your proprietary domains.

 

Country Kind

The country Kind qualifies always a country defined by a country code.

Code Detail
distribution Country or region where the content is distributed.
production Country of production of the work.
shooting Country of shooting of the work.

 

Language Kind

Code Details
original Original language
dubbed Dubbed language
subtitles Subtitles language
closed_caption Closed captions language
audio_description Audio description language
sign_language Sign language language
text Language of other displayed text 
spoken  

 

ISO 639-2 Language Codes

Refer to this article: List of ISO 639-2 Codes


ISO 3166 Country Codes

Refer to this article: List of ISO 3166 Country Codes

 

Related articles