The Knowband PrestaShop Auction Module (also called AuctionX) allow store owners to run live auctions on products and on individual product variants. This manual walks store admins through installing the PrestaShop auction extension, setting it up, creating auctions, and handling live bidding through to the winner’s order.
The PrestaShop Auction Module is a product bidding system for PrestaShop. With it you can run timed auctions, accept customer bids, keep a bid history, and move the winning bid into a normal order.
It includes a back office auction dashboard, a storefront auction listing, live countdown timers, customer bid history, an optional watchlist, winner selection, and auction email notifications.
How the PrestaShop Bidding System Works
- The admin creates an auction for a product or a product combination, sets the bidding rules and dates, and publishes it.
- Customers open the auction, place bids while it is running, and track results from their account.
- When the auction closes, the module picks the winners automatically, or the admin picks them by hand.
- A winner places the order at the winning amount before the set deadline.
These are the main features of the module. Together they let a merchant run controlled online auctions in PrestaShop, manage who takes part, choose winners, and finish the sale.
Product Auctions and Variant Bidding
Create an auction for any active product and, if needed, for one specific combination. The form covers starting price, bid increment, optional maximum bid, reserve price, waiting time between bids, visibility options, scheduling, and closing rules.
Live Bidding on the Product Page
Logged in customers bid straight from the product page. The module checks the minimum amount, bid increment, maximum bid, bidder status, stock, and the minimum time between bids. The live view updates through polling, shows a countdown, and displays the statistics the admin has chosen.
Auction Scheduling and Auto Extension
An auction can stay in Draft or be published to start at a later time. With Auto Extension on, a bid placed within the trigger period pushes the end time back.
Winner Selection and Order Completion
Winner Selection Mode can be Auto or Manual. In Auto mode the module ranks each bidder by their highest bid, leaves out blocked bidders, applies the reserve price, and settles ties in favor of whoever reached the amount first. In Manual mode the admin chooses winners from Live View once bidding has ended. Each winner gets an order deadline and a private order link under My Bids.
Watchlists and Auction Announcements
With the watchlist turned on, customers can save auctions to My Watchlist. Watchers can be emailed when other users bid and when an auction starts, as long as the matching email template is enabled.
Dashboard and Email Notifications
The dashboard has configurable KPI widgets, charts, and tables of recent activity. The Email Templates page holds subjects and bodies in several languages for bid confirmations, winning bids, auction announcements, order events, bidder blocks, cancellations, and other events.
3. Installing the PrestaShop Auction Module
Install and activate the module in the PrestaShop back office before you create any auction. Follow these steps in order.
- Sign in to the PrestaShop Admin Panel.
- Go to Modules > Module Manager.
- Choose the upload option and upload the Knowband PrestaShop Auction Module archive.
- Install the module and wait for PrestaShop to finish.
- Go to Sell > Knowband PrestaShop Auction Module. During installation the module creates its database tables, default settings, email templates, CRON token, hooks, and back office tabs.
- Open General Settings, enable the module, and set the storefront options.
- Set up the CRON job shown on the General Settings page if you want scheduled status changes, automatic winner processing, and deadline processing to run without anyone visiting a page.
Uninstalling the module only removes its back office menu entries. Auction data, bids, winners, watchlists, email templates, logs, dashboard layouts, and settings stay in place, and they are still there if you reinstall.
4. Opening the Module in the Back Office
After installation, every auction function is under Sell > Knowband PrestaShop Auction Module. The pages are:
- Dashboard
- General Settings
- Customization Settings
- Email Templates
- Auctions
- Winners List
- Other Modules
General Settings, Customization Settings, and Email Templates are also reachable from the in page Settings menu.
5. Admin Panel Overview
The admin area is split into separate sections, so settings, auction work, notifications, reports, and winner records can each be handled on their own.
Dashboard
Shows auction KPIs, charts, and recent activity for the current shop, so you can check how things are going without opening each auction. Widgets can be turned on or off, reordered, and resized.
General Settings
Turns the bidding system on or off and decides where auction summaries show on the storefront. It also holds the CRON URL and an example server crontab entry.
Customization Settings
Sets the colors used for auction boxes, buttons, progress bars, watchlist controls, body areas, and status badges.
Email Templates
Lists the fixed notification templates with their codes and status. Every template has one translation row for each installed language, with an editor for the subject and a rich text body. These emails keep admins, bidders, watchers, and winners informed during the auction.
Auctions
The place to view the auction list, apply filters, add or edit auctions, open Live View, block bidders, select winners, and run lifecycle actions.
Winners List
A read only history of closed auctions with winner and order details. Auctions that closed without a winner are included.
Other Modules
A catalog of other Knowband extensions. It has no auction settings.
6. PrestaShop Auction Module Configuration
This section covers each configurable area. Check these values before you publish an auction, because they affect bidding rules, what shows on the storefront, notifications, and winner processing.
General Settings
Enable Module. The main switch for the module. Leave it on No while you are still preparing things if you do not want customers to see auctions. Choose Yes to turn on storefront and bidding behavior. Options: Yes or No. Default: No.
Enable Watchlist. Allows logged in customers save auctions and come back to them. Turn this on after enabling the module. Options: Yes or No. Default: No. Customers must be logged in.
Show Recent Auctions on Home Page. Adds a block of recent auctions to the home page for extra exposure. Options: Yes or No. Default: No.
Number of Recent Auctions. Sets how many auctions the home page block lists. Enter a whole number from 1 to 20. It applies only when Show Recent Auctions on Home Page is Yes. Default: 5.
Display auction info on Category page. Adds auction status to product cards on category pages, so shoppers can spot products that are in an auction now or soon. Options: Yes or No. Default: No. The badge appears on category pages only, not on every page that reuses a product list template.
CRON URL. The server calls this URL to run scheduled auction tasks, which matters for auctions that must move forward without page visits. The page shows a generated URL and a crontab line that runs every minute and sends a silent curl request to that URL. Use Copy to copy either one. Regenerate CRON token makes the old URL invalid, so update your server crontab right after using it. The URL contains a secret token, so keep it private.
Customization Settings
These settings allows you match the auction look to your store theme. Every field is a color input, is required, and must be a six digit hex code such as #ffffff.
| Setting |
What it controls |
Default |
| Header Background Color |
Auction header background |
#2456e7 |
| Header Text Color |
Text in the auction header |
#ffffff |
| Button Color |
Auction action buttons |
#2456e7 |
| Button Text Color |
Text on auction buttons |
#ffffff |
| Progress Bar Color |
Bidding progress bar |
#2456e7 |
| Add to Watchlist Color |
Watchlist control |
#2456e7 |
| Box Body Background Color |
Auction box body |
#ffffff |
| Box Text Color |
Text in the auction box |
#1f2430 |
| Live / In Progress Badge Color |
Live status badge |
#dc2626 |
| Upcoming Badge Color |
Upcoming status badge |
#4f46e5 |
| Ended / Expired Badge Color |
Ended and expired badges |
#64748b |
Click Save to apply the colors. Blank or wrongly formatted values are rejected.
Managing Auctions
The Auctions section is where you create, set up, publish, watch, and manage each auction from start to finish.
Auction List
The list allow you search, filter, and inspect auctions and run actions on them. Its columns are ID, Reference Number, Auction Title, Product, Status, Starting Price, Start Date, and End Date.
The Status filter offers Draft, Scheduled, Ongoing, Inactive, Completed, Winner Selected, Order Pending, Order Placed, Winner Expired, Reassigned, and Cancelled.
Available actions are Add New Auction, View, Edit, Publish, Duplicate, Pause, Resume, Force Cancel, Delete, and Bulk Delete, depending on the auction’s current status. Ongoing auctions cannot be deleted. Bulk Delete skips ongoing rows and tells you which IDs it skipped.
Basic Information
This part names the auction, links it to a product, sets its starting state, and defines the schedule and storefront behavior.
- Auction Title. Required, up to 30 characters, and unique across the whole store setup.
- Reference Number. Required, up to 64 characters, and unique. Use letters, numbers, hyphens, and underscores.
- Select Product. Pick an active product. You may also pick a combination for variant bidding.
- Auction Status. Draft or Publish. Publishing gives Scheduled status if the start time is ahead, and Ongoing status if the start time has already come.
- Hide Product Price. Hides the normal product price while the auction box is shown.
- Hide Add to Cart Button. Hides the normal Add to Cart button for the auction product.
- Continue Selling. Decides whether normal selling can go on while the auction is set up.
- Starting Date/Time and End Date/Time. Enter these in the form’s Asia/Kolkata timezone. The start cannot be in the past. The end must come after the start and, when editing, must be in the future.
Bidding Configuration
These are the money and participation rules that decide which bids are accepted and what bidders can see.
- Starting Price. Required and above zero. The first bid must reach this amount.
- Bid Increment. Required and above zero. Each later bid must be at least the current highest bid plus this amount.
- Maximum Bid. Optional. Must be above the Starting Price. Once it is reached, no more bids are accepted.
- Minimum Time Between Bids (minutes). Optional whole number. Sets a waiting period between bids from the same customer.
- Reserve Price. Optional and hidden from bidders. It must be at least the Starting Price and no more than the Maximum Bid. Automatic winner selection only works if the reserve price is met.
- Show Highest Bid. Allow customers see the current highest bid.
- Show Bid Rank. Allow a bidder see their own rank.
- Show Total Bids. Shows the total number of bids.
- Show Bidder Information. Decides whether bidder details are shown.
- Show Last Bid Time. Shows when the last bid was placed.
All the visibility switches use Yes and No.
Auction Extension
Auction Extension guards the final stretch of an auction by letting late bids move the end time.
- Enable Auto Extension. Turns on extension when a bid comes in inside the trigger window.
- Extension Trigger (minutes). Required and above zero when auto extension is on. This is the window before the scheduled end in which a bid causes an extension.
- Extension Duration (minutes). Required and above zero when auto extension is on. This is how much time gets added when the trigger is met.
Winner Configuration
This part sets how winners are chosen and how long they have to buy.
- Winner Selection Mode. Auto ranks bids and creates winners by itself. Manual lets you pick winners from Live View once bidding ends.
- Number of Winners. Default 1. Must be at least 1 and cannot be more than the available stock. It is hidden or ignored in Manual mode.
- Winner Order Deadline. Enter a number (default 48) and choose Hours or Days. Winners must order before this deadline.
Dashboard
The Dashboard gives a quick view of auction activity and results through KPIs, charts, and recent activity tables.
Use the period selector to choose Last 7 days, Last 30 days, Last 3 months, Last 6 months, or Last 12 months. Save Layout and Reset Layout are available.
KPI widgets: Total Auctions, Upcoming Auctions, Ongoing Auctions, Completed Auctions, Order Pending Auctions, Orders Placed, Total Bids, and Unique Bidders.
Charts: Auction Status, Auction Statistics, Bid Statistics, and Conversion Statistics.
Tables: Recent Auctions, Recent Bids, Recent Orders, Top Products, and Top Bidders.
Drag widgets to reorder them, switch them on or off in the Widget Library, and set their column span from 1 to 12. KPI values show the current state of the shop. The period selector affects the period based charts and the Top Bidders data.
Email Templates
Email Templates controls which messages go out at key points in an auction. Enable the ones you need and edit the text for each installed language.
The first grid shows ID, Title, Code, and Status, with a Manage Translations option. Status is Disabled or Enabled. All templates start out disabled, so turn on each notification your store should send.
The translation grid shows Language, Subject, Enabled or Disabled status, and Edit. The editor has a Subject, a rich text Body, a placeholder legend, and Save. The subject is required and limited to 255 characters. The body is required.
Built in notifications:
- Email to Admin on Bid Place
- Email to Customers on Bid Place by Other Users
- Email to Watchers on Bid Place by Other Users
- Email to Watchers on Auction Start
- Email to Customer on Winning and Place Order
- Email to Other Customers Who Placed a Bid but Did Not Win
- Email to Admin on Order Place
- Email to Admin on Auction Close or No Bid
- Email to Admin on Auction Close and Winner Selected
- Cancelled Auction: Notify Users Who Placed a Bid
- Email to Users on Block/Unblock Bidding on Any Auction
- Email to Admin on Maximum Bid Reached
Use only the placeholders listed in the editor’s legend. If a translation is missing, the shop default language is used. Each email attempt is saved in the email log. If an email fails, the bid, order, or auction step still goes through.
Winners List
The Winners List is a read only record of closed auctions with their winners and order details. Columns: Auction ID, Reference Number, Product, End Date, Actual End Date, Winner, Winning Bid, Order Status, Order Deadline, and Order Reference. Order Status can be Pending, Placed, Expired, or Reassigned.
An auction with no winner appears with empty winner fields and a no winner label. Use View Auction to open the related auction.
7. Field Types and Options
This summary shows what kind of input each part of the module uses.
- General Settings: Yes/No switches and one number field.
- Customization Settings: color inputs.
- Auction form: text fields, a product and combination picker, status choice, date and time inputs, numeric price and duration fields, and Yes/No switches.
- Winner Configuration: Auto/Manual choice, numeric winner count, numeric deadline, and an Hours/Days choice.
- Lists: searchable, filterable tables with status, date, product, and reference filters where offered.
- Dashboard: draggable widgets, an enable/disable library, a period selector, and column span controls.
- Email Templates: status toggle, language table, text subject, rich text body, and a Save button.
8. Admin Actions
Admin actions either change an auction’s state or help you manage customers and winners. Which actions you see depends on the auction’s status.
- Save stores settings, colors, dashboard layouts, or email translations, depending on the page.
- Publish moves a Draft to Scheduled or Ongoing.
- Pause moves a Scheduled or Ongoing auction to Inactive. Resume brings an Inactive auction back.
- Force Cancel cancels an Ongoing auction.
- Duplicate makes a copy of an auction.
- Delete removes an eligible auction. Ongoing auctions are protected.
- Bulk Delete deletes the eligible selected rows and skips Ongoing ones.
In Live View you can Refresh, Block or Unblock a bidder, Pause, Resume, Cancel Auction, Edit Auction, and select manual winners where it applies. In Manual mode, the order in which you select bidders sets their winner rank.
9. Storefront Behavior: What Customers See
This section describes the customer side of the PrestaShop bidding system: bidding, auction listings, account pages, and limits on winning orders.
Product Page Auction Box
The product page can show an auction box for auctions that are scheduled, ongoing, won, lost, no bid, no winner, ended pending, or inactive. For an ongoing auction, depending on your settings, the box can show the countdown, the current or next minimum bid, a progress bar, the bidder count, rank, total bids, last bid time, a bid field, the Place Bid button, a watchlist control, a blocked bidder message, and a maximum bid message.
Bidding Rules for Customers
Customers must be logged in to bid, and guests see a login prompt. A customer cannot right away outbid their own bid, and blocked bidders cannot bid. Stock levels and PrestaShop out of stock rules also affect whether a bid is accepted. The page polls every 10 seconds by default to refresh status, timing, minimum bid, statistics, winner state, and extension notices.
Auction List Page
The public Auction List has tabs for All, Upcoming, In Progress, and Expired. The Expired tab is optional. Ended cards are greyed out and do not link to the product. The home page block and category badges follow their General Settings switches.
Customer Account: My Bids and My Watchlist
The customer account has an Auction entry that opens My Bids. My Bids shows bid history, best bid, result, ranking where allowed, and a Place Your Order or View Order action. When the watchlist is on, My Watchlist lists scheduled and ongoing auctions, and Include past/cancelled shows older watched ones.
Quantity Limit for Winning Orders
Products bought at a winning price are limited to a quantity of 1 in the cart and at checkout. If the module corrects a higher quantity, it shows a notice explaining why.
10. Multi-language, Multi-store, and Currency Behavior
Auction, bid, watchlist, winner, and dashboard data belong to a shop. In single shop context, admin lists show only the current shop. In the All Shops context, nothing is restricted. Auction reference numbers and titles must be unique across all shops.
Email subjects and bodies are stored per language. Languages that exist at install time are seeded, and a missing translation falls back to the shop default language. A language added after installation may not get translation rows automatically.
Auction amounts are stored and compared in the shop default currency. Storefront values are converted to the customer’s chosen currency, while admin notification emails use the shop default currency. The auction form and admin dates use Asia/Kolkata time, and stored dates use UTC.
11. CRON Job and Automated Tasks
The CRON job handles time based work, so scheduled starts, closings, winner selection, and expired winner deadlines are processed even when nobody visits the store or admin pages.
Call the CRON web URL every minute with the token shown on the page. Each run can:
- Move due Scheduled auctions to Ongoing and notify watchers.
- Close expired Ongoing auctions.
- Select winners for Auto auctions.
- Process expired winner deadlines and reassign or expire winner slots.
Each run handles at most 200 records. Product views, bids, polls, and the Auctions list also do some limited just in time expiry processing, but CRON is needed for auctions that get no page visits.
12. External Services and API Settings
The module needs no external API connection. The CRON URL is an HTTP endpoint on your own PrestaShop installation, not an outside service. There are no external credentials to enter. Keep the token private, and regenerate it if it may have been exposed.
13. Troubleshooting the PrestaShop Auction Module
If an auction, bid, email, or winner order is not working as expected, check the causes and fixes below. If the problem remains, contact Knowband support.
The auction does not show on the storefront
Possible cause: The module is disabled in PrestaShop, Enable Module is No, or the auction is in Draft, is inactive, or belongs to a different shop or product combination. Fix: Enable the module in PrestaShop and in General Settings, check the auction status and dates, and confirm the selected product or combination.
Customers cannot use the watchlist
Possible cause: Enable Watchlist is No, or the customer is not logged in. Fix: Turn on the setting and test while logged in.
Scheduled auctions or winners are out of date
Possible cause: The CRON URL is not being called, the token was regenerated but the server job was not updated, or the module is disabled. Fix: Copy the current URL from General Settings, update the server crontab, run it every minute, and make sure Enable Module is Yes.
Email notifications are not sent
Possible cause: The template or the language translation is disabled or incomplete. Fix: Enable the template, edit the translation, make sure the Subject and Body are filled in, and look at the email log and PrestaShop logs. Email failures do not block bidding or order processing.
A bid is rejected
Possible cause: The bid is under the starting price or required increment, the maximum bid was reached, the bidder is blocked, the waiting period has not passed, stock rules reject it, or the auction is no longer ongoing. Fix: Review the auction’s bidding settings and status. The customer must be logged in and cannot immediately outbid their own bid.
A winning customer cannot place the order
Possible cause: The winner token or deadline is invalid, the product or combination does not match, the paid amount is different from the winning amount, or the cart quantity is not exactly 1. Fix: Have the customer open My Bids, use the active Place Your Order link before the deadline, pick the right product or combination, and keep the quantity at 1.
Category auction badges are missing or look wrong
Possible cause: The category display switch is off, the auction is not live or upcoming, or a heavily customized theme changes the product card selectors. Fix: Enable Display auction info on Category page, check the auction status, and review the theme’s product list markup if the styling is off.
14. Best Practices for Running PrestaShop Auctions
These tips help you avoid setup mistakes, keep automated tasks running, and give customers a steady auction experience.
- Keep Enable Module off while you prepare auctions, then test one full auction before opening more.
- Use unique, clear Reference Numbers and short Auction Titles.
- Double check start and end times in the Asia/Kolkata admin timezone.
- Pick a Bid Increment that suits the product’s value, and review Maximum Bid and Reserve Price together.
- Turn on only the statistics and bidder details you want customers to see.
- Set up CRON before publishing scheduled auctions.
- Enable and review each email template in every language your store uses.
- Treat the CRON URL as a secret and regenerate it if it leaks.
- Test a winning order with the right product, combination, winning amount, and a quantity of 1.
- Use Live View to watch for odd bidding, block bidders when needed, and keep a record of manual winner choices.
- Update the module to the latest Knowband release for security and compatibility.
15. Conclusion
The Knowband PrestaShop Auction Module is a full bidding extension for scheduled product auctions, live bidding, customer bid history, watchlists, winner selection, and winner order handling. General Settings controls activation and storefront placement, Auctions defines each product auction, Customization Settings controls the look, Email Templates controls notifications, and the Dashboard and Winners List help with daily auction management.