DOPE Product Feed Specification v1.0

1. Overview

The DOPE product feed is a standard XML file that retailers host at a publicly accessible URL. DOPE's ingestion system fetches this feed daily, parses the product data, validates it against the spec below, and indexes qualifying products across the platform's Deals, Price Finder, Value, and Reviews pages.

Your feed should contain your complete in-stock inventory within our supported categories: Firearms, Optics, Ammunition, and Gear. Out-of-stock items should either be excluded or marked with <in_stock>false</in_stock>.

2. XML Schema

Below is a complete example of a valid DOPE product feed with all supported fields.

                    feed.xml
                    
                

<?xml version="1.0" encoding="UTF-8"?>
<products>
  <product>
    <sku>MERCHANT-SKU</sku>           <!-- required -->
    <upc>123456789012</upc>           <!-- strongly recommended -->
    <name>Product Name</name>          <!-- required -->
    <brand>Brand</brand>               <!-- required -->
    <category>Firearms</category>      <!-- required: Firearms|Optics|Ammunition|Gear -->
    <price>539.00</price>              <!-- required, current selling price -->
    <msrp>599.99</msrp>               <!-- recommended -->
    <url>https://store.com/...</url>   <!-- required, direct product page -->
    <image_url>https://...</image_url> <!-- required -->
    <in_stock>true</in_stock>          <!-- required: true|false -->
    <caliber>9mm</caliber>             <!-- recommended for firearms/ammo -->
    <condition>new</condition>         <!-- recommended: new|used|refurbished -->
    <description>...</description>     <!-- recommended, max 500 chars -->
  </product>
</products>
                

3. Field Reference

Complete reference for every field in the DOPE product feed schema.

Field	Required	Type	Description
sku	Required	String	Your internal merchant SKU. Must be unique within your feed.
upc	Recommended	String (12 digits)	Universal Product Code. Strongly recommended for product matching and deduplication across retailers.
name	Required	String	Full product name including brand, model, and key specifications (e.g., caliber, barrel length).
brand	Required	String	Manufacturer or brand name. Use consistent casing (e.g., "Smith & Wesson" not "S&W").
category	Required	Enum	One of: `Firearms`, `Optics`, `Ammunition`, `Gear`. Case-sensitive.
price	Required	Decimal	Current selling price in USD. No currency symbols. Two decimal places (e.g., 539.00).
msrp	Recommended	Decimal	Manufacturer's suggested retail price. Used to calculate savings and value scores.
url	Required	URL	Direct link to the product page on your website. Must be a valid HTTPS URL with no redirects.
image_url	Required	URL	Direct link to a product image. HTTPS required. Minimum 400x400px recommended. JPEG or PNG.
in_stock	Required	Boolean	Current availability. Use `true` or `false`. Only in-stock products are displayed.
caliber	Recommended	String	Caliber or gauge for firearms and ammunition (e.g., "9mm", "5.56 NATO", "12 Gauge").
condition	Recommended	Enum	One of: `new`, `used`, `refurbished`. Defaults to "new" if omitted.
description	Optional	String	Brief product description. Maximum 500 characters. Plain text only, no HTML.

4. Categories

All products must be assigned to one of the four supported categories. Use the exact values shown below.

Firearms

Handguns, rifles, shotguns, receivers, frames, and complete firearm systems. Includes NFA items (SBRs, suppressors).

Optics

Riflescopes, red dot sights, holographic sights, magnifiers, night vision, thermal, rangefinders, and binoculars.

Ammunition

Centerfire, rimfire, shotshell, and specialty ammunition. Includes bulk packs and reloading components.

Gear

Holsters, magazines, cases, safes, cleaning kits, lights, lasers, grips, stocks, triggers, and other accessories.

5. Feed Requirements

Your feed must meet the following criteria to be accepted into the DOPE platform.

Minimum 500 in-stock products per feed
XML format conforming to the schema above
Hosted at a publicly accessible HTTPS URL
Updated at least once every 24 hours
Maximum file size of 50 MB
Only include products with accurate, current pricing
Product URLs must link directly to the product page (no redirect chains)
Image URLs must be live and return valid JPEG or PNG images

6. Compatible Tools

These platforms and plugins can generate feeds compatible with the DOPE specification with minimal configuration.

AmmoReady

Full-service ecommerce platform for FFLs. Native XML feed export maps directly to the DOPE spec.

Feedonomics

Enterprise feed management platform. Create a custom DOPE template to map your catalog fields.

TTG WordPress Plugin

WooCommerce product feed plugin with firearms-specific field mappings and scheduled XML exports.

7. Feed Validator

Test Your Feed

Enter your feed URL to validate it against the DOPE spec. We will fetch the first 5 MB and report any issues.

8. Contact

Questions About Your Feed?

Our integration team is here to help you get set up. Reach out any time.

feeds@dope-hq.com

Ready to list your store? Apply here →

DOPE Product Feed Specification

Contents