Core Fields
Owner: Publisher · 77 fields
Everything that describes what the product is — series, creators, format, content details.
See the full Data Dictionary for a searchable table across all tiers.
PriceCAD
Machine name: PriceCAD · Position: 6 · Type: Decimal · Length: 8,2 · Owner: Publisher · Required: No
The PriceCAD field includes the suggested retail price in Canadian dollars. Note that this field will not include a dollar sign ($).
Example: 9.99
PriceUK
Machine name: PriceUK · Position: 7 · Type: Decimal · Length: 8,2 · Owner: Publisher · Required: No
The PriceUK field includes the suggested retail price in British Pound Sterling. Note that this field will not include a currency symbol.
Example: 5.99
SeriesName
Machine name: SeriesName · Position: 10 · Type: Text · Length: 256 · Owner: Publisher · Required: Required for comics and graphic novels
The SeriesName field is the main title of the item.
Example: Something is Killing the Children
Notes: SeriesName must be included on one-shots, multi-issue series, and TPB/HC/Collected Editions
SeriesNumber
Machine name: SeriesNumber · Position: 11 · Type: Number · Length: 12 · Owner: Publisher · Required: Required for comics
The SeriesNumber field displays the issue or volume number of the item, if it is part of a numbered series.
Example: 1
Notes: This filed should only hold numbers, never text. Decimal places are allowed.
SubTitle
Machine name: SubTitle · Position: 12 · Type: Text · Length: 256 · Owner: Publisher · Required: No
The Subtitle field is a secondary or explanatory title, often printed on the cover of an item.
Example: Fall of the House of Slaughter
CoverDescription
Machine name: CoverDescription · Position: 13 · Type: Text · Length: 256 · Owner: Publisher · Required: Required for variant covers
The CoverDescription field describes the cover differences between different editions. Should not contain the word "Cover".
Example: Artgerm Full Art
Notes: This is NOT for describing cover A or B, this is for describing a theme or artist.
PrimaryFormatType
Machine name: PrimaryFormatType · Position: 14 · Type: Pick List · Length: 2 · Owner: Publisher · Required: Yes
The PrimaryFormatType field contains a code that corresponds to the specific format of the item. Book, Merchandise (See FormatTypes in the data definitions). This should start from the outside of the product to the inside (a slipcase is outside of hardcovers, for example). For example, if an item is a box set of hardcovers, the FormatType should be BX.
Example: CB
Picklist: FormatType
Notes: See the FormatType table in the Data Definitions.
SecondaryFormatTypes
Machine name: SecondaryFormatTypes · Position: 15 · Type: Pick List · Length: 64 · Owner: Publisher · Required: No
SecondaryFormatTypes further defines format types. For example, Hardcover > Omnibus (See FormatTypes in the data definitions). This field is a comma-separated list of format codes.
Example: BX,LF
Picklist: FormatType
Notes: See the FormatType table in the Data Definitions.
TextNumber
Machine name: TextNumber · Position: 17 · Type: Text · Length: 64 · Owner: Publisher · Required: No
The TextNumber field (Red, Black, Omega, etc)
Example: Omega
VolumeTag
Machine name: VolumeTag · Position: 18 · Type: Pick List · Length: 16 · Owner: Publisher · Required: No
Is the collection referred to as a Book, Season, Volume or other?
Example: Volume
Picklist: VolumeType
Notes: See the VolumeType table in the Data Definitions.
Description
Machine name: Description · Position: 19 · Type: Text · Length: 150000 · Owner: Publisher · Required: Yes
The Description field displays the full description associated with the item. Note that this text will not contain any HTML formatting, and double quotes will be escaped to maintain file integrity.
Example: Erica's heartbreak in the wake of tragedy turns to rage as she faces Cutter one final time. But who else will fall at the hands of the Order, and how will things change for Cecilia and the House of Slaughter?
Notes: All text should be UTF-8 encoded Text shall not contain HTML. Do not use double quotes Remove any special characters before submission (Example: MS Word formatting). All text values should be trimmed of any leading or trailing whitespace at the input and output interfaces of any entities handling data.
OnSaleDate
Machine name: OnSaleDate · Position: 22 · Type: Date · Length: 10 · Owner: Publisher · Required: Yes
The OnSaleDate field provides the expected On Sale Date/In-Store Date for the item, expressed in YYYY-MM-DD.
Example: 45735
PublisherName
Machine name: PublisherName · Position: 24 · Type: Text · Length: 256 · Owner: Publisher · Required: Yes
The PublisherName field displays the name of the publisher or division that is publishing the item.
Example: Marvel Comics
Notes: Please be consistent. "Honesty Comics" is not the same as "HONESTY COMICS" or "Honesty."
ImprintName
Machine name: ImprintName · Position: 25 · Type: Text · Length: 256 · Owner: Publisher · Required: No
The ImprintName field displays the name of the imprint or brand that is publishing the item. Example: DC Universe versus Black Label, Skybound for Image Comics
Example: Skybound
Storyline
Machine name: Storyline · Position: 26 · Type: Text · Length: 256 · Owner: Publisher · Required: No
A group of issues that tie together into one storyline, these may cross series codes, or be contained within one series code.
Example: Fall of the House of X
SeriesFrequency
Machine name: SeriesFrequency · Position: 27 · Type: Pick List · Length: 32 · Owner: Publisher · Required: Required for comics and graphic novels
The SeriesFrequency field discloses information specific to the publication cadence or type of the item.
Example: Monthly
Picklist: SeriesFrequency
MaxIssue
Machine name: MaxIssue · Position: 28 · Type: Number · Length: 12 · Owner: Publisher · Required: No
The Max Issue information refers to the highest number (last issue) in a limited series. For example, in Umbrella Academy: Apocalypse Suite #4 (of 6), the Max Issue data [(of 6)] identifies the title as a six-issue limited series.
Example: 6
Notes: This is an extremely helpful sales tool at the register. "Do you want to subscribe? It's only 6 issues"
VariantNumber
Machine name: VariantNumber · Position: 29 · Type: Number · Length: 6 · Owner: Publisher · Required: Yes
A numerical representation of the order in which a variant was added (i.e. the fourth added variant would have the number 4), should correspond with the last 2 or 3 digits of a UPC (depending on your ICP pattern) where possible.
Example: 2
Notes: Expect retailers to convert this to a cover letter where 0 = CVR A, 1 = CVR B, etc.
VariantRatio
Machine name: VariantRatio · Position: 30 · Type: Text · Length: 6 · Owner: Publisher · Required: No
The VariantRatio field is a numeric field that denotes the ordering requirement, if any, to purchase the item. This should be expressed in the format of X:Y for a 1 in 25, we would express X = 1 and Y = 25 for a result of 1:25. If empty, we assume this product is not a ratio variant
Example: 0.0590277777777778
Notes: This was brought up as an item we should revisit, should we display this as 1:20 rather than 20?
SeriesCode
Machine name: SeriesCode · Position: 31 · Type: Number · Length: 24 · Owner: Publisher · Required: Required for comics
SeriesCode is used to denote a specific title numerically and encompasses all issues of a given title. For Comics, a series code should be unique to the first 11 digits of a UPC code (with some exceptions).
Example: 75960609661
Notes: SeriesCode must be on all periodicals (including one-shots, annuals, and multi-issue series), as well as all multi-volume collected editions in any format. SeriesCode may be on TPBs/HC/Absolute/Other formats that do not have a second volume.
SeriesType
Machine name: SeriesType · Position: 32 · Type: Pick List · Length: 32 · Owner: Publisher · Required: Required for comics
What type of a comic is this, for example a one-shot vs ongoing vs limited series?
Example: Limited Series
Picklist: SeriesType
ParentSeriesCode
Machine name: ParentSeriesCode · Position: 33 · Type: Number · Length: 24 · Owner: Publisher · Required: No
The ParentSeriesCode will indicate a series code that this is a child of (example: Annual is the child of a series code). Batman (1940) is the parent of Batman New52 (2011), which is the parent of Batman Rebirth (2016). Is only intended for the first issue of a series, or for a one-shot
Example: 76194130640
Notes: Ensure that the parent code is an item within the same format as the child item.
SeriesFamily
Machine name: SeriesFamily · Position: 34 · Type: Text · Length: 128 · Owner: Publisher · Required: No
SeriesFamily represents a family of titles (All Spider-Man, All Batman, All X-Men, All Titans)
Example: Batman
PageCount
Machine name: PageCount · Position: 35 · Type: Number · Length: 6 · Owner: Publisher · Required: Yes
The PageCount field displays the page count of the publication.
Example: 64
PrimaryContentType
Machine name: PrimaryContentType · Position: 36 · Type: Pick List · Length: 32 · Owner: Publisher · Required: Yes
PrimaryContentType defines something as primarily original content, or primarily reprinted content.
Example: Original Content
Picklist: PrimaryContentType
Notes: See PrimaryContentType table in the Data Definitions.
IssueSort
Machine name: IssueSort · Position: 37 · Type: Decimal · Length: 14,2 · Owner: Publisher · Required: No
Sorting number (which should usually be the same as the Series Number, except for when it is not. i.e. Deathmate Black, Deathmate Series, Zero Hour #4 (which was the first issue).
Example: 57.5
Notes: Decimal places are allowed.
BISAC1
Machine name: BISAC1 · Position: 38 · Type: Pick List · Length: 9 · Owner: Publisher · Required: Yes
The BISAC field denotes the first 9-character alphanumeric BISAC code associated with the item. The Book Industry Standards and Communications (BISAC) Subject Heading list is an industry-approved list of subject descriptors, intended to help retailers and data providers standardize genre and subject classification. (NOTE: You may use any BISAC categories available from the BISG)
Example: CGN004030
Picklist: BISACCode
BISAC1Description
Machine name: BISAC1Description · Position: 39 · Type: Pick List · Length: 128 · Owner: Publisher · Required: Yes
The BISAC Description field provides the descriptive translation of the corresponding BISAC1 subject code.
Example: COMICS & GRAPHIC NOVELS / Fantasy
Picklist: controlled vocabulary not yet published
BISAC2
Machine name: BISAC2 · Position: 40 · Type: Pick List · Length: 9 · Owner: Publisher · Required: No
The BISAC field denotes the first 9-character alphanumeric BISAC code associated with the item. The Book Industry Standards and Communications (BISAC) Subject Heading list is an industry-approved list of subject descriptors, intended to help retailers and data providers standardize genre and subject classification.
Example: CGN004010
Picklist: BISACCode
BISAC2Description
Machine name: BISAC2Description · Position: 41 · Type: Pick List · Length: 128 · Owner: Publisher · Required: No
The BISAC Description field provides the descriptive translation of the corresponding BISAC1 subject code.
Example: COMICS & GRAPHIC NOVELS / Crime & Mystery
Picklist: controlled vocabulary not yet published
BISAC3
Machine name: BISAC3 · Position: 42 · Type: Pick List · Length: 9 · Owner: Publisher · Required: No
The BISAC field denotes the first 9-character alphanumeric BISAC code associated with the item. The Book Industry Standards and Communications (BISAC) Subject Heading list is an industry-approved list of subject descriptors, intended to help retailers and data providers standardize genre and subject classification.
Example: CGN004070
Picklist: BISACCode
BISAC3Description
Machine name: BISAC3Description · Position: 43 · Type: Pick List · Length: 128 · Owner: Publisher · Required: No
The BISAC Description field provides the descriptive translation of the corresponding BISAC1 subject code.
Example: COMICS & GRAPHIC NOVELS / Science Fiction
Picklist: controlled vocabulary not yet published
Language
Machine name: Language · Position: 44 · Type: Pick List · Length: 3 · Owner: Publisher · Required: Yes
The Language field provides a 3-character code that provides information about the language of the item. See Language Codes
Example: eng
Picklist: LanguageCode
Notes: See the LanguageCodes table in the Data Definitions.
AgeRange
Machine name: AgeRange · Position: 45 · Type: Pick List · Length: 4 · Owner: Publisher · Required: Required for kids' items
The AgeRange field is a four-character alphanumeric range of ages that apply to the target audience of the item. See AgeRange List of Values
Example: 14UP
Picklist: AgeRange
Notes: See the AgeRange table in the Data Definitions.
MediaRating
Machine name: MediaRating · Position: 46 · Type: Pick List · Length: 32 · Owner: Publisher · Required: Yes
The MediaRating field discloses the actual media rating value for the item. See MediaRating List of Values
Example: Rated T+
Picklist: MediaRating
Notes: See the MediaRating table in the Data Definitions.
Adult
Machine name: Adult · Position: 47 · Type: Y/N · Length: 1 · Owner: Publisher · Required: No
Adult (A) titles are intended for sale only to adult customers. This field identifies items which have explicit content intended for adults.
Example: Y
VariantMechanic
Machine name: VariantMechanic · Position: 48 · Type: Pick List · Length: 36 · Owner: Publisher · Required: No
If this is not an open order variant, the constraint type for ordering is described here.
Example: Ratio Variant
Picklist: controlled vocabulary not yet published
Notes: See Variant Mechanics table in Data Definitions
AlternateUPC
Machine name: AlternateUPC · Position: 49 · Type: Number · Length: 17 · Owner: Publisher · Required: No
In the case a title has more variant covers than can be accounted for with the item's base barcode, this alternate UPC code would indicate the other barcodes used to qualify for a ratioed variant.
Example: 70985301898
OrderRequirementCodes
Machine name: OrderRequirementCodes · Position: 50 · Type: Composite · Length: 2048 · Owner: Publisher · Required: No
OrderRequirementCodes is a comma separated list containing barcodes that may be used in conjunction with ExceedPercentage or ratio variants. Ratio and non-ratio variants, by default count toward these thresholds unless listed in the OrderExceptionCodes.
Example: 72513032443605151, 72513032443605161
OrderExceptionCodes
Machine name: OrderExceptionCodes · Position: 51 · Type: Composite · Length: 2048 · Owner: Publisher · Required: No
Comma separated list of barcodes outside of the default set that are to be EXCLUDED in ratio threshhold math.
Example: 76194137779700191, 76194137779700122
ExceedPercentage
Machine name: ExceedPercentage · Position: 52 · Type: Number · Length: 4 · Owner: Publisher · Required: No
X% of the item identified in the OrderRequirementCodes field.
Example: 10
Notes: In this example, you need to order 10% of the listed UPC's in order to qualify for 1 of these. So if you ordered 90 of the other UPC's, you could order 9 of this item.
EligibleCodes
Machine name: EligibleCodes · Position: 53 · Type: Composite · Length: 2048 · Owner: Publisher · Required: No
The EligibleCodes field is a numeric field of barcodes that should be used in conjunction with ExceedPercentage. Barcodes in this field will be used to determine the total quantity of all items of a specific title that must meet or exceed the quantity calculated by ExceedPercentage
Example: 75960620483001121, 75960620483001111
PublisherCode
Machine name: PublisherCode · Position: 54 · Type: Text · Length: 5 · Owner: Publisher · Required: Yes
Numerical representation of the 5 digit "Manufacturer Code" used to designate a UPC code
Example: 59606
ContentItems
Machine name: ContentItems · Position: 55 · Type: Text · Length: 512 · Owner: Publisher · Required: No
Text field that indicates what is in the collection.
Example: Collects Secret Origins #48, Swamp Thing #40, The Sandman #8, Doom Patrol #25, Warlord #48 and #55, Legion of Super-Heroes #298, Nathaniel Dusk #1, Infinity Inc. #14, The New Teen Titans #16, The Best of DC: Blue Ribbon Digest #58, Watchmen #1, Camelot 3000 #1, Batman: The Dark Knight Returns #2, Angel Love #1, and History of the DC Universe #1-2
Reprint
Machine name: Reprint · Position: 56 · Type: Y/N · Length: 1 · Owner: Publisher · Required: Required for comics
Is the item a Reprint? Facsimile editions - Image Firsts, something that has come out previously.
Example: N
Notes: A simple yes or no flag to indicate whether a periodical is a first print or not.
Printing
Machine name: Printing · Position: 57 · Type: Number · Length: 3 · Owner: Publisher · Required: Yes
What printing is the item
Example: 2
WriterISNI
Machine name: WriterISNI · Position: 58 · Type: Text · Length: 512 · Owner: Publisher · Required: No
The ISNI number for the Writer, comma separated list of all writers on the item, multiple creators should be separated by a semicolon, this field should be text.
Example: 0000 0001 2146 227X
Writer
Machine name: Writer · Position: 59 · Type: Text · Length: 512 · Owner: Publisher · Required: Yes
The Writer field identifies the primary creator responsible for authoring/writing the item. If there is more than one contributor per role, all contributors will be displayed as FIRST LAST name and separated by a semicolon.
Example: Neil Gaiman
ArtistISNI
Machine name: ArtistISNI · Position: 60 · Type: Text · Length: 512 · Owner: Publisher · Required: No
The ISNI number for the Artist, comma separated list of all artists on the item, multiple creators should be separated by a semicolon, this field should be text.
Example: 0000 0001 1691 8041
Artist
Machine name: Artist · Position: 61 · Type: Text · Length: 512 · Owner: Publisher · Required: Required for comics
The Arist field identifies the primary creator responsible for illustrating the item. If there is more than one contributor per role, all contributors will be displayed as FIRST LAST name and separated by a semicolon.
Example: Jack Kirby
CoverArtistISNI
Machine name: CoverArtistISNI · Position: 62 · Type: Text · Length: 512 · Owner: Publisher · Required: No
The ISNI number for the Cover Artist, comma separated list of all artists on the item, multiple creators should be separated by a semicolon, this field should be text.
Example: 0000 0001 0776 4052
CoverArtist
Machine name: CoverArtist · Position: 63 · Type: Text · Length: 512 · Owner: Publisher · Required: Required for comics
The CoverArtist field identifies the primary creator responsible for illustrating the cover of the item. If there is more than one contributor per role, all contributors will be displayed as FIRST LAST name and separated by a semicolon.
Example: Marie Severin
ColoristISNI
Machine name: ColoristISNI · Position: 64 · Type: Text · Length: 512 · Owner: Publisher · Required: No
The ISNI number for the Colorist (if any), comma separated list of all colorists on the item, multiple creators should be separated by a semicolon, this field should be text.
Example: 0000 0003 9593 3286
Colorist
Machine name: Colorist · Position: 65 · Type: Text · Length: 512 · Owner: Publisher · Required: No
The Colorist field identifies the primary creator responsible for coloring the item. If there is more than one contributor per role, all contributors will be displayed as FIRST LAST name and separated by a semicolon.
Example: Tatjana Wood
InkerISNI
Machine name: InkerISNI · Position: 66 · Type: Text · Length: 512 · Owner: Publisher · Required: No
The ISNI number for the Inker (if any), comma separated list of all inkers on the item, multiple creators should be separated by a semicolon, this field should be text.
Example: 0000 0003 5502 7529
Inker
Machine name: Inker · Position: 67 · Type: Text · Length: 512 · Owner: Publisher · Required: No
The Inker field identifies the primary creator responsible for inking the item. If there is more than one contributor per role, all contributors will be displayed as FIRST LAST name and separated by a semicolon.
Example: Bill Sienkiewicz
EditorISNI
Machine name: EditorISNI · Position: 68 · Type: Text · Length: 512 · Owner: Publisher · Required: No
The ISNI number for the Editor (if any), comma separated list of all editors on the item, multiple creators should be separated by a semicolon, this field should be text.
Example: 0000 0004 2851 3043
Editor
Machine name: Editor · Position: 69 · Type: Text · Length: 512 · Owner: Publisher · Required: No
The Editor field identifies the primary creator responsible for editing the item. If there is more than one contributor per role, all contributors will be displayed as FIRST LAST name and separated by a semicolon.
Example: Karen Berger
LettererISNI
Machine name: LettererISNI · Position: 70 · Type: Text · Length: 512 · Owner: Publisher · Required: No
The ISNI number for the Letterer (if any), comma separated list of all letterers on the item, multiple creators should be separated by a semicolon, this field should be text.
Example: 0000 0003 6467 1658
Letterer
Machine name: Letterer · Position: 71 · Type: Text · Length: 128 · Owner: Publisher · Required: No
The Letterer field identifies the primary creator responsible for lettering the item. If there is more than one contributor per role, all contributors will be displayed as FIRST LAST name and separated by a semicolon.
Example: Breitweiser, Elizabeth
Contributor
Machine name: Contributor · Position: 72 · Type: Text · Length: 16 · Owner: Publisher · Required: No
The Contributor field identifies the any other primary creator responsible for some other contribution to the item. If there is more than one contributor per role, all contributors will be displayed as FIRST LAST name and separated by a semicolon.
Example: Ken Albery; Erik Larsen
CartonQuantity
Machine name: CartonQuantity · Position: 73 · Type: Number · Length: 6 · Owner: Publisher · Required: No
The CartonQuantity field displays the number of individual units contained in a single carton.
Example: 12
UnitMeasurements
Machine name: UnitMeasurements · Position: 74 · Type: Text · Length: 8 · Owner: Publisher · Required: Yes
Imperial or Metric
Example: Imperial
Unit Width
Machine name: UnitWidth · Position: 75 · Type: Decimal · Length: 10,4 · Owner: Publisher · Required: Yes
The Width field displays the width of the item in inches (Imperial), or cm (Metric), rounded to the fourth decimal place.
Example: 12.3616
Unit Height
Machine name: UnitHeight · Position: 76 · Type: Decimal · Length: 10,4 · Owner: Publisher · Required: Yes
The Height field displays the height of the item in inches (Imperial), or cm (Metric), rounded to the fourth decimal place.
Example: 12.3616
Unit Depth
Machine name: UnitDepth · Position: 77 · Type: Decimal · Length: 10,4 · Owner: Publisher · Required: Yes
The depth field displays the depth of the item in inches (Imperial), or cm (Metric), rounded to the fourth decimal place.
Example: 0.8
Unit Weight
Machine name: UnitWeight · Position: 78 · Type: Decimal · Length: 10,4 · Owner: Publisher · Required: Yes
The weight field displays the weight of the item in pounds (Imperial) or grams (Metric), rounded to the fourth decimal place.
Example: 6.9991
VariantType
Machine name: VariantType · Position: 108 · Type: Text · Length: 24 · Owner: Publisher · Required: Required for comics
This indicates whether something is a primary or variant cover. Primary being the first (or main_ cover in a product. Mandatory for comics only, optional for Graphic Novels.
Example: Primary Cover
CoverColor
Machine name: CoverColor · Position: 112 · Type: Text · Owner: Publisher · Required: No
This field is a simple indicator if a cover does or does not have color.
Translator
Machine name: Translator · Position: 113 · Type: Text · Owner: Publisher · Required: No
Translator of the material.
CreatorBio
Machine name: CreatorBio · Position: 114 · Type: Text · Owner: Publisher · Required: No
Bio of Creators
Reviews
Machine name: Reviews · Position: 115 · Type: Text · Owner: Publisher · Required: No
Reviews or Pull Quotes for the item
ComparableTitles
Machine name: ComparableTitles · Position: 116 · Type: Text · Owner: Publisher · Required: No
Other "Similar" titles, as a comma separated UPC/ISBN list.
TitleFamilyID
Machine name: TitleFamilyID · Position: 122 · Type: Text · Length: 10 · Owner: Publisher · Required: No
An ID to provide a linking between all formats and variants of a given title, comic, tpb, graphic novel, hardcover, deluxe hardcover, etc.
HSCode
Machine name: HSCode · Position: 123 · Type: Decimal · Length: 4,2 · Owner: Publisher · Required: No
HS Codes are a six digit code that is an internationally recognized standard.
CountryOfOrigin
Machine name: CountryOfOrigin · Position: 124 · Type: Text · Length: 3,1 · Owner: Publisher · Required: No
4 digit code (3 digits and a suffex) that determines the country of origin. The HTS code is used in conjunction with the country of origin. Country of origin data helps determine whether a product qualifies for preferential tariff treatment under free trade agreements. Country of origin codes are maintained by the U.S. International Trade Commission (ITC).
DTCStreetDate
Machine name: DTCStreetDate · Position: 126 · Type: Date · Length: 10 · Owner: Publisher · Required: No
The date a direct to consumer publisher may offer this item on sale, expressed in YYYY-MM-DD. Example 2023-10-13