Allegro and WooCommerce: connecting your store to the marketplace step by step
Allegro and WooCommerce, store integration step by step: Base (formerly BaseLinker), category mapping, stock and price synchronisation, and the costs.
An Allegro WooCommerce integration connects your store to Allegro, the largest Polish marketplace: listings are created from the products in the store, stock levels and prices update automatically, and orders from both channels land in one place.
In this guide I go through the whole process: from the Allegro business account, through the choice of an integrator, to category mapping and a test order. You can set the integration up yourself if you have access to the WordPress admin and the Allegro account.
How an Allegro WooCommerce integration works
AI-generated image
An Allegro WooCommerce integration is a connection between the store and the marketplace through the Allegro API. Products, prices, stock levels and orders flow between the systems automatically, according to the rules you set.
In practice a WooCommerce product can be used to create a listing on Allegro. When a customer buys it in one channel, the integration updates the available stock in the other. Orders from the marketplace go to the panel you choose, where you can issue a sales document, prepare a label and change the shipping status.
Allegro does not offer a free official plugin in the WordPress directory that would synchronise listings with WooCommerce. The official “One by Allegro” plugin is for handling deliveries: creating shipments and printing labels. It does not list products or move orders between channels.
The other plugins you find by typing “Allegro” often just display listings on a site or have not been updated for several years. That is why external integration platforms have become the standard. The most common choice is Base, which used to operate under the name BaseLinker.
Before you start: the Allegro business account and requirements
AI-generated image
To sell as a business you need an Allegro business account with the company details filled in. On the store side a working WooCommerce, administrator access to WordPress and a tidy product catalogue are enough.
Before you set up the integration, prepare:
- the login details for the Allegro business account,
- administrator access to WordPress,
- product names and descriptions,
- images of suitable quality,
- EAN numbers in the categories that require them,
- information about variants, such as size or colour,
- agreed prices and current stock levels.
Check the costs of selling too. Allegro charges a commission that depends on the product category. It is usually from a few to a dozen or so per cent, and you will find the current rates in the price list for sellers. The commission is calculated on the value of the order together with the shipping cost paid by the buyer.
Separate rules apply to the Allegro Smart programme. The seller co-finances deliveries, so this cost should also be part of the margin calculation. It is best to work it out before listing, especially for cheap products and a small margin.
Order in the catalogue will save you a lot of time. Missing EANs, random variant names and images assigned to the wrong versions of a product later make bulk listing harder.
Ways to integrate: an integrator, a dedicated plugin or the API
You can set up an Allegro integration through an integration platform, a custom-built solution or a WordPress plugin. For most small and medium stores the simplest choice is a ready-made integrator.
The first route is a platform such as Base, formerly BaseLinker. It connects WooCommerce, Allegro, courier companies and invoicing systems in one panel. Base has an official plugin in the WordPress directory and a separate module for Allegro. Apilo works in a similar way, with a strong focus on Polish marketplaces.
The second option is a made-to-measure integration using the Allegro REST API. Allegro provides public documentation for developers, so a connection can be built to fit a specific process. This makes sense with an unusual pricing model, a complex warehouse, your own ERP system or a large number of exceptions that a ready-made platform does not handle.
| Method | When it makes sense | What to watch out for |
|---|---|---|
| Integrator (Base, Apilo) | Small and medium stores, a quick start to selling without building your own system | An integrator plan that matches total sales from all channels |
| Your own integration through the Allegro REST API | Unusual pricing model, complex warehouse, own ERP, many exceptions | Development work and later maintenance of the integration |
| ”Allegro + WooCommerce” plugins | When the plugin is updated and compatible with the current version of WooCommerce | Many older projects have been abandoned; they can stop working after API changes |
Setting up Allegro with Base step by step
Connecting a store to Allegro in Base covers adding WooCommerce, authorising the seller account, preparing the parameters and starting synchronisation. In other integrators the process looks similar, although the tab names may differ.
Step 1. Create a Base account and connect the WooCommerce store
The Freemium plan in Base costs PLN 0 and covers up to 100 orders a month. With higher sales, the Business plan costs PLN 279 net a month up to 1000 orders.
- After creating the account, add the WooCommerce integration in the Base panel. The system will ask for the store address and REST API keys.
- You generate them in WordPress under WooCommerce → Settings → Advanced → REST API.
- Create a key for a user with the right permissions, then copy the consumer key and the secret to the Base panel.
- After saving the connection, run a test product import. Check a few items, variants, prices and stock levels.
If the data already matches at this stage, the rest of the configuration will go more smoothly.
Step 2. Authorise the Allegro account
Add the Allegro integration in Base and start the authorisation. You will be redirected to the Allegro site, where you log in to the business account and accept the scope of access.
The authorisation uses the official Allegro mechanism. You type the password on the marketplace’s site, so you do not hand it to the integrator. Base receives consent to carry out specific operations through the API, including fetching listings and handling orders.
Back in the panel, make sure the right account has been connected. This matters if you run several brands or have access to more than one seller profile.
Step 3. Map products to Allegro categories and parameters
Every listing has to be assigned to a specific Allegro category. The category defines the set of required parameters, for example EAN, brand, colour, size, material or product condition.
Base suggests categories and lets you fill in part of the data in bulk. You can assign shared parameters to a whole group of similar products and take the variable values from WooCommerce attributes.
This stage usually takes the most time. If the store has a colour saved once as “navy” and another time as “dark blue”, the automatic mapping may need corrections. A similar problem appears with variants without SKU codes or products with missing EAN numbers.
Start with a few representative products. Pick one simple product, one with variants and one from a category that requires many parameters. This way you catch the gaps sooner, before listing in bulk.
Step 4. Publish the listings and switch on stock and price synchronisation
You can list finished products one by one or in whole groups. Before publishing, check the title, category, parameters, images, description, delivery terms and price of each sample listing.
After listing, start stock synchronisation. A purchase in the store should then lower the stock on Allegro, and a sale on Allegro should update availability in WooCommerce. Also set the behaviour for a product whose stock falls to zero: ending the listing or pausing it until the stock is replenished.
Prices can be synchronised 1:1 . You can also set a different price for Allegro, for example higher by a set percentage or a fixed amount. This lets you account for the marketplace commission, the co-financing of deliveries and other fees.
Step 5. Set up order import and place a test order
Orders from Allegro can go to the Base panel, and from there to WooCommerce as well. Choose one place where the team will do the day-to-day handling.
If you work in Base, you can check payments, prepare shipments, print labels and update statuses there. If your current process is based on WooCommerce, configure the passing of orders to the store and check how the buyer’s details, delivery costs and payment methods are saved. You can also handle Paczkomat (InPost parcel locker) shipments directly in the store. See the guide to integrating InPost with WooCommerce.
Before the full launch, run a test on one listing. Go through the whole path: the purchase, fetching the order, the stock update, generating the label and passing on the shipping status. Check the sales document and the messages sent to the customer as well.
Stock and price synchronisation: what to watch out for
- One source of data. The safest configuration has one source of data for stock and prices, usually WooCommerce. The integrator takes the changes from it and passes them to Allegro according to set rules.
- A simple overwrite rule. If one employee corrects the stock by hand in WooCommerce, a second does it in Base and a third changes the quantity on Allegro, discrepancies appear quickly. Agree a simple rule: where you update stock, where you update prices and which system may overwrite the others.
- Sales and a buffer. During a sale or a sudden rise in traffic the update may not happen at once. With the last few items of a product this raises the risk of selling more than the available stock. It is worth setting a stock buffer or pausing the most popular listings in advance.
- Variants and deleted listings. Variants need particular attention. Every size or colour should have its own identifier and stock level. Also check listings deleted by hand on Allegro. The integrator may still try to update them if the link has stayed active.
- Review the invoice settings. The document should be created in one system, so that the customer does not get two invoices for the same order.
How much an Allegro WooCommerce integration costs
The cost of an Allegro WooCommerce integration covers the marketplace commissions, the integrator plan and the time needed to configure the products. With an individual connection through the API, add development work and later maintenance of the integration.
| Item | How much | Notes |
|---|---|---|
| Allegro commission | From a few to a dozen or so per cent | Calculated on the order value together with the delivery cost |
| Base, Freemium plan | PLN 0 | With at most 100 orders a month |
| Base, Business plan | PLN 279 net a month | Covers up to 1000 orders |
| Integration through the API | Development work and later maintenance | A connection fitted to a specific process |
| Time to tidy up the products | A dozen or so well described products: quick; a few hundred items with variants: more work | Categories, parameters, EANs, variants and attributes |
Add to the calculation the time to tidy up the products, assign categories and fill in the parameters. With a dozen or so well described products the work can go smoothly. A few hundred items with variants, missing EANs and inconsistent attributes need far more attention.
Your own store does not charge a commission on every transaction. But you have to bring in the traffic yourself and look after advertising, SEO and returning customers. You will find a full breakdown of the costs of running a store in the article on how much an online store costs.
The store, Allegro, or both
A mixed model lets you use Allegro’s reach and grow your own store at the same time. An Allegro integration with WooCommerce simplifies running both channels, because products and orders use a shared stock.
| Criterion | Allegro | Your own WooCommerce store |
|---|---|---|
| Reach and traffic | Access to a large group of buyers | Traffic grows more slowly and needs promotion |
| Cost of selling | You pay a commission on every sale | The store charges no commission on transactions; you bring in the traffic yourself |
| Customer relationship and brand | Limited scope for building a direct relationship | More control over the brand, prices and customer base |
| Role in a mixed model | Quick access to new orders | Builds the brand and sales at a fuller margin |
If you are only planning your own sales channel, see the guide on how to start an online store.
In many small companies a simple split works well. Allegro gives quick access to new orders, and the store builds the brand and sales at a fuller margin. A well set up Allegro integration lets you run both channels in one process, without retyping orders by hand and constantly correcting stock levels.
FAQ
Is there a free official Allegro plugin for WooCommerce?
There is no official Allegro plugin in the WordPress directory that synchronises listings with WooCommerce. The official “One by Allegro” plugin handles the delivery service, including shipments and labels. For a full integration, the Base or Apilo platform is usually used.
Can an Allegro WooCommerce integration be free?
Yes. The Freemium plan in Base costs PLN 0 with at most 100 orders a month. You still pay Allegro commissions and the other selling costs that follow from the price list and the services you choose.
Do stock levels synchronise automatically?
Yes, once synchronisation is running, a sale in one channel lowers the available stock in the other. Set one source of stock data and link the products and their variants correctly.
Do Allegro orders go to WooCommerce?
Yes. The integrator fetches orders from Allegro and can pass them to WooCommerce. You can also handle all sales in the integrator’s panel, if that is where you prepare shipments and documents.
Do I need a business account to sell on Allegro?
Selling as a business requires a business account with the company details. An account like this gives access to the tools for sellers and lets you authorise the integration through the Allegro API.