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

Account Settings & Configuration

Each connected eBay account maintains its own independent configuration tab accessible via WC Ebay Connector → Manage Account → Settings.


1. General Settings

The General sub-tab controls core sync behavior, default product statuses, duplicate SKU prevention, image download workflows, and automated background jobs.

General Settings Tab

Product & Catalog Import Settings

SettingDescriptionDefault / Recommended
Choose Default CategoryFallback WooCommerce category assigned when an imported product has no mapped category.First store category
Import Products AsStatus assigned to imported products in WooCommerce (Draft, Publish, or Pending Review).Draft
Product Image Import MethodChoose between In the Background (queues image downloads in Action Scheduler batches to prevent PHP timeouts) or During Product Import (downloads synchronously).In the Background
Create Active Listing OnlyRestricts product imports to listings currently active on eBay. Items that are ended or out of stock on eBay are skipped.Yes
Create Fixed Price ListingChoose whether to import all items or exclusively Fixed Price products (Auction listings import into WooCommerce as Simple products).All Products
Prevent Duplicate Products (Import)Skips importing an eBay listing if a product with an identical SKU already exists in your WooCommerce catalog.Yes
Product Import Only from Global SiteWhen enabled, only listings created on your configured eBay marketplace site (e.g., US, UK, Germany) are imported.Yes
Skip Zero Quantity ProductsPrevents importing products that have zero stock on eBay.No
Import eBay Per Product ShippingPulls eBay item-level shipping costs and profiles into WooCommerce product metadata.No

Background Image Processing

For catalogs with large image galleries or hundreds of items, setting Product Image Import Method to In the Background ensures rapid product catalog import while image files download asynchronously in queue batches.

Product Export & Fulfillment Settings

SettingDescriptionDefault / Recommended
Default Product QuantityFallback stock count applied on eBay if a WooCommerce item has unmanaged or zero stock.1
Pin Code of Item LocationWarehouse or fulfillment postal code used by eBay to calculate shipping transit rates.Your store ZIP/Postal code
Default ConditionFallback eBay condition (New, Used, Refurbished, etc.) applied when exporting products without a per-product override.New
Prevent Duplicate Products (Export)Prevents re-exporting products to eBay if they have already been published.Yes
Default Listing TemplateGlobal visual template applied to exported item descriptions if no per-product template is selected.Default layout

Automatic Mapping & Order Import

SettingDescriptionDefault / Recommended
Enable AutomappingAutomatically assigns imported eBay products into pre-imported WooCommerce categories matching their eBay category name.Yes
Default Order StatusStatus assigned to imported eBay orders in WooCommerce (Processing, Completed, On hold).Processing
Auto Create Missing Order ProductsWhen enabled, if an imported eBay order contains products not yet in WooCommerce, the connector automatically creates them in your catalog so line items and inventory map correctly.Yes
Scheduled Order ImportExecutes an automated background check every 15 minutes to retrieve newly paid eBay orders via Action Scheduler (fmebay_import_order_cron).Yes
Email Address for Sync ReportAdministrative email address that receives synchronization event summaries and error reports.Store Admin Email

Order Sync Prerequisite

All products should ideally be synchronized or mapped before order imports occur. If an unmapped item is purchased on eBay, enabling Auto Create Missing Order Products ensures the order imports without interruption.


2. Shipping & Listing Policies

The Shipping/Listing sub-tab configures dispatch rules, domestic/international carriers, and per-product shipping settings.

Shipping Settings Tab

  • eBay Per-Product Shipping: Toggle whether WooCommerce calculates shipping using eBay product shipping metadata.
  • Dispatch / Handling Time: Number of business days before the order is marked dispatched (1, 2, 3, 5, 10 days).
  • Shipping Service Type: Choose Flat, Calculated, or Freight.
  • Domestic & International Shipping Services: Select primary and secondary carriers (e.g., USPS Priority Mail, FedEx, UPS, DHL).
  • Free Shipping & Local Pickup: Enable checkboxes to offer free domestic delivery or in-store collection options.

3. Return Policy Settings

Configure the formal return policies required by eBay for merchant listings.

Return Settings Tab

  • Returns Accepted: Choose ReturnsAccepted or ReturnsNotAccepted.
  • Return Period: Select standard return eligibility windows (14 Days, 30 Days, 60 Days).
  • Refund Method: Specify how returns are reimbursed (MoneyBack, Exchange, Replacement).
  • Shipping Cost Paid By: Specify whether Buyer or Seller covers return freight fees.
  • Return Policy Description: Detailed policy text visible to eBay shoppers outlining return conditions, packaging rules, and restocking guidelines.

4. Price Rules

The Price Rules sub-tab enables automatic markups or discounts on imported or exported products.

Price Rules Tab

  • Rule Application: Apply to Import (eBay → WooCommerce), Export (WooCommerce → eBay), or both.
  • Calculation Type:
    • Percentage: Add or subtract a percentage markup (e.g., +15% to offset eBay final value fees).
    • Fixed Amount: Add or subtract a flat monetary sum (e.g., +$5.00).
  • Price Range Bounds: Restrict rules to products within specific minimum and maximum price thresholds.

5. Real-Time Sync Settings

The Real Time Sync sub-tab (sub-tab=sync_sub_tab) regulates live bidirectional events between WooCommerce and eBay:

Real Time Sync Settings Tab

  • Bidirectional Event Toggles: Independent master switches for eBay to WooCommerce Real Time Sync and WooCommerce to eBay Real Time Sync.
  • Real-Time Order Import: Toggle automatic order creation when eBay transmits an AuctionCheckoutComplete webhook notification.
  • Granular Field-Level Update Selection: Choose exactly which product attributes synchronize when an item is revised, protecting customized descriptions or pricing:
    • eBay → WooCommerce: Checkbox selection for Title, Price, Quantity, Description, Image, and Weight.
    • WooCommerce → eBay: Checkbox selection for Title, StartPrice, Quantity, and Description.
  • End Item & Trashed Product Lifecycle Automation:
    • When an eBay Listing Ends (ebay_to_woo_item_end): Choose whether the corresponding WooCommerce product is moved to Trash, set to Draft, or left unchanged.
    • When a WooCommerce Product is Trashed (woo_to_ebay_item_end): Automatically dispatches an EndItem API call to close the active eBay listing and prevent sales of discontinued inventory.
  • Admin Email Alerts: Enable email notifications to receive alerts when specific eBay sync events occur.

6. eBay Notifications Event Rules

The Ebay Notifications sub-tab (sub-tab=ebay_notification_sub_tab) provides a dedicated monitoring table for all marketplace webhook events supported by the connector's notification listener:

eBay Notifications Event Rules Tab

eBay EventDescriptionAction Taken
ItemListedTriggered when a new item is published on eBay.Logs event or creates product if real-time catalog sync is active.
ItemRevisedTriggered when listing details change on eBay.Updates mapped WooCommerce product fields selected under sync settings.
ItemSoldTriggered when an item sells on eBay.Decrements local WooCommerce catalog stock in real time.
ItemClosedTriggered when an eBay listing ends or is cancelled.Applies configured end-item rule (Trash, Draft, or None).
FixedPriceTransactionTriggered on fixed-price sales.Ingests transaction and reserves store stock.
AuctionCheckoutCompleteTriggered when a buyer completes payment.Triggers instant real-time order import when enabled.

7. Exclude Product Sync

The Exclude Product Sync sub-tab (sub-tab=exclude_product_sub_tab) prevents designated catalog items from being synchronized between WooCommerce and eBay.

Exclude Product Sync Tab

  • Import Exclusion List: Enter specific eBay Item IDs that should never be pulled into WooCommerce.
  • Export Exclusion List: Select WooCommerce products that must remain exclusive to your WordPress store and never be listed on eBay.

Next Steps

  • Learn how to structure and map catalog taxonomies in Category Mapping.
  • Explore catalog import management in Product Listing.
Last Updated: 10/22/26, 8:28 PM
Next
Category Management & Mapping