Data Fields – Edit

An EIDR Edit ID identifies a unique version of a work: generally, a creative cut of an Abstraction such as the original domestic theatrical release version, a director’s cut, a broadcast television version, a colorized version of an originally black-and-white work, etc. Translating the linguistic elements of a work without changing their essential meaning (aka, “subs and dubs”) is considered a technical, rather than creative, change and so is represented by an EIDR Manifestation rather than an Edit. See Best Practices and Use Cases for EIDR Edits for more information.

Of the Base Object Data fields, StructuralType, Release Date, and Approximate Length must be specified for all Edits and cannot be inherited.

If there are language changes in the Edit, they are recorded as Version Languages in the Base Object Data.[1]

The Extra Object Metadata for an Edit is contained within EditInfo:

Field NameTypeCardinalityExplanatory Notes
ParentEIDR Content ID: e.g., 10.5240/95F1-4D95-6A6B-E859-9410-F   <xs:element name=”Parent” type=”eidr:assetDOIType”/>1 RequiredThe EIDR Content ID of the parent Abstraction record, Edit, or Clip.
EditUseEnumeration: Theatrical, Home Video, Broadcast, Hospitality, Web, Preservation Master, Unknown, General   <xs:element name=”EditUse” type=”eidr:editUseType”/>1 RequiredThe original, primary, intended use of the Edit. In many cases, the actual uses will be different, such as the Apple iTunes Store distributing a Theatrical cut.   See “EditUse details” below.
EditClassEnumeration: Original, Unrated, Censored, Sanitized, Sanitized Audio, Sanitized Picture, Extended, Shortened, Director’s Cut, Colorized, Restored, Restored Audio, Restored Picture, Anniversary, Rereleased, Creative, Technical, Alternate Ending, Recap, Product Placement, Dialog, Music, Sound Effects, Credits, Dubbing Credits, Logos, Overture, Intermission, Exit, Content Break, Interactive Platform, Promotional, Regionalized, Split, Substitutions, Syndication, Textless, Three-D, Other   <xs:element maxOccurs=”8″ minOccurs=”0″ name=”EditClass” type=”eidr:editClassType”/>0-8 OptionalThe nature of the changes in an Edit that differentiate it from other versions.   See “EditClass details” below.
MadeForRegionEnumeration: ISO 3166-1 alpha-2, two-character country code, DOI four-character obsolete country code, UN M49 region code, plus “Domestic” and “International”: e.g., CN   <xs:element maxOccurs=”8″ minOccurs=”0″ name=”MadeForRegion” type=”eidr:madeForRegionType”/>0-8 OptionalThe distribution territory(ies) for which the Edit was originally made. (This does not imply anything about where the Edit is actually distributed.)   NOTE: Domestic and International are interpreted in relation to the Edit’s Country of Origin in the Base Object Data.   See Using EIDR Region Codes.
EditDetailsUnicode 128 character string: e.g., US broadcast free-to-air version.   <xs:element maxOccurs=”8″ minOccurs=”0″ name=”EditDetails” type=”eidr:usageDetailsType”/>0-8 OptionalA terse, keyword-type summation of factors that differentiate this Edit from other, similar Edits.
 @domainA text string with no whitespace characters, following the general pattern of a dot-separated list of sub-domains ending in a top-level domain followed by an optional slash-separated list of ID types: e.g.: <xs:attribute name=”domain” type=”eidr:constrainedURIType” use=”required”/>1 RequiredIdentifies the organization that added the Edit Details to the record. NOTE: A single Edit record can have Edit Details provided by more than one organization or multiple Edit Details provided by the same organization, so long as the Domains are unique.
ColorTypeEnumeration:  color, bandw, colorized, composite   <xs:element name=”ColorType” type=”md:ColorType-type”/>1 RequiredType of color in the visual portion of the content.   See “ColorType Details” below.
ThreeDBoolean: e.g., true <xs:element name=”ThreeD” type=”xs:boolean”/>  1 RequiredSet to true if this version is 3D. This should be true even if only part of the Edit is actually 3D (and the rest is 2D).

Here is sample XML for the Extra Object Metadata for an Edit (the preceding Base Object Data is not shown):


EditUse details

ValueExplanatory Note
TheatricalFor theatrical exhibition, including general release and festival versions.
BroadcastFor traditional multipoint television delivery (over-the-air, satellite, cable, free TV, pay TV), excluding Web.
Home VideoFor packaged media presentation in-home or on personal media devices, excluding Broadcast and Web.[2]
HospitalityEdits created for the hospitality and traditional non-Theatrical market (airlines, oil rigs, military bases, church basements, etc.).
WebEdits created for all forms of digital delivery (free streaming, VOD, EST, OTT, etc.), excluding Theatrical and Broadcast.[3]
Preservation MasterVersions (primarily of broadcast works) that include all materials recorded for that program (often including materials that do not appear in the Original version).
GeneralFor versions that are intended for multiple forms of presentation, including combinations of the above.
UnknownWhen the registrant is not the creator of the Edit and the original purpose for which the Edit was created is not known. For example, when a retailer creates an Edit using internally-sourced metadata.

EditClass details

ValueExplanatory Note
OriginalThe original release version of a work.
UnratedAn un-cut version; one that has not received content advisory or censorship classification.
Alternate EndingA version with an ending that differs from a reference version. (May also be used to describe an Edit that only includes the alternate ending scenes.)
AnniversaryAn anniversary edition. (Often used with Restored.)
CensoredA version edited for content to comply with local content advisory or censorship requirements.
ColorizedA color version produced from a black-and-white original.
Content BreakA version where the primary program has been modified to accommodate new or different content breaks, such as commercials, pledge breaks, etc. NOTE: If a program is simply interrupted by hard cuts to insert unrelated material (commercials, etc.), that is captured as a Manifestation. This Edit Class only applies when the program itself has been modified – shortened, with video and audio fade out/fade surrounding the break, etc. The break itself and changes to the inserted material do not warrant a new Edit.
CreativeA version produced for creative reasons not otherwise specified.
CreditsNew or modified main title or end credits, excluding subtitle translations that appear onscreen with the original credits.
DialogA change in dialogue more significant than Sanitized Audio, excluding translation.
Director’s CutA version that more closely represents the director’s original vision than an earlier reference version. (Usually, both Extended and Unrated.)
Dubbing CreditsAdditional credits added for the dubbing actors, translators, etc.
ExitA version that includes exit music (and optional images) that follows the presentation of the work itself and its closing credits. (May also be used to describe a particularly short Edit that only includes the Exit.)
ExtendedAdditional materials added to the work that make this version longer than a reference version.
Interactive PlatformPlatform-specific content changes to an Interactive work. For example, if the iPad version of an interactive map application contains different content from the Blu-ray or mobile (iPhone/Android) versions of that same interactive map application. NOTE: Use the Edit Details field to identify the specific interactive platforms that apply to each version.
IntermissionA version that includes intermission music (and optional images) typically presented during a break in a particularly long presentation. (May also be used to describe a particularly short Edit that only includes the Intermission.)
LogosA change to the presentation of distributor or producer logos (cards or bumpers) at the head of a work.
MusicA change in the music, generally expressed by a new music cue sheet. (May accompany a territory-specific Edit.)
OvertureA version that includes overture music (and optional images) that precedes the presentation of the work itself and its opening credits. (May also be used to describe a particularly short Edit that only includes the Overture.)
Product PlacementAlterations made to a work for the purpose of product placement.
PromotionalA new version of an existing work created for promotional purposes. May be further clarified with additional Edit Classes such as Censored, Regionalized, etc.
RecapA significantly condensed version that provides background important to the narrative thread that continues in a sequel or subsequent episode.
RegionalizedAlterations made to localize the work, such as changing the text on signs in the background, but excluding changes made for Product Placement.
RereleasedReissued for an un-specified reason.
RestoredA version that more closely resembles the original release than other versions recently available, includes restoring missing elements, correcting physical damage, etc.
Restored AudioOnly the audio has been restored.
Restored PictureOnly the video has been restored.
SanitizedObjectionable audio and/or images have been obscured rather than removed.
Sanitized AudioOnly objectionable audio has been obscured (silenced, bleeped, replaced with alternate dialogue, etc.).
Sanitized PictureOnly objectionable images have been obscured (blurred, pixelated, covered with a black bar, etc.).
ShortenedMaterials removed for other than censorship reasons, making this version shorter than a reference version.
Sound EffectsA change in the audio, excluding music and dialogue.
SplitWhen a longer work is divided into two or more pieces for presentation in smaller time slots over multiple nights, for separate download/streaming, to fit on separate physical media, etc. NOTE: Append a “Part n” (or similar) descriptor to the end of the Edit’s Title to distinguish the split parts and indicate their viewing order.
SubstitutionsA version where different video clips or audio elements are removed or substituted without changing the basic structure or narrative flow. Typical for archival and sports clips included in documentary programs and removal or replacement of presenters. These are not creative-driven changes but are motivated by external factors, such as licensing or other contractual requirements.
SyndicationA version produced expressly for television syndication. May also occur with Shortened, Sanitized, Censored, etc.
TextlessA version with no on-screen text, captions, credits, etc. Often prepared for international re-mastering.
Three-DAll or part of the version is presented in stereoscopic 3D.
OtherA version not otherwise described. Include a clarifying description in the Edit Details field.

ColorType Details

ValueExplanatory Note
colorA work that is presented entirely in color (includes full color, 2-strip color, hand-tinting, etc. – does not include sepia tone).
bandwA work that is presented entirely in monochrome (includes true black-and-white and sepia tone).
colorizedAn originally monochrome work that has been post-processed to appear in color.
compositeA work that mixes color modes, such as The Wizard of Oz (1939), Sin City (2005), and The Phantom of the Opera (1925).

[1] Such language changes do not motivate the creation of an Edit record – language changes on their own are recorded as Manifestations – rather, these language changes accompany other changes to the work that do warrant an Edit.

[2] Note that Broadcast excludes original programming for direct Internet delivery.

[3] This means that the original release of the Orange is the New Black (2013 —) is a Web Edit Use.

Updated on April 10, 2021

Was this article helpful?

Related Articles