Complete listing requirements, feed specifications, and optimization tips for Etsy.
Etsy is the world's leading online marketplace for handmade, vintage, and creative goods, connecting over 95 million active buyers with approximately 7.5 million active sellers across more than 230 countries. Founded in 2005 in Brooklyn, New York, Etsy has become the go-to platform for artisans, crafters, designers, and curators who sell unique and creative products ranging from handmade jewelry and custom clothing to vintage home decor and digital downloads. The platform's focus on unique, one-of-a-kind, and small-batch items differentiates it from mass-market marketplaces, attracting buyers specifically looking for products with character, craftsmanship, and personal touch.
Listing products on Etsy requires sellers to follow the platform's policies around what constitutes handmade, vintage (20+ years old), or craft supply items. Every listing must include high-quality photographs (Etsy recommends at least five images per listing), a descriptive title optimized for Etsy's search algorithm, detailed product descriptions, accurate pricing, and appropriate categorization using Etsy's taxonomy and tags. Etsy's search engine relies heavily on listing quality signals including title relevance, tag usage, listing completeness, and shop quality scores to rank products in search results. Sellers who invest in complete, well-optimized listings see significantly better visibility and sales performance.
Etsy provides sellers with a comprehensive suite of tools through the Seller Dashboard, including order management, inventory tracking, sales analytics, and marketing tools such as Etsy Ads, social media integration, and sales events. For product data management, Etsy supports manual listing creation, CSV bulk uploads for shops with large inventories, and a robust REST API (Etsy Open API v3) for programmatic integrations. Integrating a PIM system with Etsy enables sellers to maintain consistent product data across Etsy and other sales channels, efficiently manage large catalogs, and ensure listings remain optimized and up-to-date. This is especially valuable for sellers who also sell on their own website, Amazon Handmade, or other creative marketplaces.
Required and optional fields for product listings on this marketplace
The listing title is the single most important factor for Etsy search visibility. Etsy's search algorithm weighs the first few words most heavily, so place your primary keywords at the beginning. Include descriptive terms that buyers would use to search for your product. Use natural language rather than keyword stuffing. You can include secondary keywords separated by hyphens or pipes for additional search coverage. Avoid using all caps, special characters (except hyphens), or shop-specific codes that buyers wouldn't search for.
Handmade Sterling Silver Moon Phase Necklace - Celestial Jewelry - Crescent Moon Pendant - Gift for HerThe listing description should provide comprehensive information about the product including materials, dimensions, customization options, production process, shipping details, and care instructions. While Etsy's search algorithm primarily uses titles and tags for ranking, descriptions contribute to listing quality scores and are essential for converting browsers into buyers. Lead with the most compelling information, as only the first few lines are visible before the customer clicks 'Read more.' Include relevant keywords naturally throughout the description.
This hand-forged sterling silver necklace features a delicate crescent moon pendant inspired by the lunar phases. Each piece is individually crafted in my studio, making every necklace truly one-of-a-kind.
DETAILS:
- Material: .925 Sterling Silver
- Chain length: 18 inches (adjustable to 16 inches)
- Pendant size: 15mm x 12mm
- Clasp: Lobster claw
Ships in a gift-ready box. Handmade to order — please allow 3-5 business days for creation before shipping.Etsy recommends at least five photos per listing, with up to ten allowed. The first image is the thumbnail that appears in search results and is critical for click-through rate. Images should be well-lit, in focus, and styled to reflect the handmade nature and quality of the product. Etsy supports landscape (4:3) and square (1:1) aspect ratios. Include images showing the product from multiple angles, close-up details of craftsmanship or texture, the item in use or worn, size reference with common objects, and packaging. For customizable items, show examples of different customization options.
Image 1: Hero shot of the product on a styled background. Images 2-5: Different angles, detail shots, scale reference, packaging. Images 6-10: Lifestyle/in-use shots, variations, process photosSet your listing price to reflect the cost of materials, labor, overhead, and profit margin. Etsy charges a $0.20 listing fee (per listing, renewed every 4 months or upon sale), a 6.5% transaction fee on the sale price including shipping, and payment processing fees (typically 3% + $0.25). Factor these fees into your pricing. Etsy also allows sellers to set sale prices with scheduled start and end dates, and to offer coupon codes for promotions.
42.00The number of units available for sale. For made-to-order items, set the quantity to the number you can reasonably produce within your stated processing time. When a listing sells out (quantity reaches zero), the listing becomes inactive and loses its search ranking momentum. Keep listings active by maintaining stock levels or using the auto-renew feature. Each renewal costs $0.20.
5Tags are one of the primary ranking factors in Etsy's search algorithm. You can add up to 13 tags per listing, and you should use all 13. Each tag can be a multi-word phrase up to 20 characters. Tags should include synonyms, alternate spellings, related terms, and long-tail keyword phrases that buyers might use to find your product. Avoid repeating exact phrases that are already in your title (Etsy already indexes the title). Include a mix of broad terms (e.g., 'handmade jewelry') and specific terms (e.g., 'crescent moon pendant'). Use all available tag slots.
sterling silver necklace, moon phase jewelry, celestial pendant, handmade necklace, crescent moon, gift for her, boho jewelry, witch jewelry, astronomy gift, lunar necklace, artisan jewelry, minimalist pendant, nature inspiredEvery listing must be assigned to a category from Etsy's taxonomy. Select the most specific category available, as this determines which browse pages and filters your listing appears in. Etsy's category structure includes top-level departments (Jewelry, Clothing, Home & Living, etc.) with increasingly specific sub-categories. Proper categorization also unlocks category-specific attributes (such as material, color, and occasion) that serve as additional search filters for buyers.
Jewelry > Necklaces > Pendant NecklacesEvery listing must have a shipping profile that specifies where the item ships from, available destinations, shipping costs or free shipping, and processing time (how long before the item ships after purchase). Etsy's search algorithm gives a ranking boost to listings that offer free shipping, particularly for US orders over $35. Sellers can create reusable shipping profiles and apply them across multiple listings. Processing time should reflect actual production time for made-to-order items.
Ships from United States, processing time 3-5 business days, free US shipping, international shipping availableEtsy allows one short video per listing (5-15 seconds). Videos autoplay silently in search results on the Etsy app and can significantly increase engagement and conversion rates. Videos should showcase the product in use, demonstrate scale, or highlight unique features like texture, movement, or shimmer that photographs cannot fully capture. Keep videos simple, well-lit, and focused on the product. Videos are optional but strongly recommended, as listings with video tend to see higher conversion rates.
A short clip showing the necklace being worn, catching the light, or demonstrating the clasp mechanismMaterials help buyers filter search results and understand what the product is made from. List all significant materials used in the item, including base materials, finishes, and embellishments. Materials are searchable on Etsy, so include common variations (e.g., both 'sterling silver' and '925 silver'). Accurate material listings also help Etsy match your product to relevant search queries and category filters.
sterling silver, .925 silver, silver chain, gemstoneVariations allow sellers to offer the same product in different options (size, color, material, etc.) within a single listing. Each listing supports up to two variation types, and each type can have multiple options. Variations can have different prices and quantities. Using variations consolidates reviews and favorites under one listing, which improves search ranking and social proof. Each variation combination can have its own SKU for inventory tracking.
Chain Length: 16 inch, 18 inch, 20 inch | Metal: Silver, Gold, Rose GoldEtsy allows sellers to add a personalization field where buyers can input custom text (e.g., names, dates, messages) for made-to-order items. Personalization is a major selling point on Etsy and can significantly increase conversion rates and average order value. When enabled, a text input field appears on the listing page. Sellers can mark personalization as required or optional and provide instructions for what information the buyer should provide.
Please enter the name or initials you'd like engraved (up to 10 characters)CSV flat file, manual entry via Seller Dashboard, JSON (Open API v3)
Etsy supports multiple methods for product data management. Individual listings can be created and edited through the Seller Dashboard web interface. For shops with larger inventories, Etsy supports bulk editing through CSV file uploads, allowing sellers to update titles, descriptions, prices, tags, and quantities across multiple listings simultaneously. For programmatic integrations, the Etsy Open API v3 provides a comprehensive REST API with endpoints for listing creation, updates, inventory management, image uploads, shipping profiles, and order management. The API uses OAuth 2.0 authentication and returns JSON responses. Third-party integrations through Etsy's approved partner ecosystem offer additional tools for inventory syncing, order management, and multi-channel selling.
Etsy's taxonomy is a hierarchical category system designed for handmade, vintage, and craft supply products. The taxonomy includes broad top-level categories such as Jewelry & Accessories, Clothing & Shoes, Home & Living, Art & Collectibles, Craft Supplies & Tools, and more, with each branching into increasingly specific sub-categories. When a seller assigns a listing to a category, Etsy also presents category-specific attributes (e.g., material, color, style, occasion) that serve as search filters for buyers. Etsy periodically updates its taxonomy to reflect new product types and shopping trends, and provides a downloadable taxonomy file for integration purposes.
Detailed requirements for product titles, descriptions, images, and pricing
Avoid these common issues that cause product listings to be rejected or suppressed
Product is mass-produced or does not qualify as handmade, vintage, or craft supply
Etsy's marketplace is exclusively for handmade items, vintage goods (20+ years old), and craft supplies. If your product is handmade, clearly describe your production process in the listing description and consider adding 'About' section content showing your workshop or creation process. For items involving production partners, register each production partner in your shop settings and disclose the partnership. Reselling mass-produced items purchased from wholesalers is not permitted on Etsy.
Listing uses copyrighted or trademarked content without authorization
Remove any copyrighted images, brand names, characters, logos, or trademarked phrases from your listing title, description, tags, and images. This includes fan art, items featuring sports team logos, and products referencing movie or TV characters. If you have authorization to use copyrighted material, keep documentation ready. Etsy actively enforces intellectual property rights and repeat violations can result in permanent shop suspension.
Product images are low quality, stolen from other sellers, or do not show the actual product
Use original photographs of your actual product taken with good lighting and in focus. Stock photos, manufacturer images, or photos taken from other Etsy listings or websites are not allowed and will result in listing deactivation and potential shop suspension. Invest in basic product photography with natural lighting or an inexpensive lightbox. Each image should accurately represent the product the buyer will receive, including color, size, and condition.
Title, tags, or category contain misleading or irrelevant keywords (tag stuffing)
Ensure all keywords in your title and tags accurately describe the product being sold. Do not use trending keywords, competitor brand names, or unrelated terms to attract traffic. Etsy's algorithm detects keyword stuffing and may penalize your listing's search ranking. Remove any tags that describe what the product is NOT or that reference styles, brands, or categories not genuinely applicable to the item.
Listing is for a prohibited item (weapons, drugs, hazardous materials, recalled products)
Review Etsy's Prohibited Items Policy before listing any products. Prohibited items include weapons, drugs and drug paraphernalia, tobacco and e-cigarettes, recalled consumer products, items that promote hate or violence, and certain regulated items (alcohol, live animals, human remains). Some items require additional compliance (e.g., candles need safety warning labels, cosmetics must list ingredients). If your item falls into a gray area, contact Etsy seller support for guidance before listing.
Vintage item is less than 20 years old or age is misrepresented
Etsy defines vintage as items that are at least 20 years old. Verify the age of your vintage items and be prepared to substantiate age claims if challenged. Do not list contemporary items as 'vintage-style' or 'vintage-inspired' in the vintage category — these are handmade items and should be listed in the handmade category instead. Include information about the item's era, maker, and provenance in the description to help buyers understand its history.
Listing description contains external links or references to other sales channels
Remove all URLs linking to personal websites, social media profiles, other marketplace listings, or external payment processors from your listing description. Etsy prohibits directing buyers off-platform for transactions. You may mention your brand name but cannot include clickable links or encourage buyers to find you on other platforms within listing content. Social media links are permitted only in your shop's About section and profile.
Product does not match the listing description, photos, or category
Ensure complete accuracy between your listing content and the actual product. If a buyer receives an item that doesn't match the listing photos, description, or specifications, they can open a case against you. Photograph the actual item being sold (not a similar item or prototype), provide accurate measurements, list the correct materials, and categorize the product appropriately. For made-to-order items, clearly state that photos represent the style and that each piece may have slight variations due to the handmade nature.
Best practices to improve your product listing performance and visibility
Etsy's search algorithm (called 'Etsy Search') uses a combination of query matching and ranking to surface listings. For query matching, Etsy examines listing titles, tags, categories, and attributes. Place your most important keywords at the beginning of your title where they carry the most weight. Use all 13 tag slots with multi-word phrases that complement (not duplicate) your title keywords. Include synonyms, long-tail phrases, and gift-related terms. Review Etsy Stats regularly to see which search terms drive traffic and conversions, then refine your SEO strategy based on real data.
Etsy's Star Seller program rewards shops that consistently deliver excellent customer experiences. To qualify, you need a 95%+ message response rate (within 24 hours), a 95%+ on-time shipping and tracking rate, and at least $300 in sales with 5+ orders over a rolling 3-month period. Star Seller badges increase buyer trust and may provide a search ranking boost. Focus on responding to all messages promptly, shipping orders within your stated processing time, and uploading tracking information for every order.
Listings with more images consistently outperform those with fewer. Use all 10 image slots to show the product from every relevant angle, in context, with scale references, and in different variations. Your first image is your thumbnail in search results, so make it count — clear, well-lit, and compelling at small sizes. Adding a 5-15 second video further increases engagement, particularly on the Etsy mobile app where videos autoplay in search results. Listings with video see measurably higher conversion rates compared to image-only listings.
Etsy Ads (on-platform advertising) places your listings at the top of relevant search results. Start with a small daily budget ($1-5/day) and let campaigns run for at least 30 days before evaluating performance. Focus ad spend on your best-converting listings rather than spreading budget across your entire catalog. For Offsite Ads (Google, Facebook, Instagram, Pinterest), Etsy automatically enrolls shops earning over $10,000/year. Shops under this threshold can opt out. Offsite Ads charge a 15% fee only on attributed sales, so factor this into your pricing for advertised items.
Personalized and customizable items are among the most searched categories on Etsy. Adding a personalization field to your listings can significantly increase conversion rates and average order value, as buyers are often willing to pay a premium for customized items. Clearly explain what can be personalized, provide examples, and set character limits or option restrictions to manage buyer expectations. Listings offering personalization also tend to receive more favorites and shares, which improves their visibility in Etsy's search results.
Etsy's search algorithm considers listing freshness as one of many ranking factors. When a listing is renewed (either automatically upon sale or manually for $0.20), it receives a small, temporary boost in search visibility. Strategically renewing your best-performing listings during peak shopping hours can increase their visibility. However, do not over-renew, as the boost is temporary and the costs add up. Instead, focus on continuously improving listing quality (better photos, refined titles and tags, updated descriptions) as these have a more sustainable impact on search ranking.
Organize your shop into logical sections (e.g., Necklaces, Rings, Earrings, Gift Sets) to help buyers browse your catalog. Create a compelling shop banner, profile photo, and About section that tells your brand story and showcases your creative process. Complete all shop policies (shipping, returns, exchanges, FAQs) to build buyer confidence. Shops with complete profiles and clear policies receive higher trust signals from Etsy's algorithm and convert more effectively than shops with minimal branding.
Reviews are a critical trust factor on Etsy and influence both search ranking and buyer conversion. Include a thank-you note with orders encouraging honest reviews. Respond thoughtfully to all reviews, especially negative ones, as your responses are public and demonstrate your customer service quality. Listings and shops with more positive reviews tend to rank higher in search results. Aim for consistent 5-star service by accurately representing your products, communicating proactively about processing times, and packaging items with care.
Step-by-step guide to getting your products live on this marketplace
Visit etsy.com/sell and click 'Get started' to create your Etsy shop. Choose your shop language, country, and currency. Select a memorable, brandable shop name (up to 20 characters, no spaces). Set up your payment method for receiving deposits (Etsy Payments supports direct deposit in most countries). Complete your shop profile by adding a shop banner, profile photo, and a compelling About section with photos of your workspace, process, and story. Fill in all shop policies including shipping, returns, exchanges, and FAQs. A complete profile with clear policies builds buyer trust and signals quality to Etsy's algorithm.
Before creating listings, prepare all product data including titles (with researched keywords), detailed descriptions, measurements, materials, pricing calculations (factoring in all Etsy fees), and tags. Invest in quality product photography: use natural lighting or an inexpensive lightbox, shoot from multiple angles, include lifestyle and scale reference images, and capture detail shots of texture and craftsmanship. Aim for at least 5-7 images per listing at 2000 x 2000 pixels or higher. If possible, create a short video (5-15 seconds) for each listing. Organize your data in a spreadsheet to streamline the listing creation process.
Create your listings through the Seller Dashboard or via CSV bulk upload. For each listing, craft a keyword-rich title with primary terms front-loaded, select the most specific category, add all 13 tags with relevant multi-word phrases, set the price (including any variation pricing), configure quantities, add all product images with the strongest image first, and write a comprehensive description. Enable personalization if applicable. Set up shipping profiles with realistic processing times. For shops with many products, use Etsy's CSV upload or API integration with your PIM system to manage listings efficiently.
Download our comprehensive guide to mastering Etsy search, creating high-converting listings, and building a sustainable handmade business. Learn the exact strategies that top Etsy sellers use to achieve consistent visibility and sales growth on the world's largest creative marketplace.
Common questions about listing products on Etsy
WisePIM helps you manage product listings across multiple marketplaces from one central platform.