My eBay Listings Pro
Frequently Asked Questions
Everything you need to know about the plugin,
licensing, setup and earning commission.
⭐ All Questions
🔑 Licensing
⚙️ Setup & API
💰 Affiliate & EPN
🔌 Plugin Features
🛠 Troubleshooting
Licensing
What do I get with a licence?
A licence gives you full access to all plugin features, automatic updates delivered directly to your WordPress dashboard, and email support. All three plans — Personal, Business and Agency — include every feature. The only difference is the number of WordPress sites you can activate the licence on.
How many sites can I use the plugin on?
Personal — 1 WordPress site.
Business — up to 5 WordPress sites.
Agency — unlimited WordPress sites, no cap.
Each site requires a licence activation. You can manage your activations from your Freemius account portal at any time.
Business — up to 5 WordPress sites.
Agency — unlimited WordPress sites, no cap.
Each site requires a licence activation. You can manage your activations from your Freemius account portal at any time.
How do I activate my licence?
After purchasing, you will receive a licence key by email. Install the plugin on your WordPress site, then go to Settings → My eBay Listings Pro → Account. Enter your licence key and click Activate Licence. The plugin will connect to Freemius and confirm activation instantly.
What happens when my licence expires?
Annual licences renew automatically with 30 days email notice beforehand. If a licence expires without renewal, the plugin stops displaying eBay listings on the frontend — shortcodes return nothing. Your WordPress admin, all settings and all data remain completely untouched. Renewing restores full functionality immediately.
Can I upgrade my plan later?
Yes — you can upgrade from Personal to Business or Agency at any time through your Freemius account portal. You only pay the difference on a pro-rated basis for the remaining licence period. Downgrades are also available at renewal.
Is there a refund policy?
30-day money back guarantee, no questions asked. Contact support@exceedwebservices.com within 30 days of purchase for a full refund. After 30 days refunds are not available.
Do I need to re-enter my licence key when the plugin updates?
No — as long as you update the plugin through the standard WordPress update mechanism (the "Update Available" notification in your dashboard), your licence remains active and no re-entry is needed. Only a completely fresh install on a new site requires a licence key entry.
Setup & API
What accounts do I need before installing?
Two free accounts: an eBay Developer account at developer.ebay.com (for the Browse API Client ID and Client Secret) and an eBay Partner Network account at partnernetwork.ebay.co.uk (for your Campaign ID). See the full Setup Guide for step-by-step instructions.
Do I need Sandbox or Production API keys?
You need Production keys only. Sandbox keys are for eBay's test environment and will not return real listings on a live site. In your eBay Developer account, look for the Production Keyset section — copy the App ID (Client ID) and Cert ID (Client Secret) from there.
Test Connection says it failed — what do I do?
The most common causes are:
1. Wrong keys — double-check you are using Production keys, not Sandbox.
2. Copy/paste error — re-copy the keys directly from the eBay Developer portal. Avoid spaces at the start or end.
3. Keys not yet active — new eBay Developer accounts can take a few minutes for Production keys to become active.
4. Server firewall — some hosting providers block outbound API calls. Contact your host and ask them to whitelist
1. Wrong keys — double-check you are using Production keys, not Sandbox.
2. Copy/paste error — re-copy the keys directly from the eBay Developer portal. Avoid spaces at the start or end.
3. Keys not yet active — new eBay Developer accounts can take a few minutes for Production keys to become active.
4. Server firewall — some hosting providers block outbound API calls. Contact your host and ask them to whitelist
api.ebay.com.
Does the plugin work with any WordPress theme?
Yes. The plugin is fully self-contained — it loads its own CSS and JavaScript and does not depend on your theme. It works with any WordPress theme including Elementor, Divi, Astra, GeneratePress, WooCommerce themes and any page builder. All colours are configurable from the admin panel to match your branding.
What are the minimum requirements?
WordPress 5.8 or higher, PHP 7.4 or higher, and an active internet connection so the plugin can reach the eBay API. No jQuery required — the plugin uses pure vanilla JavaScript. No external frameworks or dependencies beyond your WordPress installation.
Affiliate & EPN
Do I keep 100% of my eBay affiliate commission?
Yes — every click and sale is tracked directly to your own eBay Partner Network account. We take absolutely nothing from your affiliate earnings. The licence fee is the only payment you make to us. This is the single biggest difference between My eBay Listings Pro and other eBay plugins — some competitors take 50% of your commission or use their own EPN account instead of yours.
What is SmartLinks and should I enable it?
SmartLinks automatically rewrites every eBay link anywhere on your site to include your EPN Campaign ID — including links in old blog posts, product pages and anywhere else. This means every eBay link you have ever published earns you affiliate commission with no manual editing required. Enable it in Settings → Display → API & Performance. It is strongly recommended for any affiliate site.
How much commission does eBay Partner Network pay?
EPN commission rates vary by category, typically between 1% and 4% of the sale value on qualifying purchases. eBay publishes their current rate card in your EPN account dashboard. Commission is earned when a visitor clicks a listing and completes a qualifying purchase on eBay within the cookie window (typically 24 hours for Buy It Now, longer for auctions).
Does the plugin work without a Campaign ID?
Yes — the plugin will display listings normally without a Campaign ID. However no affiliate commission will be tracked. Visitors clicking listings will go to eBay but their purchases will not be attributed to you. Always add your Campaign ID before publishing any pages with the plugin.
Plugin Features
What shortcodes are available?
[ebay_listings] — full search panel with filters and results.[ebay_search query="x" columns="4" rows="3"] — static pre-set results grid, no search form.[ebay_item id="xxx"] — display a single eBay item by ID.[ebay_seller username="xxx"] — seller profile card with live eBay data.[ebay_seller username="xxx" logo="https://..."] — seller card with custom logo.[ebay_seller username="xxx" show_link="0"] — seller card with links hidden.[mel_version] — outputs the current plugin version number.Common attributes for [ebay_listings] and [ebay_search]:
seller — lock results to a specific eBay seller.query — pre-set a search keyword.columns — number of card columns (1–6). Default: 4.rows — number of rows. Default: 3.category — restrict to an eBay category ID.condition — NEW, USED, VERY_GOOD, GOOD, ACCEPTABLE, FOR_PARTS.min_price / max_price — filter by price range.sort — newlyListed, endingSoonest, price, -price.Use the Shortcode Builder in plugin settings to generate shortcodes visually without writing any code.
Which eBay marketplaces are supported?
15 eBay marketplaces: UK, US, Germany, Australia, France, Italy, Spain, Canada, Austria, Netherlands, Belgium, Switzerland, Ireland, Singapore and India. The active marketplace is set in admin and can also be switched by visitors using the Marketplace Switcher dropdown on the search panel. Timezone-based geotargeting automatically sets the correct marketplace for each visitor.
Can I lock certain filters so visitors can't change them?
Yes — any filter can be locked by setting it as a shortcode attribute. Locked filters display as disabled fields with a padlock icon so visitors can see the active filter but cannot change it. For example,
[ebay_listings condition="NEW"] locks the condition filter to New only. This is useful for niche sites where you want to restrict the search scope.Does the plugin affect my site's SEO?
Positively. Every listing card outputs Schema.org Product and Offer structured data automatically. Google can read this as rich results — showing prices, condition and availability directly in search results. This is a significant SEO advantage over plain eBay links or iframes. The plugin also uses lazy image loading and no render-blocking scripts.
How do I use the Seller Profile Card shortcode?
The seller card displays a live profile for any eBay seller. Basic usage:
All available attributes:
The card automatically pulls live data from eBay — feedback score, positive percentage, active listing count, location, Top Rated badge and Business/Individual badge. A Gutenberg block version is also available with all the same options in the inspector panel.
[ebay_seller username="yoursellerid"]All available attributes:
username — the eBay seller username (required).logo — URL of a custom logo image to replace the default initial avatar.show_link — set to 0 to hide the clickable username and View eBay Shop button. Default is 1.The card automatically pulls live data from eBay — feedback score, positive percentage, active listing count, location, Top Rated badge and Business/Individual badge. A Gutenberg block version is also available with all the same options in the inspector panel.
Can I show the seller card and search panel together on the same page?
Yes — this is one of the most powerful features. Paste both shortcodes on the same page and the seller card sits flush directly above the search panel with no gap, creating a professional branded shop experience:
You have three layout options:
Search panel only — use
Seller card only — use
Both together — paste
Adding
[ebay_seller username="yoursellerid" logo="https://yoursite.com/logo.png"][ebay_listings seller="yoursellerid"]You have three layout options:
Search panel only — use
[ebay_listings] on its own.Seller card only — use
[ebay_seller] on its own anywhere on your site.Both together — paste
[ebay_seller] immediately above [ebay_listings] and they snap together seamlessly.Adding
seller="yoursellerid" to the [ebay_listings] shortcode locks all search results to your store only — perfect for eBay sellers showcasing their own shop on their WordPress site.
Can I display my own eBay store listings only?
Yes — add your eBay seller username to the shortcode:
[ebay_listings seller="yoursellerid"]. This locks all results to your store only. Visitors can still search within your listings. You can also combine seller with a pre-set query: [ebay_listings seller="yoursellerid" query="laptops"].What is the Category Chooser and how do I use it?
The Category Chooser is a live category browser built into the Shortcode Builder in Settings → My eBay Listings Pro → Shortcode Builder. Click Browse Categories next to the Category ID field to open a modal that fetches eBay's full live category tree. Drill down through subcategories using the breadcrumb navigation, click any category to select it, and the category ID inserts automatically into the field. Categories are cached for 24 hours. Use a category ID to restrict search results to a specific product type — for example, category 9800 limits results to DVDs only.
How does geotargeting work?
When a visitor lands on a page with the Marketplace Switcher enabled, the plugin reads their browser timezone using
Intl.DateTimeFormat() — no IP lookup, no external API call, no cost — and automatically sets the correct eBay marketplace. For example, a visitor with a German timezone gets EBAY-DE set automatically. 27 timezones are mapped across all 15 supported marketplaces. If a visitor manually changes the marketplace dropdown, their choice is preserved and the auto-detection will not override it again.What is the Marketplace Switcher?
The Marketplace Switcher is an optional visitor-facing dropdown on the search panel that lets visitors switch between all 15 eBay marketplaces in real time. Enable it in Settings → Display → Card Elements. When a visitor selects a different marketplace, results update immediately to that market — prices, currency and listings all reflect the chosen country. The visitor's selection only applies to that search session — it does not change your admin default marketplace setting.
How does pagination work?
Results are paginated with navigation controls at both the top and bottom of the results area. The top bar shows Prev / Page X of Y / Next so visitors can navigate without scrolling down. All pagination is AJAX-based — the page never reloads. eBay limits results to a maximum of 10,000 per search query. If your search returns more than 10,000 results, a notice appears suggesting more specific keywords or filters to narrow down.
Is there a sidebar widget?
Yes — My eBay Listings Pro includes a WordPress sidebar widget. Go to Appearance → Widgets and add the My eBay Listings Pro widget to any sidebar or widget area. You can configure it as a mini search form or a compact pre-set listings grid. It is ideal for keeping eBay listings visible while visitors read blog content in your main column.
What are Top Pick listings and how are they highlighted?
Top Pick is an automatic highlighting system. Listings are highlighted with a gold border, a Top Pick badge and a Top Rated Seller label when they meet two criteria simultaneously — the seller is eBay Top Rated, and the listing offers free shipping. These are statistically the most trustworthy listings and most likely to convert, which means higher EPN commission potential. The highlighting is fully automatic — no configuration needed.
What does the Shortcode Builder do?
The Shortcode Builder in Settings → My eBay Listings Pro → Shortcode Builder is a visual form that generates shortcodes without any coding. Fill in your seller username, search query, columns, rows, condition, sort order, price range, location and category — the shortcode updates in real time as you type. Click Copy to copy it to your clipboard, then paste it into any page, post or text widget. It removes the need to remember any shortcode attributes manually.
How does caching work?
API results are cached using WordPress transients. The default cache duration is configurable from 5 minutes to 24 hours in Settings → Display → Cache Duration. Caching keeps your site fast and reduces API calls. The cache clears automatically when you save your plugin settings. Individual searches are cached separately based on the search parameters.
Troubleshooting
The shortcode shows nothing on my page — why?
Check these in order:
1. Licence not active — go to Settings → My eBay Listings Pro → Account and confirm your licence shows as active.
2. API credentials not saved — go to the Credentials tab and confirm Client ID, Client Secret and Campaign ID are entered and saved.
3. Test Connection failed — click Test Connection. If it fails, see the Setup Guide for troubleshooting steps.
4. Caching — try clearing your site cache if you use a caching plugin.
1. Licence not active — go to Settings → My eBay Listings Pro → Account and confirm your licence shows as active.
2. API credentials not saved — go to the Credentials tab and confirm Client ID, Client Secret and Campaign ID are entered and saved.
3. Test Connection failed — click Test Connection. If it fails, see the Setup Guide for troubleshooting steps.
4. Caching — try clearing your site cache if you use a caching plugin.
Search returns no results even for common keywords — why?
The most common cause is the Item Location filter being set to a specific country with no matching listings. Try changing Item Location to Worldwide. Also check the marketplace — searching for US listings on the eBay UK marketplace may return fewer results. The plugin defaults to Worldwide location for maximum results.
The plugin worked before but stopped after an update — what do I do?
First, check your licence is still active in Settings → Account. If the licence shows active, try deactivating and reactivating the plugin. If problems persist, contact support@exceedwebservices.com with your WordPress version, PHP version and a description of the issue. Always update through WordPress dashboard — not by deleting and reinstalling — to preserve your licence and settings.
Listing images are not showing — how do I fix this?
If listing images are missing or broken, check these:
1. Content Security Policy — some themes or security plugins block external images. The plugin loads images directly from eBay's CDN (
2. Ad blockers — some browser ad blockers block eBay image domains. This affects only the visitor's own browser and is not something you can control.
3. Lazy loading — images use native browser lazy loading. If you see empty boxes initially, scroll down to trigger loading. The first image in each set loads eagerly for performance.
1. Content Security Policy — some themes or security plugins block external images. The plugin loads images directly from eBay's CDN (
i.ebayimg.com). Ensure this domain is not blocked by your CSP or security plugin settings.2. Ad blockers — some browser ad blockers block eBay image domains. This affects only the visitor's own browser and is not something you can control.
3. Lazy loading — images use native browser lazy loading. If you see empty boxes initially, scroll down to trigger loading. The first image in each set loads eagerly for performance.
The plugin conflicts with another plugin on my site — what should I do?
My eBay Listings Pro uses its own scoped CSS and vanilla JavaScript with no jQuery dependency, which minimises conflicts. If you experience layout issues, try these steps:
1. Temporarily deactivate other plugins one by one to identify which plugin causes the conflict.
2. Check your browser console (F12) for JavaScript errors — these often identify which plugin is conflicting.
3. If a caching plugin is active, clear all caches after any plugin update.
4. Contact support@exceedwebservices.com with details of the conflicting plugin and we will investigate.
1. Temporarily deactivate other plugins one by one to identify which plugin causes the conflict.
2. Check your browser console (F12) for JavaScript errors — these often identify which plugin is conflicting.
3. If a caching plugin is active, clear all caches after any plugin update.
4. Contact support@exceedwebservices.com with details of the conflicting plugin and we will investigate.
Still need help?
Email us at support@exceedwebservices.com with:
— Your WordPress version and PHP version
— A description of the issue
— Any error messages shown
— The shortcode or block configuration you are using
We aim to respond within 1 business day.
— Your WordPress version and PHP version
— A description of the issue
— Any error messages shown
— The shortcode or block configuration you are using
We aim to respond within 1 business day.
💡
Before contacting support, check the Setup Guide — most common issues are covered there.
Need help?
Our support team typically responds within 24 hours.
Still have a question?
Email us at support@exceedwebservices.com — we reply within 1 business day.