WooCommerce eBay Connector Help Center
Fast answers, step-by-step setup recipes, error diagnostics, and marketplace constraints for WooCommerce eBay Connector.
What Are You Trying to Do?
Jump directly to common tasks, step-by-step walkthroughs, and setup recipes:
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.
Fulfillment & Operations Team
Manage marketplace sales, order status transitions, tracking numbers, and live stock.
Technical & System Administrator
Maintain API tokens, monitor call thresholds, inspect queues, and review system logs.
Browse Help Topics
Explore all merchant guides, configuration tutorials, and architectural overviews:
Requirements and Compatibility
| Component | Minimum Supported | Recommended / Tested | Notes |
|---|---|---|---|
| WordPress | 6.0 | 6.5 – 6.8+ | Standard single-site and WordPress Multisite supported. |
| WooCommerce | 8.0 | 9.0 – 9.8+ | Compatible with Cart/Checkout Blocks. |
| PHP | 7.4 | 8.1 – 8.3+ | Compatible with modern PHP 8 strict types and JIT. |
| Order Storage | Post-based (wp_posts) | HPOS (Custom Order Tables) | Compatible with HPOS; renders native Order Source column. |
| PHP Extensions | curl, json, openssl | curl, mbstring, gd / imagick | php-soap is optional in v5.0.0; native HTTP fallback handles all calls. |
| eBay APIs | Trading API (REST/XML) | Latest eBay API schema | Supports production marketplaces and eBay Sandbox. |
| SSL / HTTPS | TLS 1.2+ required | TLS 1.3 | eBay 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 Parameter | eBay Platform Limit | Plugin Behavior & Solution |
|---|---|---|
| Product Title | Max 80 characters | If 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 Images | Min 500px, max 12 images | eBay recommends 1000px+ for zoom. Images must be served over public HTTPS. The connector exports up to 12 gallery images. |
| Category Selection | Leaf categories only | eBay rejects items mapped to top-level or branch categories. Use the Category Mapper to drill down to terminal leaf nodes. |
| Daily API Quota | 5,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 & Country | ISO Country Code & Postal Code | Configured in WC Ebay Connector → Manage Account → Settings → Shipping Settings (Default Country Code Type) and Settings → General Settings (Pin code of item location). |
| Transaction Fees / Markups | Variable 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 Limitation | Root Cause | Official Workaround |
|---|---|---|
| Parent Categories Rejected | eBay 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 Limit | eBay 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 Firewalls | eBay 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 Boundaries | Standard 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 Collisions | WooCommerce 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 String | Why It Occurs | Fast Resolution Steps |
|---|---|---|
Product category is not mapped with Ebay category | The 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 missing | The 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 category | The 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 expired | The 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 detected | A 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 HTTPS | The 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 Specifics | Category Mapping & Listing Workspace |
| Sub-category / Terminal Category | Leaf Category | Category Mapping |
| Shipping Methods (Flat rate, Free shipping) | Shipping Business Policy | Account Defaults |
| Store Refund & Return Policy | Return Business Policy | Return Settings |
| Store Payment Gateways | Payment Business Policy | General Settings |
| Product Price Markup / Margin | Price Rules | Price Rules Configuration |
| Vehicle Fitment / Compatibility | eBay Item Compatibility (ePID) | eBay Compatibility Extension |
| Order Origin Flag | Order Source Column | Order 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.
Support portal: webkul.uvdesk.com · Email: [email protected]
