Partner feed spec

One row per product, with these column names in the first row. Every row needs the required columns; fill the others where you have them.

A feed URL, or a CSV or XLSX file up to 25 MB

ColumnRequiredFormatWhat it holdsExample
upcUPC or GTINRequiredUPC-A, EAN-13 or GTIN-14. Digits only, check digit included.The barcode on the product.284739102659
titleTitleRequiredTextThe product name, as printed on the box.Lanterns of Quillmoor
publisherPublisherRequiredTextThe company that publishes the product.Quillmoor Games
skuSKUOptionalTextYour item number.QMG-LAN-01
editionEditionOptionalTextEdition, printing or language, when the barcode is specific to one.First edition, English
release_dateRelease dateOptionalYYYY-MM-DD, or YYYY-MMThe street date.2026-11-13
case_packCase packOptionalWhole numberUnits per case.6
msrpMSRPOptionalUS dollars, e.g. 59.99Suggested retail price.59.99
image_urlImage URLOptionalhttps linkA direct link to the product image.https://images.quillmoor.example/lanterns-of-quillmoor.jpg
image_permissionImage permissionOptionalyes or noWhether we may show this row's image. A row's no overrides the form's confirmation.yes
categoryCategoryOptionalText, e.g. board game, expansion, accessoryYour category. It keeps items that are not games out of the game catalog.board game
availabilityAvailabilityOptionalin stock, backorder, preorder, out of printWhether stores can order it now.preorder

Your existing column names may already work: common names like UPC, Item Number and MSRP are recognized.

More detail, when you have it

These columns are optional extras in the same file, with these column names in the first row. They describe the game itself: its one-liner, its description, how it plays, and more photos. They show on the game’s page and in the catalog other tools read. Send any of them you have; a file without them is still complete.

ColumnRequiredFormatWhat it holdsExample
taglineTaglineOptionalTextOne short line that says what the game is. Shown under its title.Light the harbor before the tide turns.
descriptionDescriptionOptionalTextWhat the game is and how it plays, in your own words. Shown on the game’s page. Start each line with a word rather than a dash or a symbol, so a spreadsheet never reads a line as a formula.Players drift lantern boats down the canals of Quillmoor and set lanterns alight to guide the fleet home before the tide turns. A gentle game of timing and nerve for the whole table.
players_minFewest playersOptionalWhole numberThe smallest number of players the game works for.2
players_maxMost playersOptionalWhole numberThe largest number of players the game works for.5
playtime_minShortest playing timeOptionalWhole number of minutesAbout how long a short game takes, in minutes.30
playtime_maxLongest playing timeOptionalWhole number of minutesAbout how long a long game takes, in minutes.45
age_suggestedSuggested ageOptionalWhole number of yearsThe youngest age the box suggests, in years.8
designersDesignersOptionalNames, separated by semicolonsWho designed the game.A. Quill; R. Mariner
tagsTagsOptionalWords or phrases, separated by semicolonsMechanics and themes. They help players and stores find the game.family; tile laying; harbors
image_url_2Second image URLOptionalhttps linkAnother product photo, after the box shot. The image permission column covers it too.https://images.quillmoor.example/lanterns-of-quillmoor-back.jpg
image_url_3Third image URLOptionalhttps linkA third product photo. The image permission column covers it too.https://images.quillmoor.example/lanterns-of-quillmoor-cards.jpg

The box, side by side, when you have it

These optional columns describe the box itself: its size, a font and colours for a drawn spine, and an image of each side with what we may show. For each side, choose show, ours (AGDB and Gamestead only) or no. A blank choice means no: we never show an image you didn’t say yes to. Size and player count are always listed.

ColumnRequiredFormatWhat it holdsExample
box_width_mmBox width (mm)OptionalWhole number, 10 to 1000The box's width in millimetres, as it stands face out. Give all three sizes or none.165
box_height_mmBox height (mm)OptionalWhole number, 10 to 1000The box's height in millimetres.114
box_depth_mmBox depth (mm)OptionalWhole number, 10 to 1000The box's depth in millimetres: how thick it is.33
box_weight_gBox weight (g)OptionalWhole number, 1 to 20000The boxed game's weight in grams.226
spine_faceSpineOptionalfront, back, top, bottom, left or rightWhich side faces out when the box sits on a shelf.left
fontSpine fontOptionalOne of our ten font namesThe font for a drawn spine when there is no spine image: bebas-neue, oswald, barlow-condensed, anton, archivo-black, fredoka, lilita-one, bangers, playfair-display or inter.bebas-neue
text_colorSpine text colourOptional#RRGGBBThe drawn spine's text colour. Give both colours or neither; together they must be easy to read (contrast at least 4.5 to 1).#FFFFFF
bg_colorSpine background colourOptional#RRGGBBThe drawn spine's background colour.#1A1A2E
face_front_urlFront imageOptionalhttps linkAn image of the box's front face. Only images you have the right to let us show.https://images.quillmoor.example/lanterns-front.jpg
face_front_showShow the front image?Optionalshow, ours or noshow: wherever we show images. ours: on AGDB and Gamestead only. no, or blank: we don't show it.show
face_front_creditFront image creditOptionalTextThe line shown with the image, like "Box art (c) Quillmoor Games". Needed for any image we show.Box art (c) Quillmoor Games
face_back_urlBack imageOptionalhttps linkAn image of the box's back face. Only images you have the right to let us show.https://images.quillmoor.example/lanterns-back.jpg
face_back_showShow the back image?Optionalshow, ours or noshow: wherever we show images. ours: on AGDB and Gamestead only. no, or blank: we don't show it.no
face_back_creditBack image creditOptionalTextThe line shown with the image, like "Box art (c) Quillmoor Games". Needed for any image we show.
face_top_urlTop imageOptionalhttps linkAn image of the box's top face. Only images you have the right to let us show.https://images.quillmoor.example/lanterns-top.jpg
face_top_showShow the top image?Optionalshow, ours or noshow: wherever we show images. ours: on AGDB and Gamestead only. no, or blank: we don't show it.no
face_top_creditTop image creditOptionalTextThe line shown with the image, like "Box art (c) Quillmoor Games". Needed for any image we show.
face_bottom_urlBottom imageOptionalhttps linkAn image of the box's bottom face. Only images you have the right to let us show.https://images.quillmoor.example/lanterns-bottom.jpg
face_bottom_showShow the bottom image?Optionalshow, ours or noshow: wherever we show images. ours: on AGDB and Gamestead only. no, or blank: we don't show it.no
face_bottom_creditBottom image creditOptionalTextThe line shown with the image, like "Box art (c) Quillmoor Games". Needed for any image we show.
face_left_urlLeft side imageOptionalhttps linkAn image of the box's left face. Only images you have the right to let us show.https://images.quillmoor.example/lanterns-left.jpg
face_left_showShow the left image?Optionalshow, ours or noshow: wherever we show images. ours: on AGDB and Gamestead only. no, or blank: we don't show it.no
face_left_creditLeft side image creditOptionalTextThe line shown with the image, like "Box art (c) Quillmoor Games". Needed for any image we show.
face_right_urlRight side imageOptionalhttps linkAn image of the box's right face. Only images you have the right to let us show.https://images.quillmoor.example/lanterns-right.jpg
face_right_showShow the right image?Optionalshow, ours or noshow: wherever we show images. ours: on AGDB and Gamestead only. no, or blank: we don't show it.no
face_right_creditRight side image creditOptionalTextThe line shown with the image, like "Box art (c) Quillmoor Games". Needed for any image we show.
Download the CSV templateBack to partners