Destinations

Shopify Product Feed Setup and Field Mapping Guide

Complete technical reference for Shopify product feed fields, inventory management, pricing configuration, and optimisation for online store visibility and sales channel distribution.

13 min read 2 views Updated 8 Jul 2026

No results found

Try different keywords or browse all help articles.

    Overview of the Shopify Product Feed

    The Shopify product feed is the core data structure that powers your online store. Every product you create in Shopify generates a feed record containing inventory, pricing, visibility, and variant information. This feed controls what appears on your storefront, how customers search and filter products, and what data syncs to sales channels and third-party integrations.

    Merchants use the Shopify product feed to:

    • Manage product visibility across the online store and sales channels.
    • Control inventory levels in real time.
    • Set pricing rules and compare-at prices for promotions.
    • Organise products using tags, categories, and vendor information.
    • Configure shipping, tax, and fulfilment rules.
    • Optimise search and discovery through SEO metadata.

    Unlike external feed platforms that require CSV or XML uploads, the Shopify feed is native to the platform. Changes made in the Shopify admin update the feed immediately, and the feed syncs outbound to connected sales channels, affiliate networks, and advertising platforms.

    Core Product Identity Fields

    Handle

    The handle is a unique, URL-friendly identifier for each product. Shopify generates it automatically from the product title, converting it to lowercase and replacing spaces with hyphens. The handle appears in the product URL: yourstore.myshopify.com/products/handle-name.

    Handles must be unique across your store. If two products share the same handle, Shopify appends a number to the second one. Handles cannot contain special characters, only letters, numbers, and hyphens.

    Why this matters: Handles are used in API calls, bulk operations, and external integrations. A clear, descriptive handle improves SEO and makes product URLs human-readable. Changing a handle after launch breaks existing links and bookmarks, so plan handle names carefully before publishing products.

    Title

    The title is the primary product name displayed on your storefront and in search results. It appears in category pages, product cards, and the product detail page. Shopify does not enforce a character limit, but titles longer than 70 characters may truncate in search results and social media previews.

    Optimal titles include the product name, key variant (colour, size, material), and a descriptor that improves search visibility. Example: 'Organic Cotton T-Shirt - Navy Blue - Unisex'.

    Why this matters: Product titles are weighted heavily in internal store search and external search engine indexing. A clear, keyword-rich title increases the chance customers find the product when searching. Titles also appear in order confirmations and customer emails, so clarity and professionalism matter.

    Type

    The type field categorises products into logical groups (e.g., 'T-Shirt', 'Backpack', 'Coffee Maker'). Unlike tags, which are freeform, type is a single, standardised value per product. You can create new types or select from existing ones as you add products.

    Why this matters: Type enables customers to filter products by category on your storefront. It also helps with reporting and inventory management. Sales channels and affiliate networks often use type to classify products in their own catalogues.

    Vendor

    The vendor field identifies the manufacturer or brand of the product. For your own branded products, the vendor is typically your store name. For resold products, the vendor is the original manufacturer.

    Why this matters: Vendor filtering improves storefront navigation. It also supports multi-vendor logic: if you sell products from multiple suppliers, the vendor field helps track which supplier to contact for reorders. Some sales channels require vendor data for approval or categorisation.

    Visibility and Status Management

    Status

    The status field controls whether a product exists in your store. Two values are available:

    • Active: Product is live and can be published to sales channels.
    • Draft: Product exists in your admin but is hidden from customers.

    Draft products do not appear on your storefront, in search results, or in feeds sent to third parties. Use draft status for products under development, seasonal items not yet ready for sale, or products awaiting inventory.

    Why this matters: Status prevents incomplete or out-of-stock products from appearing in customer-facing feeds. Changing status from draft to active immediately makes the product available for purchase and visible in external feeds.

    Published and Published on Online Store

    The published field indicates whether a product is published to any sales channel (online store, Facebook, Amazon, etc.). The published on online store field specifically controls visibility on your Shopify storefront.

    A product can be active but not published to the online store if you are selling it only through external channels (e.g., Amazon or Facebook Shop). Conversely, a product can be published to the online store but not to other sales channels.

    Why this matters: This separation allows you to manage multi-channel inventory. You might publish a product to Facebook Shop weeks before adding it to your online store, or sell exclusively through your store while keeping external channels inactive. Customers see only products published to the online store, so this setting directly impacts storefront visibility.

    Pricing Configuration

    Price

    The price field is the amount customers pay at checkout. It is the only required pricing field. Price supports decimal values (e.g., 19.99) and is displayed in your store's default currency.

    Why this matters: Price is the primary transaction value. Errors in price configuration lead to revenue loss or customer disputes. Prices must be consistent across variants and sales channels unless you intentionally apply channel-specific pricing.

    Compare-at Price

    The compare-at price (also called 'original price' or 'strikethrough price') is displayed alongside the selling price to show a discount or savings. For example, a product with a compare-at price of £50 and a price of £35 displays as '£35 (was £50)'.

    The compare-at price is optional. If left blank, no discount is displayed. The compare-at price must be higher than the selling price to display correctly.

    Why this matters: Compare-at pricing creates urgency and increases perceived value. It is commonly used for sales, promotions, and bundle discounts. Sales channels and email marketing platforms pull the compare-at price to display promotional messaging, so accuracy is important for campaign consistency.

    Cost per Item

    The cost per item is your internal cost to acquire or manufacture the product. This field is not displayed to customers. It is used for profit margin reporting, inventory valuation, and financial analysis.

    Why this matters: Cost per item enables Shopify's profit reporting features. You can see gross margin (price minus cost) on a per-product and per-order basis. This data informs pricing decisions and supplier negotiations. Cost per item is not synced to most external channels, so it remains private to your store.

    Inventory and Fulfillment Configuration

    SKU and Barcode

    The SKU (stock-keeping unit) is an internal identifier for inventory tracking. It is often alphanumeric and unique to your store. The barcode is a standardised identifier (typically a UPC, EAN, or ISBN) used by suppliers, retailers, and logistics partners.

    SKU is required for inventory tracking in Shopify. Barcode is optional but recommended if you use point-of-sale systems, affiliate networks, or external inventory management tools.

    Why this matters: SKU enables you to track inventory across locations and sales channels. A mismatch between SKU and actual stock leads to overselling or customer cancellations. Barcode integration with affiliate networks and comparison shopping engines ensures accurate product matching and reduces feed rejection errors.

    Inventory Quantity

    The inventory quantity is the number of units in stock. Shopify tracks inventory per location (warehouse, store, etc.) and per variant. When a customer purchases, inventory decreases automatically.

    Why this matters: Inventory quantity controls the 'Add to Cart' button. If quantity is zero, the product shows as out of stock and cannot be purchased (unless 'continue selling when out of stock' is enabled). Inaccurate inventory causes customer frustration and lost sales. Real-time inventory sync to sales channels prevents overselling across multiple platforms.

    Continue Selling When Out of Stock

    When enabled, this setting allows customers to purchase products even when inventory quantity reaches zero. Useful for pre-orders or made-to-order items.

    Why this matters: Enabling this setting prevents lost sales but requires clear communication to customers about delivery timelines. Disabling it prevents overselling but may result in lost revenue if demand exceeds stock.

    Requires Shipping

    The requires shipping field indicates whether a product incurs shipping costs. Digital products, gift cards, and services typically do not require shipping.

    Why this matters: If requires shipping is enabled, Shopify calculates shipping costs at checkout based on weight and carrier rates. If disabled, the product ships free or is not subject to shipping logic. Incorrect configuration results in incorrect shipping charges or customer complaints.

    Weight Value (Grams)

    The weight value is the product weight in grams. It is used to calculate shipping costs. Shopify supports conversion to other units (pounds, kilograms, ounces) in the admin, but the feed stores weight in grams.

    Why this matters: Shipping carriers use weight to calculate rates. Incorrect weight leads to incorrect shipping quotes and potential underpayment to carriers. For heavy products, weight directly impacts profitability.

    Fulfillment Service

    The fulfillment service field specifies which service handles order fulfillment (Shopify Fulfillment Network, a third-party logistics provider, manual fulfillment, etc.). Each product can be assigned to a different fulfillment service.

    Why this matters: Fulfillment service determines how orders are processed and shipped. If you use multiple warehouses or third-party logistics providers, this field routes orders to the correct location.

    Inventory Tracker

    The inventory tracker field specifies which system manages inventory for the product. Options include Shopify (default), external systems, or manual tracking.

    Why this matters: If you use external inventory management software, setting the inventory tracker to that system prevents double-counting and keeps stock levels in sync across platforms.

    Content and SEO Fields

    Body (HTML)

    The body field contains the product description in HTML format. This is the main content displayed on the product detail page. It can include formatted text, images, videos, and structured data.

    Why this matters: Product descriptions influence purchase decisions and search engine rankings. Detailed, keyword-rich descriptions improve SEO and reduce return rates by setting accurate expectations. HTML formatting allows rich media and custom styling.

    SEO Title and SEO Description

    The SEO title and SEO description are optimised versions of the product title and description for search engines. The SEO title appears in search results and browser tabs. The SEO description appears as the snippet below the title in search results.

    Optimal SEO titles are 50-60 characters. Optimal SEO descriptions are 150-160 characters. Both should include target keywords and a call to action.

    Why this matters: SEO title and description directly impact click-through rate from search results. A compelling, keyword-rich description increases organic traffic. If these fields are blank, Shopify uses the product title and body excerpt, which may not be optimised.

    Tags

    The tags field is a comma-separated list of keywords or labels for the product. Tags are used for internal organisation, customer filtering, and reporting. Unlike type (which is a single value), a product can have multiple tags.

    Example tags: 'New Arrival', 'On Sale', 'Organic', 'Bestseller', 'Gift'.

    Why this matters: Tags enable storefront filtering and search. Customers can filter by tag to narrow results. Tags also support bulk operations: you can apply discounts, change status, or export products by tag. Some sales channels use tags for categorisation or approval workflows.

    Product Category

    The product category field assigns the product to a category in your store's taxonomy. This differs from type in that it is hierarchical (e.g., 'Clothing > Tops > T-Shirts').

    Why this matters: Product categories structure your storefront and improve navigation. They also enable category-level discounts, reporting, and SEO optimisation (category pages rank for category keywords).

    Media and Variant Fields

    Product Image URL and Image Alt Text

    The product image URL is the primary image displayed on the product card and detail page. The image alt text is descriptive text read by screen readers and displayed if the image fails to load.

    Alt text should be descriptive and include relevant keywords. Example: 'Navy blue organic cotton t-shirt, unisex fit, front view'.

    Why this matters: Alt text improves accessibility for users with visual impairments and helps search engines understand image content. High-quality, optimised images increase conversion rates and reduce return rates.

    Variant Image URL

    The variant image URL is an image specific to a product variant (e.g., the red version of a t-shirt). If set, it overrides the primary product image when that variant is selected.

    Why this matters: Variant images improve the customer experience by showing the correct colour, size, or style. They also reduce confusion and returns caused by incorrect product expectations.

    Gift Cards and Tax Configuration

    Gift Card

    The gift card field indicates whether the product is a gift card. Gift cards have special handling: they do not require shipping, are not subject to inventory limits (unless configured), and may have special tax treatment.

    Why this matters: Gift cards are a distinct product type with different business logic. Marking a product as a gift card ensures correct tax calculation and shipping configuration.

    Charge Tax

    The charge tax field specifies whether tax is calculated on the product at checkout. For most products, this is enabled. Some jurisdictions exempt certain products (e.g., food, medicine) from tax.

    Why this matters: Incorrect tax configuration results in customer disputes and potential legal issues. Ensure tax rules match local regulations for each product category.

    Practical Optimization Tips

    Feed Accuracy and Consistency

    1. Audit all required fields (handle, title, price, status) before publishing products.
    2. Use consistent naming conventions for vendors, types, and tags across your store.
    3. Ensure SKU and barcode values are unique and match your physical inventory system.
    4. Test inventory sync by placing a test order and confirming stock decreases across all sales channels.

    SEO and Discoverability

    1. Write titles and SEO descriptions with target keywords naturally included.
    2. Use alt text that describes the product accurately and includes relevant keywords.
    3. Populate the body field with detailed, structured product information (materials, dimensions, care instructions).
    4. Assign products to categories and use tags to enable multiple discovery paths.

    Sales Channel Sync

    1. Publish products to the online store before syncing to external channels.
    2. Verify that compare-at prices display correctly on sales channels.
    3. Test variant images on each channel to ensure correct display.
    4. Monitor inventory levels across channels to prevent overselling.

    Pricing and Promotions

    1. Set compare-at prices to reflect true pre-discount values (not inflated).
    2. Use tags to identify products on sale, enabling bulk discount application.
    3. Review cost per item regularly to ensure pricing covers costs and desired margin.
    4. Test pricing changes on a staging environment before applying to live products.

    Summary

    The Shopify product feed is the central data hub for your online store. Each field controls a specific aspect of product visibility, pricing, inventory, and customer experience. Accurate, consistent feed data directly impacts sales, customer satisfaction, and operational efficiency.

    Prioritise getting the core fields right: handle, title, price, inventory quantity, and published status. Then layer in supporting fields: SKU, barcode, tags, SEO metadata, and images. Regular audits and testing ensure your feed remains accurate as your store grows and integrates with external channels.