Setup Guide
Get up and running in 15 minutes

Get your Browse API credentials

The eBay Browse API gives the plugin access to live eBay listings. You need a free eBay Developer account to get your API keys. This takes about 5 minutes.

• 1Go to developer.ebay.com and click Sign In — use your regular eBay account or create a new one.
• 2Once logged in, go to My Account → Application Access Keys in the top navigation.
• 3You will see two sets of keys — Sandbox (for testing) and Production. You need the Production keys.
• 4If no Production keys exist yet, click Get a Production Keyset and give it a name (e.g. "My eBay Listings Pro").
• 5Copy your App ID (Client ID) and your Cert ID (Client Secret) — you will need both in Step 3.

Get your EPN Campaign ID

The eBay Partner Network (EPN) is eBay's official affiliate programme. Your Campaign ID is how eBay tracks clicks and sales from your site so you earn commission. This is completely separate from your Developer account.

• 1Go to partnernetwork.ebay.co.uk and sign in with your eBay account.
• 2If this is your first time, you will need to apply to join EPN. Approval is usually instant or within 24 hours.
• 3Once approved, go to Account → Campaigns in the top navigation.
• 4Either use an existing campaign or click Create Campaign — name it something like "My Website" or "WordPress Plugin".
• 5Your Campaign ID is the number shown next to the campaign name. It looks like a long number, e.g. 5338XXXXXXXXX. Copy this.

Install and activate My eBay Listings Pro

Once you have your API credentials and EPN Campaign ID ready, installing and configuring the plugin takes just a few minutes.

• 1Log in to your WordPress admin and go to Plugins → Add New → Upload Plugin.
• 2Click Choose File, select your downloaded my-ebay-listings-pro.zip file and click Install Now.
• 3Click Activate Plugin. The plugin will prompt you to activate your licence — enter your licence key and click Activate Licence.
• 4Go to Settings → My eBay Listings Pro — you will see the plugin settings dashboard.

Activate your licence key

After purchasing, you will receive a licence key by email from Freemius. You need to activate this on your site before the plugin will display any listings.

• 1Go to Settings → My eBay Listings Pro → Account in your WordPress admin.
• 2You will see a licence activation screen. Paste your licence key into the field — it starts with sk_b- and was emailed to you at purchase.
• 3Click Activate Licence →. Freemius will verify the key and activate the plugin on your site.
• 4Once activated, the Account page will show your name, plan (Personal/Business/Agency) and expiry date confirming the licence is live.

Connect to the eBay API

With the plugin activated, enter your API credentials in the Credentials tab. This connects the plugin to eBay's live data feed.

• 1Go to Settings → My eBay Listings Pro → Credentials tab.
• 2Paste your eBay Client ID (App ID from Step 1) into the Client ID field.
• 3Paste your eBay Client Secret (Cert ID from Step 1) into the Client Secret field.
• 4Paste your EPN Campaign ID (from Step 2) into the Campaign ID field.
• 5Select your primary marketplace — for UK sites select United Kingdom, for US sites select United States.
• 6Click Save Changes, then click Test Connection. You should see a green success message confirming the API is connected.

Add eBay listings to any page

With everything connected you can now add eBay listings anywhere on your site. There are two ways — the Gutenberg block editor or shortcodes.

Option A — Gutenberg Block Editor

• 1Edit any page or post and click the + button to add a new block.
• 2Search for "eBay Listings" or "eBay Seller" and select the relevant block.
• 3Use the inspector panel on the right to configure all options — no code needed.
• 4Click Publish or Update to save.

Option B — Shortcodes

Five shortcodes are available — paste any of these into a page, post or text widget:

Combining the Seller Card with the Search Panel

One of the most powerful features is placing the seller card directly above the search panel by using both shortcodes together on the same page. The seller card sits flush on top of the search panel with no gap — creating a professional branded shop experience.

This gives you three layout options:

• ASearch panel only — use [ebay_listings] on its own for a clean search experience.
• BSeller card only — use [ebay_seller] on its own to showcase a seller profile anywhere on your site.
• CBoth together — paste [ebay_seller] immediately above [ebay_listings] and they snap together seamlessly — the seller card sits directly on top of the search panel.

Common shortcode attributes:

• sellerLock results to a specific eBay seller username.
• queryPre-set a search keyword.
• columnsNumber of card columns (1–6). Default: 4.
• rowsNumber of rows to display. Default: 3.
• categoryRestrict results to an eBay category ID.
• conditionNEW, USED, VERY_GOOD, GOOD, ACCEPTABLE, FOR_PARTS.
• min_price / max_priceFilter by price range.
• sortnewlyListed, endingSoonest, price, -price.

Match the plugin to your site design

The plugin is fully customisable — every colour, label and display option is configurable from the admin dashboard without touching any code.

• 1Colours tab — change accent colour, panel background, card borders, badge colours, postage label colours and more. All 19 colour tokens are configurable.
• 2Display tab — toggle individual card elements on/off, set default column and row counts, configure cache duration (5 min to 24 hours) and enable SmartLinks.
• 3SmartLinks — enable in Display → API & Performance to automatically convert all eBay links on your site to affiliate links. Recommended for affiliate sites.
• 4Marketplace Switcher — enable in Display → Card Elements to let visitors switch between eBay marketplaces from the search panel.