WooCommerce eBay Connector DocumentationWooCommerce eBay Connector Documentation
  • eBay Connector

    • Introduction
    • Features
    • Comparison
    • Help Center
    • Installation
    • eBay Account Setup
    • Configuration
    • Category Mapping
    • Product Listing
    • Export Product
    • Listing Templates
    • Order Management
    • FAQs
    • Support
  • eBay Item Compatibility for WooCommerce
  • WCFM Marketplace Shopify Connector
  • WooCommerce Shopify Connector
  • WooCommerce Marketplace Shopify Connector
  • WooCommerce Icecat Extension
  • WooCommerce QuickBook Connector
View Demo
Buy Now
  • eBay Connector

    • Introduction
    • Features
    • Comparison
    • Help Center
    • Installation
    • eBay Account Setup
    • Configuration
    • Category Mapping
    • Product Listing
    • Export Product
    • Listing Templates
    • Order Management
    • FAQs
    • Support
  • eBay Item Compatibility for WooCommerce
  • WCFM Marketplace Shopify Connector
  • WooCommerce Shopify Connector
  • WooCommerce Marketplace Shopify Connector
  • WooCommerce Icecat Extension
  • WooCommerce QuickBook Connector
View Demo
Buy Now
  • Getting Started

    • Overview & Architecture
    • Features
    • Comparison
    • Installation & Requirements
    • eBay Account Setup & Developer Credentials
  • Configuration & Settings

    • Account Settings & Configuration
    • Category Management & Mapping
  • Product & Listing Management

    • Product Listing & Import Management
    • Export Products & Edit eBay Listing Workspace
    • Visual Listing Template Builder
  • Orders & Synchronization

    • Order Management & Real-Time Synchronization
  • Help & FAQ

    • eBay Connector Help Center
    • FAQs & Troubleshooting
    • Support & Assistance

WooCommerce eBay Connector Help Center

Fast answers, step-by-step setup recipes, error diagnostics, and marketplace constraints for WooCommerce eBay Connector.

Popular:Category Not MappedItem Country CodeItem SpecificsAPI LimitsProduct ExportHPOS OrdersPrice Rules

What Are You Trying to Do?

Jump directly to common tasks, step-by-step walkthroughs, and setup recipes:

Connect eBay account for the first timeMap store categories to eBay leaf categoriesExport products to eBayResolve missing item specificsDesign custom HTML listing templatesSet price markups to offset eBay feesAutomate order import & stock syncFix an error message or API issue

I Need Help As…

Role-based navigation tailored for your daily responsibilities:

Store Owner & Catalog Manager

Configure stores, map categories, set pricing margins, and export items to eBay.

Installation and activationConnect multiple eBay accountsCategory and store category mappingPrice markup and margin rulesBatch and individual product exportVisual description template builderExclude specific products from sync

Fulfillment & Operations Team

Manage marketplace sales, order status transitions, tracking numbers, and live stock.

Orders management table & audit logAutomated 15-minute order cronManual order fetch by date or IDHPOS Order Source column & badgesOrder processing & status workflowReal-time inventory & stock synchronizationAuto-create missing products during import

Technical & System Administrator

Maintain API tokens, monitor call thresholds, inspect queues, and review system logs.

System prerequisites & PHP requirementsOAuth 2.0 user token & account consentTrading API rate limits & auto-pauseSandbox mode testing environmentAction Scheduler background queuesWooCommerce debug logs (fmebay-*)Submit a technical support ticket

Browse Help Topics

Explore all merchant guides, configuration tutorials, and architectural overviews:

Getting Started & OverviewPlugin introduction, architectural workflow, and key system concepts.Features InventoryComplete inventory of sync capabilities, multi-account hubs, and template tools.Installation & RequirementsServer requirements, module upload, licensing, and update setup.eBay Account Setup & OAuthConnecting eBay accounts, API credentials, Sandbox mode, and rate monitors.Configuration & SettingsGlobal defaults, price rules, sync intervals, and exclusion blacklists.Category & Specifics MappingMap store categories to eBay leaf nodes and configure category attributes.Product Import from eBayImport active eBay listings into WooCommerce with stock, images, and variations.Export Product & WorkspaceBatch export queues, listing previews, and per-product listing customization.Visual Listing TemplatesDrag-and-drop HTML description builder with live compliance validation.Orders & Stock ControlReal-time inventory deduction, HPOS order source badges, and cron sync.Competitive ComparisonHead-to-head comparison against competing marketplace integrations.Support & ResourcesPre-ticket diagnostics, Webkul HelpDesk tickets, live demos, and store links.

Requirements and Compatibility

ComponentMinimum SupportedRecommended / TestedNotes
WordPress6.06.5 – 6.8+Standard single-site and WordPress Multisite supported.
WooCommerce8.09.0 – 9.8+Compatible with Cart/Checkout Blocks.
PHP7.48.1 – 8.3+Compatible with modern PHP 8 strict types and JIT.
Order StoragePost-based (wp_posts)HPOS (Custom Order Tables)Compatible with HPOS; renders native Order Source column.
PHP Extensionscurl, json, opensslcurl, mbstring, gd / imagickphp-soap is optional in v5.0.0; native HTTP fallback handles all calls.
eBay APIsTrading API (REST/XML)Latest eBay API schemaSupports production marketplaces and eBay Sandbox.
SSL / HTTPSTLS 1.2+ requiredTLS 1.3eBay strictly requires public HTTPS image URLs and webhook endpoints.

eBay Listing Rules & Limits at a Glance

Marketplaces enforce strict listing rules. Keeping these limits in mind prevents export failures before queueing items:

Listing ParametereBay Platform LimitPlugin Behavior & Solution
Product TitleMax 80 charactersIf your WooCommerce product title is longer, use the Edit eBay Listing workspace to define an optimized 80-character marketplace title without altering your WooCommerce product title.
Product ImagesMin 500px, max 12 imageseBay recommends 1000px+ for zoom. Images must be served over public HTTPS. The connector exports up to 12 gallery images.
Category SelectionLeaf categories onlyeBay rejects items mapped to top-level or branch categories. Use the Category Mapper to drill down to terminal leaf nodes.
Daily API Quota5,000 calls / 24 hours (default Trading API quota)The connector actively monitors remaining API calls. If the limit boundary is reached, sync tasks pause automatically to protect your account.
Item Location & CountryISO Country Code & Postal CodeConfigured in WC Ebay Connector → Manage Account → Settings → Shipping Settings (Default Country Code Type) and Settings → General Settings (Pin code of item location).
Transaction Fees / MarkupsVariable eBay category fees (8% – 15%)Configure Price Rules to apply percentage or fixed markups to offset marketplace selling fees automatically.

Frequently Asked Questions

How does the connector prevent duplicate product listings on eBay?

The connector links exported products to their corresponding eBay Item ID so that subsequent export actions update the existing listing rather than creating a duplicate:

  • Unique Catalog SKUs: Ensure each WooCommerce product has a distinct, valid SKU.
  • Duplicate SKU Guard: In WC Ebay Connector → Manage Account → Settings → General Settings, enable the Prevent Duplicate Product setting so imported products matching existing store SKUs are not duplicated.
  • Automatic Listing Tracking: Once an item has been exported, WooCommerce stores its assigned eBay Item ID. Re-queueing that product automatically updates the live eBay listing rather than creating a new one.
Why do I see "Product category is not mapped with Ebay category"?

eBay requires every listing to be assigned to an active eBay leaf category (a bottom-level category that has no child sub-categories). If the product's assigned WooCommerce category has not yet been mapped, or was mapped to a parent category, eBay rejects the export.

Solution: Navigate to WC Ebay Connector → Manage Account → Category Mapping, click Map Category, select your WooCommerce category, drill down to the terminal eBay leaf node, and save.

What causes "Input data for tag <Item.Country> is invalid or missing"?

eBay requires an ISO country code and item postal location for all exported listings. This error appears when the country code has not been selected in account settings.

Solution: Navigate to WC Ebay Connector → Manage Account → Settings → Shipping Settings. Under the Listing Options section, select your country in the Default Country Code Type dropdown. Also verify that Pin code of item location is configured under Settings → General Settings.

Can I connect multiple eBay seller accounts?

Yes. WooCommerce eBay Connector includes a multi-account hub. You can link multiple eBay accounts across different international marketplaces (such as US, UK, Australia, Germany) and manage their individual settings, category mappings, and order queues independently from a single WordPress dashboard.

Does the connector require the PHP SOAP extension?

No. In version 5.0.0, the connector includes a native HTTP transport fallback. While servers with php-soap continue to use it seamlessly, cloud environments and shared hosts without SoapClient run all eBay Trading API calls via standard cURL HTTP transport.

Will imported eBay orders trigger customer emails from WooCommerce?

No. The connector automatically suppresses standard WooCommerce buyer transactional emails (such as New Order, Processing Order, and Completed Order) for orders imported from eBay. This prevents buyers from receiving confusing duplicate notifications, as eBay communicates transactional updates directly.

Is the connector compatible with WooCommerce High-Performance Order Storage (HPOS)?

Yes. WooCommerce eBay Connector is compatible with WooCommerce High-Performance Order Storage (HPOS / Custom Order Tables) as well as legacy post-based storage. It registers a native Order Source column across the main Orders list (WooCommerce → Orders) with clear badges indicating whether each order originated from Ebay or WooCommerce.

Can I set custom prices for eBay without altering my WooCommerce prices?

Yes. You have two flexible methods:

  • Automated Price Rules: Define percentage or fixed markups (e.g., +12% to cover eBay final value fees) under WC Ebay Connector → Settings → Price Rules.
  • Per-Product Price Overrides: Enter a specific marketplace price for any item in the Edit eBay Listing workspace prior to export.
What happens when my eBay Auth Token expires?

When an eBay user token reaches its expiration date, API requests will return an authorization error. Navigate to WC Ebay Connector → Account List, click Edit on the account, generate a fresh token from your eBay Developer Account, paste it into the credentials field, and click Verify Credentials.

Where can I find connector error logs and Action Scheduler tasks?

The connector logs events and background tasks across two native tools:

  • Scheduled Queues: Go to Tools → Scheduled Actions (or WooCommerce → Status → Scheduled Actions) and filter by group fmebay.
  • System Logs: Go to WooCommerce → Status → Logs and select the latest fmebay-* log file from the dropdown to review API payloads, HTTP status codes, and trace details.

Known Marketplace Limitations & Official Workarounds

Marketplace integrations operate within eBay's API specifications. The table below lists these platform rules and the connector's built-in workarounds:

Platform LimitationRoot CauseOfficial Workaround
Parent Categories RejectedeBay will not accept product listings mapped to non-leaf categories.Use the interactive Category Mapper to drill down through parent levels until you reach an active leaf node (level 3–5).
80-Character Title LimiteBay strictly caps listing titles at 80 characters.Open the Edit eBay Listing workspace before export and craft a concise, keyword-rich 80-character marketplace title without altering your WooCommerce product title.
Image URLs Behind FirewallseBay EPS (eBay Picture Services) must fetch images directly over public HTTPS.Ensure staging sites or password-protected stores allow public HTTP access for /wp-content/uploads/, or export from a live environment.
Trading API Call BoundariesStandard developer accounts receive 5,000 API calls per 24 hours.The connector features real-time quota tracking that automatically pauses export and import queues as boundaries approach, resuming once calls reset.
Transactional Email CollisionsWooCommerce default templates would notify eBay buyers twice.The connector hooks directly into WooCommerce email dispatchers and automatically suppresses customer notifications on imported eBay sales.

Common Error Code Diagnostic Directory

Search or browse literal error strings returned by the eBay API or export queue:

Exact Error StringWhy It OccursFast Resolution Steps
Product category is not mapped with Ebay categoryThe product's WooCommerce category has not been mapped to an active eBay leaf category.1. Go to Category Mapping.
2. Click Map Category.
3. Map your store category to the target eBay leaf node and save.
4. Re-queue the product for export.
Input data for tag <Item.Country> is invalid or missingThe listing payload is missing the country code or item postal location from account settings.1. Navigate to WC Ebay Connector → Manage Account → Settings → Shipping Settings.
2. Under the Listing Options section, select your country from Default Country Code Type.
3. Go to Settings → General Settings and ensure Pin code of item location is filled.
4. Re-export the product.
Required item specifics missing for categoryThe selected eBay category mandates attributes (e.g., Brand, MPN, Size) that are empty.1. Open Export Products and click eBay Setup on the product row.
2. Switch to the Item Specifics tab.
3. Enter required values or click Add Specific.
4. Save and export.
eBay API error: Invalid credentials or token expiredThe eBay Auth Token has expired or developer keys are invalid.1. Go to Account List → Edit Account.
2. Generate a fresh user token from the eBay Developer Portal.
3. Paste token and click Verify Credentials.
4. Save changes.
Duplicate SKU detectedA product with the same SKU already exists in WooCommerce.1. Ensure unique SKUs across your catalog.
2. Enable Prevent Duplicate Product in Settings → General Settings.
3. Re-queue the sync task.
Image URL is not accessible over HTTPSThe product image is hosted on HTTP or is blocked by basic auth / firewall.1. Verify your WordPress site has an active SSL certificate.
2. Confirm image URL opens in an incognito browser without login.
3. Re-queue the export action.

Search Tips & Marketplace Vocabulary Bridge

The documentation bridges terminology between WooCommerce and eBay. Searching either phrase will surface the relevant guides:

If You Call It… (WooCommerce Store)eBay Calls It…Where It Is Configured
Product Attributes (Brand, Material, Size)Item SpecificsCategory Mapping & Listing Workspace
Sub-category / Terminal CategoryLeaf CategoryCategory Mapping
Shipping Methods (Flat rate, Free shipping)Shipping Business PolicyAccount Defaults
Store Refund & Return PolicyReturn Business PolicyReturn Settings
Store Payment GatewaysPayment Business PolicyGeneral Settings
Product Price Markup / MarginPrice RulesPrice Rules Configuration
Vehicle Fitment / CompatibilityeBay Item Compatibility (ePID)eBay Compatibility Extension
Order Origin FlagOrder Source ColumnOrder Management

Still Need Help?

Talk to the Webkul Support Team

If the guides and diagnostic tables above did not resolve your issue, our marketplace integration engineering team is ready to assist.

Submit a Ticket ↗ Explore Live Demo ↗ Email Support

Support portal: webkul.uvdesk.com · Email: [email protected]

Last Updated: 10/22/26, 8:13 PM
Next
FAQs & Troubleshooting