Complete listing requirements, feed specifications, and optimization tips for Shopify.
Shopify is the world's leading e-commerce platform, powering over 4.4 million online stores across 175 countries. Unlike traditional marketplaces such as Amazon or eBay, Shopify enables merchants to build and operate their own branded online storefronts with full control over the customer experience, branding, pricing, and marketing. With Shopify's extensive ecosystem of apps, themes, and integrations, businesses of all sizes — from solo entrepreneurs to enterprise brands like Gymshark, Allbirds, and Heinz — can launch, manage, and scale their e-commerce operations. Shopify also offers multi-channel selling capabilities, allowing merchants to sell simultaneously across their own store, social media platforms, and third-party marketplaces.
Managing product data on Shopify revolves around a flexible product catalog system. Each product can have a title, description (with full HTML and rich text support), images, variants (combinations of options like size, color, and material), pricing, inventory levels, and SEO metadata. Shopify supports up to 100 variants per product and 3 option types (e.g., Size, Color, Material), though the Shopify Markets and metafields system extends customization far beyond these defaults. Unlike marketplace-style platforms that enforce rigid category taxonomies, Shopify allows merchants to create their own collection structures using manual and automated rules, giving sellers complete flexibility in how products are organized and displayed.
Shopify provides a comprehensive suite of tools for product data management including the Shopify Admin dashboard, bulk CSV imports/exports, and the Shopify Admin API (both REST and GraphQL). The GraphQL Admin API is the recommended integration method for PIM systems, offering efficient batch operations for product creation, updates, inventory management, and metafield synchronization. Shopify's Storefront API enables headless commerce implementations, while Shopify Flow automates business workflows. Integrating a PIM system with Shopify enables merchants to maintain a single source of truth for product data, synchronize content across multiple Shopify stores and sales channels, and ensure consistency in product information, images, and pricing across every customer touchpoint.
Required and optional fields for product listings on this marketplace
The product title is displayed on the product page, in collection listings, in search results, and in the browser tab. Unlike marketplace platforms, Shopify does not enforce a strict title formula, giving merchants creative freedom. However, titles should be clear, descriptive, and include relevant keywords for SEO. Avoid excessive capitalization, special characters, or promotional language in titles as these can hurt search engine rankings and appear unprofessional.
Organic Cotton Crew Neck T-Shirt - Sage GreenShopify product descriptions support full HTML formatting, allowing merchants to create richly structured content with headings, bullet lists, images, videos, and custom styling. The description appears on the product detail page and is critical for both conversion and SEO. Use descriptive, benefit-focused copy that addresses customer questions and highlights unique selling points. Shopify's rich text editor makes formatting accessible without HTML knowledge, but custom HTML can be used for advanced layouts.
Crafted from 100% GOTS-certified organic cotton, this crew neck t-shirt combines everyday comfort with sustainable style. Features a relaxed fit, reinforced stitching, and pre-shrunk fabric for lasting wear.High-quality product images are essential for conversion on Shopify stores. Shopify automatically generates multiple image sizes for responsive display across devices and supports image zoom on desktop. Unlike Amazon, there is no strict white-background requirement — merchants have full creative control over image style and branding. However, consistency across all product images is important for a professional storefront appearance. Shopify supports 3D models and video uploads as well, enabling immersive product experiences with AR (augmented reality) previews on supported devices.
Hero image on clean background, lifestyle shot, detail/texture close-up, size comparison, product in packagingEach product and variant requires a price. Shopify supports a 'Compare at' price field that displays the original price alongside a sale price, automatically showing the discount to customers. For international selling, Shopify Markets allows merchants to set region-specific pricing with automatic or manual currency conversion. Cost per item can be tracked for profit margin reporting. Shopify also supports subscription pricing through apps like Shopify Subscriptions or ReCharge.
39.99Inventory tracking is managed per variant and per location in Shopify. Each variant can have inventory levels set at one or more fulfillment locations (warehouses, retail stores, or 3PL providers). Shopify supports inventory tracking policies of 'Shopify tracks this product's inventory' or 'Don't track inventory'. Product weight is required for accurate shipping rate calculation and is set per variant. Ensure weights are accurate to avoid shipping cost discrepancies that erode margins or cause customer complaints.
Inventory: 150 units at Warehouse A / Weight: 180gVariants represent different versions of a product, such as size, color, or material combinations. Each variant can have its own SKU, price, inventory quantity, weight, and barcode. Shopify allows up to 3 option types with a maximum of 100 variant combinations per product. For products requiring more options (e.g., custom products with many configurations), Shopify's Combined Listings app or third-party apps can extend variant limits. Each variant should have its own image assigned for accurate visual representation when customers select different options.
Size: Small, Medium, Large, X-Large / Color: Sage Green, Navy, CharcoalSKUs are internal identifiers used for inventory tracking, order management, and warehouse operations. While not required by Shopify, implementing a consistent SKU naming convention is strongly recommended for operational efficiency. SKUs must be unique across all products and variants in a Shopify store. A well-structured SKU system (e.g., category-style-color-size) makes it easier to manage inventory, track sales performance, and integrate with fulfillment and PIM systems.
OCT-CREW-SG-M (Organic Cotton Tee, Crew, Sage Green, Medium)Product identifiers are optional in Shopify but recommended for inventory management, multi-channel selling, and integration with sales channels like Google Shopping and Facebook/Instagram. When selling through Shopify's built-in Google and Facebook channels, a valid GTIN significantly improves product visibility and ad performance. Barcodes should be GS1-issued and match the specific variant they are assigned to.
0123456789012Product type is a free-form text field used to categorize products within the Shopify admin and for filtering in collections. Unlike marketplace browse nodes, Shopify does not enforce a standardized taxonomy, but using the Shopify Standard Product Taxonomy (introduced in 2024) is recommended for multi-channel compatibility. Consistent product type values across your catalog enable better collection automation, reporting, and integration with sales channels that require category mapping.
T-ShirtsTags are flexible labels used for organizing products, creating automated collections, filtering in the storefront, and powering internal search. There is no limit to the number of tags per product. Tags are especially useful for creating cross-category groupings (e.g., 'gift-guide', 'best-sellers', 'clearance') and for driving automated collection rules. While tags do not directly impact SEO, they improve site navigation and can enhance the customer browsing experience through filtered search results.
organic, sustainable, mens, crew-neck, summer-collection, new-arrivalsShopify generates default SEO titles and meta descriptions from the product title and description, but these can (and should) be customized for search engine optimization. The SEO title appears as the clickable link in Google search results, while the meta description provides the snippet text. Include primary keywords naturally, focus on benefits and differentiators, and write compelling copy that encourages clicks. Shopify also allows editing the URL handle for each product, which should be short, descriptive, and keyword-rich.
Title: Organic Cotton Crew Neck T-Shirt - Sage Green | YourBrand / Meta: Shop our GOTS-certified organic cotton crew neck t-shirt in Sage Green. Relaxed fit, sustainable fabric, and reinforced stitching for lasting comfort.Metafields allow merchants to store additional structured data on products, variants, collections, and other Shopify resources beyond the standard fields. They are essential for enriching product pages with specifications, care instructions, material details, sizing charts, or any custom attributes specific to your catalog. Metafields can be displayed on the storefront through theme customization and are accessible via the Shopify API. Shopify's standard metafield definitions provide pre-built types for common use cases, and custom definitions can be created for unique business needs.
custom.material = '100% Organic Cotton' / custom.care_instructions = 'Machine wash cold, tumble dry low'CSV, JSON (Admin API), GraphQL (Admin API)
Shopify supports multiple methods for product data management. The simplest is CSV import/export through the Shopify Admin, which handles product creation, updates, and bulk edits using a standardized spreadsheet format. For automated integrations, the Shopify Admin API offers both REST and GraphQL endpoints for programmatic product management. The GraphQL Admin API is the recommended approach for PIM integrations due to its efficiency with batch operations (up to 10 product mutations per request via bulkOperationRunMutation), flexible data querying, and lower rate limit consumption. Shopify also supports real-time synchronization through webhooks for product, inventory, and order events.
Shopify introduced the Shopify Standard Product Taxonomy in 2024, providing a standardized, open-source category system that maps products to a global taxonomy. This taxonomy is designed to improve compatibility with sales channels like Google Shopping, Facebook/Instagram, and TikTok by providing consistent category mapping. Unlike rigid marketplace taxonomies, Shopify also allows merchants to create entirely custom collection structures using manual collections (hand-picked products) and automated collections (rule-based grouping by product type, tag, vendor, price, etc.). The combination of standard taxonomy for channel compatibility and custom collections for storefront organization gives merchants maximum flexibility.
Detailed requirements for product titles, descriptions, images, and pricing
Avoid these common issues that cause product listings to be rejected or suppressed
Product images fail to load or exceed the 20 MB file size limit
Compress images to under 20 MB and ensure resolution does not exceed 4472 x 4472 pixels. Use JPEG format for photographs (typically smaller file sizes) and PNG for graphics with transparency. Tools like TinyPNG or Shopify's built-in image optimization can help reduce file sizes without visible quality loss. Verify image URLs are accessible if using external image sources via the API.
CSV import fails due to incorrect column headers or formatting errors
Download a fresh CSV template by exporting your current products from Shopify Admin (Products > Export). Use this as the base template for your import file. Ensure column headers match Shopify's expected format exactly (case-sensitive). Common issues include incorrect variant formatting, missing 'Handle' column values for grouping variants, and encoding problems with special characters. Save CSV files in UTF-8 encoding to support international characters.
Variant limit exceeded (more than 100 combinations per product)
Restructure products that require more than 100 variant combinations. Consider splitting into multiple products with overlapping tags for collection grouping, using the Combined Listings app for high-variant products, or utilizing metafields and line item properties for customization options that don't need separate inventory tracking. Evaluate whether all variant combinations actually need unique inventory tracking or if some can be handled through order notes.
Duplicate URL handles causing product creation failures
Shopify requires unique URL handles for each product. If your import contains products with handles that already exist in the store, Shopify will either reject the import or append a number to the handle. Before importing, export your current products to check for handle conflicts. Use your PIM system to generate unique handles based on a consistent naming convention. When updating existing products via CSV, use the 'Handle' column to match products correctly.
Products not appearing in collections or sales channels after creation
Check that products have the correct product type, tags, and vendor values that match your automated collection conditions. Verify that the product status is set to 'Active' (not 'Draft' or 'Archived'). Ensure the product is published to the relevant sales channels (Online Store, Point of Sale, Google, Facebook, etc.) in the product's availability settings. For multi-channel issues, verify that the product meets the requirements of each specific sales channel (e.g., Google Shopping requires a valid GTIN and product category).
Metafield values rejected due to type mismatch or invalid definition
Ensure that metafield values match the defined type in your metafield definition (e.g., a 'number_integer' type field will reject decimal values). Create metafield definitions in Shopify Admin under Settings > Custom Data before importing metafield values. Use the correct namespace and key format (namespace.key) when setting values via API. For JSON-type metafields, validate the JSON structure before submission.
Inventory levels not syncing across locations after product import
When importing inventory via CSV, ensure you specify the correct inventory location names in the import file. Each location must be set up in Shopify Admin under Settings > Locations before import. When using the API, use the inventorySetQuantities mutation (GraphQL) or the Inventory Level API (REST) to set stock at specific locations. Verify that inventory tracking is enabled on the product/variant level and that the fulfillment service is correctly assigned.
Product descriptions losing formatting or displaying raw HTML on storefront
Ensure your Shopify theme properly renders the product description field with the appropriate Liquid filter ({{ product.description }}). If importing descriptions via CSV, use properly escaped HTML and avoid broken tags. Test descriptions in the Shopify Admin rich text editor before publishing. For complex layouts, consider using metafields with dedicated theme sections rather than embedding complex HTML in the description field, as theme updates may affect HTML rendering.
Best practices to improve your product listing performance and visibility
Go beyond standard product fields by creating metafield definitions for specifications, materials, care instructions, warranty information, and any category-specific attributes. Metafields allow you to display structured, consistent product information through dedicated theme sections rather than embedding everything in the product description. This approach improves data quality, enables better filtering and search, and creates a more professional product page experience. Use Shopify's standard metafield definitions where available for compatibility with sales channels and apps.
Customize SEO titles, meta descriptions, and URL handles for every product rather than relying on defaults. Research relevant keywords using tools like Google Keyword Planner, Ahrefs, or SEMrush. Include primary keywords in the product title, H1 tag, first paragraph of the description, image alt text, and URL handle. Create a content strategy using Shopify's blog to build topical authority and drive organic traffic to product pages. Implement structured data (JSON-LD) for rich snippets showing price, availability, and reviews in search results.
Invest in professional product photography with consistent lighting, angles, and styling across your entire catalog. Use a consistent aspect ratio (1:1 is standard) for all product images to create clean, uniform collection grids. Include lifestyle images that show the product in context, close-up detail shots that highlight quality and craftsmanship, and size/scale reference images. Add 3D models for products where spatial understanding matters. Always include descriptive alt text for accessibility and SEO. Consistent, high-quality imagery is one of the strongest conversion drivers in e-commerce.
Use automated collections based on product type, tags, vendor, price, and other attributes to create self-maintaining product groupings. This eliminates the need to manually add products to collections every time new inventory arrives. Combine with consistent tagging conventions in your PIM to power seasonal collections, sale pages, new arrivals, and category-based navigation automatically. Automated collections update in real-time as products are added or modified, reducing operational overhead.
Structure product pages with clear visual hierarchy: prominent product title, price, and add-to-cart button above the fold. Use trust signals such as reviews, ratings, shipping information, and return policies near the purchase decision point. Implement urgency and scarcity elements (low stock indicators, limited edition badges) using metafields and theme customizations. A/B test product page elements using Shopify's built-in analytics or third-party tools to continuously improve conversion rates.
Connect your Shopify store to additional sales channels including Google Shopping, Facebook/Instagram Shops, TikTok, Pinterest, and the Shopify Shop app. Ensure all products have valid GTINs, accurate product categories (using Shopify's Standard Product Taxonomy), and complete attribute data for maximum visibility and ad performance across channels. Use a PIM system to maintain a single source of truth for product data, ensuring consistency across every channel and reducing the risk of feed rejection or disapproval.
Shopify Markets enables merchants to sell internationally from a single store with localized experiences including translated content, local currencies, market-specific pricing, regional domains, and local payment methods. Prepare your product data for internationalization by structuring descriptions, titles, and metafield values with translation in mind. Use Shopify's Translate & Adapt app or integrate your PIM system's translation workflows to manage multilingual product content efficiently across all target markets.
Ensure your Shopify theme generates proper JSON-LD structured data for products, including price, availability, brand, SKU, GTIN, reviews, and ratings. Rich snippets in Google search results significantly improve click-through rates by displaying star ratings, pricing, and stock status directly in the SERP. Validate your structured data using Google's Rich Results Test tool. Extend product markup with additional schema properties through metafields and theme customization to maximize your visibility in search results.
Step-by-step guide to getting your products live on this marketplace
Create your Shopify account at shopify.com and select a plan that matches your business needs. Complete the initial store setup including your store name, legal information, payment provider (Shopify Payments recommended), and shipping settings. Navigate to Settings > Custom Data to create metafield definitions for any custom product attributes you need beyond the standard fields (e.g., materials, specifications, care instructions). Set up your fulfillment locations under Settings > Locations. If selling internationally, configure Shopify Markets with your target regions, currencies, and pricing strategies.
Before importing products, plan your product data architecture. Define consistent product types, tags, and vendor values that will power your automated collections and storefront navigation. Establish a SKU naming convention that encodes category, style, variant, and size information. Map your PIM product attributes to Shopify fields: standard fields (title, description, product type, vendor, tags), variant options (size, color, material), and metafields (specifications, care instructions, custom attributes). Prepare high-quality images in consistent dimensions and format. Create a CSV import file or configure your PIM's Shopify API integration.
Upload your product data using CSV import (Products > Import in Shopify Admin) for initial bulk loading, or set up API-based synchronization through your PIM for ongoing management. Verify that all products imported correctly by checking titles, descriptions, images, variants, pricing, inventory levels, and metafield values. Create your collection structure using both manual and automated collections. Customize SEO metadata (titles, descriptions, URL handles) for your most important products and collections. Assign variant images and ensure all media is properly linked.
Download our comprehensive guide to building a high-converting Shopify product catalog. Learn how to structure your product data, optimize for search engines, leverage metafields for rich product pages, and manage multi-channel selling from a single source of truth.
Common questions about listing products on Shopify
WisePIM helps you manage product listings across multiple marketplaces from one central platform.