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
| Column | Required | Format | What it holds | Example |
|---|---|---|---|---|
| upcUPC or GTIN | Required | UPC-A, EAN-13 or GTIN-14. Digits only, check digit included. | The barcode on the product. | 284739102659 |
| titleTitle | Required | Text | The product name, as printed on the box. | Lanterns of Quillmoor |
| publisherPublisher | Required | Text | The company that publishes the product. | Quillmoor Games |
| skuSKU | Optional | Text | Your item number. | QMG-LAN-01 |
| editionEdition | Optional | Text | Edition, printing or language, when the barcode is specific to one. | First edition, English |
| release_dateRelease date | Optional | YYYY-MM-DD, or YYYY-MM | The street date. | 2026-11-13 |
| case_packCase pack | Optional | Whole number | Units per case. | 6 |
| msrpMSRP | Optional | US dollars, e.g. 59.99 | Suggested retail price. | 59.99 |
| image_urlImage URL | Optional | https link | A direct link to the product image. | https://images.quillmoor.example/lanterns-of-quillmoor.jpg |
| image_permissionImage permission | Optional | yes or no | Whether we may show this row's image. A row's no overrides the form's confirmation. | yes |
| categoryCategory | Optional | Text, e.g. board game, expansion, accessory | Your category. It keeps items that are not games out of the game catalog. | board game |
| availabilityAvailability | Optional | in stock, backorder, preorder, out of print | Whether 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.
| Column | Required | Format | What it holds | Example |
|---|---|---|---|---|
| taglineTagline | Optional | Text | One short line that says what the game is. Shown under its title. | Light the harbor before the tide turns. |
| descriptionDescription | Optional | Text | What 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 players | Optional | Whole number | The smallest number of players the game works for. | 2 |
| players_maxMost players | Optional | Whole number | The largest number of players the game works for. | 5 |
| playtime_minShortest playing time | Optional | Whole number of minutes | About how long a short game takes, in minutes. | 30 |
| playtime_maxLongest playing time | Optional | Whole number of minutes | About how long a long game takes, in minutes. | 45 |
| age_suggestedSuggested age | Optional | Whole number of years | The youngest age the box suggests, in years. | 8 |
| designersDesigners | Optional | Names, separated by semicolons | Who designed the game. | A. Quill; R. Mariner |
| tagsTags | Optional | Words or phrases, separated by semicolons | Mechanics and themes. They help players and stores find the game. | family; tile laying; harbors |
| image_url_2Second image URL | Optional | https link | Another 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 URL | Optional | https link | A 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.
| Column | Required | Format | What it holds | Example |
|---|---|---|---|---|
| box_width_mmBox width (mm) | Optional | Whole number, 10 to 1000 | The box's width in millimetres, as it stands face out. Give all three sizes or none. | 165 |
| box_height_mmBox height (mm) | Optional | Whole number, 10 to 1000 | The box's height in millimetres. | 114 |
| box_depth_mmBox depth (mm) | Optional | Whole number, 10 to 1000 | The box's depth in millimetres: how thick it is. | 33 |
| box_weight_gBox weight (g) | Optional | Whole number, 1 to 20000 | The boxed game's weight in grams. | 226 |
| spine_faceSpine | Optional | front, back, top, bottom, left or right | Which side faces out when the box sits on a shelf. | left |
| fontSpine font | Optional | One of our ten font names | The 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 colour | Optional | #RRGGBB | The 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 colour | Optional | #RRGGBB | The drawn spine's background colour. | #1A1A2E |
| face_front_urlFront image | Optional | https link | An 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? | Optional | show, ours or no | show: wherever we show images. ours: on AGDB and Gamestead only. no, or blank: we don't show it. | show |
| face_front_creditFront image credit | Optional | Text | The 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 image | Optional | https link | An 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? | Optional | show, ours or no | show: wherever we show images. ours: on AGDB and Gamestead only. no, or blank: we don't show it. | no |
| face_back_creditBack image credit | Optional | Text | The line shown with the image, like "Box art (c) Quillmoor Games". Needed for any image we show. | |
| face_top_urlTop image | Optional | https link | An 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? | Optional | show, ours or no | show: wherever we show images. ours: on AGDB and Gamestead only. no, or blank: we don't show it. | no |
| face_top_creditTop image credit | Optional | Text | The line shown with the image, like "Box art (c) Quillmoor Games". Needed for any image we show. | |
| face_bottom_urlBottom image | Optional | https link | An 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? | Optional | show, ours or no | show: wherever we show images. ours: on AGDB and Gamestead only. no, or blank: we don't show it. | no |
| face_bottom_creditBottom image credit | Optional | Text | The line shown with the image, like "Box art (c) Quillmoor Games". Needed for any image we show. | |
| face_left_urlLeft side image | Optional | https link | An 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? | Optional | show, ours or no | show: wherever we show images. ours: on AGDB and Gamestead only. no, or blank: we don't show it. | no |
| face_left_creditLeft side image credit | Optional | Text | The line shown with the image, like "Box art (c) Quillmoor Games". Needed for any image we show. | |
| face_right_urlRight side image | Optional | https link | An 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? | Optional | show, ours or no | show: wherever we show images. ours: on AGDB and Gamestead only. no, or blank: we don't show it. | no |
| face_right_creditRight side image credit | Optional | Text | The line shown with the image, like "Box art (c) Quillmoor Games". Needed for any image we show. |