Quick Start Guide - WP-Lister for eBay 4.0

Before You Start

You'll need:

• WordPress 6.0+ with WooCommerce 8.0+ installed
• PHP 8.1 or higher
• An eBay seller account (any level)
• At least one WooCommerce product ready to list
• Your WP-Lister license key (from your purchase email)

Step 1: Install & Activate

1. Download the plugin ZIP from your WPLab account
2. Go to Plugins → Add New → Upload Plugin
3. Upload the ZIP and click Install Now
4. Click Activate Plugin
5. Navigate to eBay → Settings → License and enter your license key

Tip: New to WP-Lister? The Setup Wizard launches automatically and guides you through steps 2-4 below. See our Setup Wizard Walkthrough for details.

Step 2: Connect to eBay

1. Go to eBay → Settings → Accounts
2. Click Add eBay Account
3. Select your eBay site (US, UK, DE, AU, etc.)
4. Choose Production (live eBay) or Sandbox (testing)
5. Click Connect – you'll be redirected to eBay
6. Sign in and authorize WP-Lister
7. You'll return to WordPress with a connected account

Important: Make sure pop-ups are allowed for your site. If the authorization window doesn't open, check your browser's pop-up blocker.

Tip: If you get a token error later, see our Re-Authorization Guide.

Step 3: Create a Listing Profile

Listing profiles define how your products appear on eBay – categories, shipping, returns, and templates.

1. Go to eBay → Profiles
2. Click Add New Profile
3. Set a name (e.g., "Standard Listings")
4. Configure these essentials:

Category:

• Click Select Category and browse to your eBay category
• Or use Auto-Match if your products have GTINs/UPCs

Listing Type:

• Fixed Price – Most common, set your price and sell immediately
• Auction – For collectibles or price discovery

Shipping:

• Select a shipping service or use eBay's calculated shipping
• Set handling time (1-3 business days is typical)
• Recommended: Use eBay Business Policies for easier management across listings

Returns:

• Enable returns (eBay favors listings with returns accepted)
• Set return window (30 days is standard)

Item Specifics:

• Map required attributes like Brand, Size, Color to your WooCommerce product attributes
• Different categories require different specifics – check the Category tab for requirements

Template:

• Use the default template to start, or create a custom one with Template Editor V2

5. Click Save Profile

Step 4: List Your First Product

1. Go to eBay → Listings
2. Click Prepare from WooCommerce
3. Select one or more products
4. Choose your listing profile
5. Click Prepare Selected Items

Your products now appear in the Listings table with status "Prepared".

6. Verify first: Select the listing and click Verify to check for errors before publishing
7. Review any errors – click the error badge to see details and suggested fixes
8. Once verified successfully, select the listing(s) and click Publish to eBay

That's it! Your product is now live on eBay.

Step 5: Enable Inventory Sync (Critical)

Keep your stock levels synchronized between WooCommerce and eBay to avoid overselling:

1. Go to eBay → Settings → Sync
2. Enable Sync inventory when WooCommerce stock changes
3. Enable Reduce WooCommerce stock when eBay item sells
4. Set your preferred sync frequency

Warning: Without inventory sync enabled, selling the same item on both WooCommerce and eBay can result in overselling. Enable this immediately after your first listing.

Now when you sell on eBay, your WooCommerce stock updates automatically, and vice versa.

What's Next?

Customize your listings:

• Template Editor V2 Guide – Create professional branded templates

List more efficiently:

• Use Bulk Actions to prepare and publish multiple products at once
• Set up multiple profiles for different product categories

Expand to more markets:

• Multiple eBay Accounts & Sites – Sell on eBay UK, DE, AU, etc.

Get help:

• Use the AI Assistant (eBay → AI Assistant) for instant answers
• Contact support for account-specific issues

Common First-Time Issues

"UPC/EAN is missing" error:
eBay requires product identifiers (GTINs) for most categories. Add UPC/EAN/ISBN to your WooCommerce products under Product Data → Inventory. For handmade, custom, or vintage items, select "Does not apply" in the listing profile.

"Item specifics required" error:
eBay categories require certain attributes (Brand, Size, Color, MPN, etc.). Go to your listing profile → Item Specifics tab and map these to your WooCommerce product attributes. The required fields are marked with an asterisk.

Authorization/token errors:
eBay tokens expire periodically and need refreshing. Go to eBay → Settings → Accounts and click "Reauthorize" next to your account. See our Re-Authorization Guide.

Stock not syncing:
Verify sync is enabled in eBay → Settings → Sync. Check that your WooCommerce products have "Manage stock" enabled. If issues persist, see our Inventory Sync Troubleshooting Guide.

Images not uploading:
eBay requires images to be at least 500x500 pixels and publicly accessible. If your images are behind a login or CDN with restrictions, eBay cannot fetch them. Check that your image URLs are accessible in an incognito browser window.