Help / FAQ

Click on one of the FAQ (Frequently Asked Questions) below to be taken to the answer :

Using Auction Nudge

I Don't Get It - What Is Auction Nudge?

Auction Nudge is a set of completely free widgets to integrate eBay into your own website. If you sell on eBay you can include Your eBay Listings, Your eBay Profile and Your eBay Feedback on your site.

Auction Nudge is fully customisable through a set of inbuilt themes and options. It can also be styled using your website's style sheet using CSS.

Installation consists of copying and pasting one line of code on to your web page. Once installed, Auction Nudge will update automatically - displaying your live eBay listings and information.

Auction Nudge is completely free and does not require registration.

An Example?

For example if you run a website that is aimed at vintage cookie cutter enthusiasts and you also sell vintage cookie cutters on eBay - you may want to display your current eBay listings on your own website. Auction Nudge allows you do do this and means you can show your cookie cutters for sale right next to the cookie cutter information on your site. By doing this you are targeting your listings at your visitors who already have an interest in cookie cutters and the best part is that once up and running Auction Nudge will automatically update itself and only show your active items!

It is really simple to set up and only requires one line of code to be copied onto your site. To see how easy it is, use one of the links on the right to view a live demo and get started. There are also demos and help available below!

How Do I Install Auction Nudge?

Watch the video which covers installing Auction Nudge on your site and also how to customise how your items appear (view video in full screen for best results) :


To install Auction Nudge on your website :

  1. Copy ALL of the code in the text box in Step three ('Copy the code snippet onto your site')
  2. Using any text editor open the file for the web page on which you want to install Auction Nudge.
  3. Paste the copied code into the file where you want the eBay listings to appear (somewhere between the <body> and </body> tags).
  4. Save your modified web page.
  5. Upload the modified web page to your server.

Please see the stripped down demo, and the stripped down demo source code to see Auction Nudge working on a simple web page.

For details on how to customise Auction Nudge please see Are there any examples of customising the appearance and layout using CSS? below.

Can I Display Items In A Specific Category Only?

Yes – due to popular demand you now have the option to filter items by eBay category. This is useful if you have items listed in multiple categories on eBay but only want to display those listed in a certain category on your site. What's more you can specify up to 3 different categories.

A note about eBay store categories - the steps outlined here describe filtering items by eBay category. Filtering items by store categories is not possible.

The following video runs you through how to do this. The text below also explains this.

How to specify an eBay category to filter by

On the Your eBay Listings page, when generating your code snippet there is now an option on Step two called "Category ID". This is a text box which allows you to enter a numeric eBay category ID and chose to only display items listed in that category (see below for help on obtaining eBay category IDs)

To filter by more than one category you can separate multiple category IDs with a colon ":" for example 123:465:789

How to obtain eBay category IDs

As outlined above in order to only display items listed in a certain category you need to specify an eBay category ID. This is a unique number which eBay uses to identify it's categories. This number can be found by visiting any eBay category and looking in the URL (web address) in your browsers address bar. For example in order to only show DVDs you have for sale you would want to filter by the eBay DVD category. The web address for the DVD category on is:

By looking at the URL (web address) for the category page we can see a number in the second to last segment – in this case 2288. This is the Category ID. Therefore this is the number we would add in the ?Category ID? field when generating our snippet on the Auction Nudge site to only show items in this category.


How Is Such An Awesome Tool Free?

Auction Nudge funds itself through affiliate commissions from eBay. This means Auction Nudge is free to use and there are no 'pay to unlock' type restrictions and no signups – just obtain your code snippet and install it on your site!

How Reliable Is Auction Nudge?

Auction Nudge has been operating since 2008 and during this time has seen 99.9% uptime (the amount of time the service has been available). Because updates come from the Auction Nudge server, a lot of time has been spent making sure these updates happen reliably and are super fast.

Can I use Auction Nudge on Facebook? / I need a secure (HTTPS/SSL) version of the Auction Nudge script, is this available?

The code snippet which embeds Auction Nudge on your site now automatically loads a HTTPS version of the tool if your page is being served via HTTPS. This prevents any mixed content blocking issues – where some browsers block content loaded via HTTP on pages served via HTTPS.

While there is absolutely nothing 'insecure' about using the legacy code snippet, which loads Auction Nudge via HTTP, sometimes third party websites (like Facebook) require that external scripts are loaded via a HTTPS connection.

In this situation, you can update the legacy code snippet to ensure Auction Nudge is loaded via HTTPS as follows:

<script type="text/javascript" src="

<script type="text/javascript" src="

You should only force the HTTPS version of the script if absolutely necessary.

Customising Auction Nudge

How Can I Modify The Appearance Of Auction Nudge?

As well as choosing from different themes when you generate your Auction Nudge code you can also change the appearance using simple CSS rules. Auction Nudge will automatically use the default CSS rules for your web page, for example the default font and link colours so it integrates nicely with your page.

You can change the CSS rules for Auction Nudge by specifying new rules in your style sheet. You can see the HTML structure of themes here. Please see the CSS demos below for more help.

As a quick example, to make all of the product titles bold you would add this rule to your style sheet :

div#auction-nudge-items td.title {
  font-weight: bold;

To change the alternating background colours when displaying rows of items you would add this rule to your style sheet :

div#auction-nudge-items table.columns tr {
  background-color: red;  /* Change to desired colour */
div#auction-nudge-items table.columns tr.alt {
  background-color: blue;  /* Change to desired colour */

All themes can be adjusted in this way.

Are There Any Examples Of Customising The Appearance And Layout Using CSS?

Yes! Please see the list below for some examples, the source code is also available for each ...

  1. How to adjust colours - view demo - view demo source
  2. Making the title bold - view demo - view demo source
  3. Adjusting font type and appearance - view demo - view demo source
  4. How to change the background color of the rows in the 'Column View' theme - view demo - view demo source
  5. How to adjust the theme width - view demo - view demo source
  6. Changing the appearance of images in the 'Images Only' theme - view demo - view demo source
  7. Specifying a width / height for listings and adding a scroll bar - view demo - view demo source
  8. This example demonstrates how to change the text and background colours used by the 'Your eBay Feedback' theme - view demo - view demo source

You can use any number of CSS rules to change the appearance - a good article on this can be found here.

How Can I Increase The Size Of Item Images?

Some item images can be increased in size by using CSS to overwrite the dimensions set by Auction Nudge. By default these are set to 64px x 64px which means depending on the orientation of the image the width or height will not exceed more than 64px. To alter these dimensions add the following CSS rule to your stylesheet, changing the values as desired:

#auction-nudge-items .image-container {
  width: 140px !important;
  height: 140px !important;

It is recommended that the width and height values are the same so the image does not become distorted. View the demo of this in action.

What Is The 'Unstyled' Theme And How Do I Customise It?

The 'unstyled' theme displays eBay items on a page with no added formatting using CSS. Items are marked up using a simple <ul> element with child <li>s which can then be used as hooks for custom CSS styling as explained in the above two sections.

For example, once loaded onto your page your Auction Nudge content will look something like this:

<div class="auction-nudge" id="auction-nudge-items">
  <img id="ebay-logo" src="[ebay_logo_url]">
  <ul class="item">
    <li class="image first">
      <div class="image-container">
        <a href="[item_url]">
          <img src="[image_url]">
    <li class="title">
      <a href="[item_url]">Item Title</a>
    <li class="price">[currency_symbol]Item Price</li>
    <li class="format bin">Buy It Now</li>
    <li class="ends last">Xd Yh Zm</li>
  <ul class="item alt">
  ... and so on ...

Using this format you should have enough hooks to write your own custom CSS and style the items however you wish. Please note for auction style listings, the 'format' <li> element will be displayed like this:

    <li class="format auction">X bids</li>

You can also create custom behaviour and modify the HTML produced by Auction Nudge using a Javascript callback function as described here.

What Is The HTML Structure Of The Your eBay Listings Themes?

Auction Nudge has a variety of theme options to choose from. Because Auction Nudge only uses open standards web technologies (HTML, CSS and Javascript) to add content to your page, with the right knowlege you are able to modify these themes or even create your own.

The following pages outline the markup of each Your eBay Listings theme:

Are There More Themes Available?

At present the themes listed in the code generation tool are the only ones available, however the 'unstyled' theme can be used to create custom layouts. Please see the above sections for more details.

However I am always interested in creating new themes so if you have any suggestions then feel free to contact me with any input you have.

Can I Change The Behaviour Of Auction Nudge?

Yes, Auction Nudge is added to your page as HTML elements once the page has loaded. As with writing custom CSS rules this means you can also interact with these elements using Javascript. For example:

  1. Making links generated by Auction Nudge open in a popup window once clicked - view demo - view source
    Watch the video tutorial:
  2. Hiding the "bids" column in the "Column View" theme if you only have Buy It Now items - view demo - view source
  3. Making Auction Nudge content load after other page content - view demo - view source
  4. Filtering items by keyword - view demo - view source
  5. Make item links generated by Auction Nudge open in a blank window/tab by adding the target="_blank" attribute - view demo - view source
  6. Make the profile badge link generated by Auction Nudge open in a blank window/tab by adding the target="_blank" attribute - view demo - view source

You can also create custom behaviour using Javascript as described in the following section.

Can I Modify Auction Nudge Content Using Javascript/jQuery?

Yes, once Auction Nudge has been loaded on your page you can use Javascript (or your chosen Javascript library) to manipulate the HTML produced by Auction Nudge as you wish.

In order to do this at the correct time Auction Nudge attempts to execute a Javascript callback function called auction_nudge_loaded() once loaded. If this function exists, the code within the function will be executed. You can see an example of this in action here.

Can I Display Items From More Than One Seller On A Single Page?

Yes and No. At the moment Auction nudge will only display one set of items and if you paste in two sets of Auction Nudge code you will just get duplicate listings.

There is however a work-around for this using iframes. There is an example of this here: view demo - view source

You can using CSS to style the iframes how you wish - for example you may want the 'columns' to be wider or for second set of listings to display below and not beside the first. This is possible.

How Can I Stop The "No active items." Text From Appearing On My Site When I Have No Active Items On eBay?

Simply add the following CSS rule to your stylesheet:

div#auction-nudge-items {
  display: none;

You could even take this a step further and use Javascript to edit the content displayed when there are no active items. More details here.

How Can I Stop The "Buy It Now available" Text From Appearing In My Item Feed?

Simply add the following CSS rule to your stylesheet:

div#auction-nudge-items span.bin-available {
  display: none;

Can I Translate Auction Nudge Into Another Language?

Yes, the text displayed by the Your eBay Listings feed can be translated into another language using a simple script which must be included within the HTML of your page.

You can view the demo which explains how to do this, or view the source.

Can The Date Format De Changed From DD/MM/YY To MM/DD/YY?

Yes, the format of dates displayed in the Your eBay Listings feed can be changed using a simple script which must be included within the HTML of your page.

Please view the demo, or view the source.

Inner workings, problems or errors

How Often Does Auction Nudge Update / Why Isn't Auction Nudge Updating?

To reduce server load the Auction Nudge does not update every time it is loaded on your site. Instead the Your eBay Listings feed will update at most every 60 minutes, the Your eBay Profile updates every 6 hours and the Your eBay Feedback tools updates every every 6 hours.

Some users may have to wait slightly longer for their feed to update if, since they started using Auction Nudge they have had a period of over a month where they have had no active eBay items. In this situation as soon as their feed updates and again the user has active items, their feed will return to updating every 60 minutes. Longer periods of inactivity will reduce the frequency of updates.

For example if eBayUser123 uses Auction Nudge on their website, but goes away for a 2 month vacation and does not have items listed on eBay during this time the following will happen:

  1. Auction Nudge keeps a note of the last time eBayUser123 had active items
  2. During the first month their feed will be update every 60 minutes as usual
  3. After one month of no active items their feed will only update every two hours
  4. Once eBayUser123 returns from vacation and lists new eBay items, their feed will go back to updating every 60 minutes

This is so temporarily inactive eBay members do not cause unnecessary server load.

Can I use my eBay Partner Network Campaign ID to earn affiliate commissions?

Unfortunately it is not possible to use your ePN tracking details with Auction Nudge. However you can earn eBay affiliate commissions using our sister site Auction Affiliate, which is a powerful tool for affiliates that enables you to embed eBay items on your page using your own ePN campaigns.

Like Auction Nudge this is completely free and does not require registration. You are able to embed items on your page with HTML/Javascript, PHP or using the WordPress plugin.

How Many Items Can Auction Nudge Show And How Are They Ordered?

Auction Nudge can show up to 100 items at any one time, and can be ordered by:

  • Items Ending First
  • Newly-Listed First
  • Price + Shipping: Lowest First
  • Price + Shipping: Highest First
  • Best Match

How Many Feedback Comments Can Auction Nudge Show? Is It Possible To Show More?

Auction Nudge can show up to 25 of the most recent feedback comments for your eBay username. Unfortunately it is not possible to show more than this.

Will Auction Nudge Work In My Browser? Why Isn't Auction Nudge Displaying Correctly In Certain Browsers?

Because Auction Nudge is powered by web standards - HTML, Javascript and CSS as with any web page, cross browser issues can arise. Having said that browser support is excellent for most themes. Known issues are:

  • Item images in the Your eBay Items tool may not size correctly in Internet Explorer 6 - due to the CSS property max-width not being supported.
  • The Your eBay Items Carousel theme may not function correctly with Internet Explorer 7 and down, due to it's implementation of the box model.

Can I use Auction Nudge on eBay itself? / I Am Seeing "Your items can not load because the website hostname contains a disallowed keyword." On My Site. What Does This Mean?

If you are seeing this then most likely you are trying to use Auction Nudge on a domain which uses either the keyword "eBay" or "paypal" in the domain name. This is blocked by Auction Nudge as it is not allowed under eBay's terms and conditions. This includes using Auction Nudge on eBay sites.

Auction Nudge isn't loading, what's wrong?

Are you developing your site locally without running it on a web server? If so then this may cause your code snippet to load incorrectly. This can be easily fixed by editing your code snippet as follows:

<script type="text/javascript" src="//

<script type="text/javascript" src="

Another reason for Auction Nudge failing to load on your page is Javascript errors from other scripts. You can check for these in your browser's error console.

If this doesn't resolve your issue, then please get in touch and be sure to include a link to your site where you have the code snippet installed so I can investigate further.