Allegro WooCommerce - FAQ

Start by configuring the plugin. The setup includes the following steps:

• Enter your login credentials in the plugin settings and click Save Changes,
• Select at least one default category (mandatory),
• Map Allegro categories to WooCommerce categories to enable automatic auction listing,
• Define required category attributes (optional if you don’t use attribute mapping),
• Choose whether to list auctions only or also import Allegro orders and register users,
• Create shipping price lists,
• Create a description template for the auction,
• Create an auction settings template (required to list an auction).

Once the plugin is configured, follow these steps to list an auction:

• Go to Products and select the ones you want to list,
• From the bulk actions dropdown, choose List on Allegro and save changes,
• In the auction listing screen, select your auction template and start date, then click List on Allegro.

You’ll find a full explanation in this guide. If you run into issues, contact our support.

Go to Allegro → Settings → Default Categories and check whether the selected category is correct.

You’ll find more information about valid Allegro category numbers on the FAQ page.

The message comes directly from the Allegro API.

1. Usually, it indicates:

• missing required fields (e.g. brand, condition, warranty),
• invalid value (e.g. too long, or incorrect format),
• an issue in the auction description

Check whether the description uses proper tags and formatting. Avoid nesting tags like [p][b][/p][/b]. Make sure row and column tags are correctly closed, and watch for special characters like &.

1. Ensure tags like p and b are not nested and are used correctly.
2. Use paragraphs (p) instead of br for line breaks.
3. Don’t use b tags inside headings (h1–h6) or center.
4. Validate your HTML using: https://www.w3schools.com/tags/default.asp
5. Ensure list items are structured properly:

   [ul]
   [li]first item[/li]
   [li]second[/li]
   [li]third[/li]
   [/ul]

6. Don’t use Polish characters in attribute slugs.
7. Follow Allegro’s recommendations for image sizes:
   Allegro image guidelines
8. Ensure the new description uses rows and columns, e.g.:

   [row]
   [col_text]
   [product_name]
   [product_short_description]
   [auction_price]
   [/col_text]
   [col_image]
   [auction_image_1]
   [/col_image]
   [/row]

9. Don’t include multiple text rows in one column.
10. After making changes to the draft, click Check auction validity or list the auction.
11. Ensure no empty or incorrectly nested shortcodes are used. If so, you may see Auction is not valid: cannot be a gap.

2. The message may also point to a specific field, for example:

• Invalid value for Width (365). Must be between 0 and 650 – check character limits,
• Invalid EAN – verify the number format,
• Invalid parameter value Power (206146) or Heating zones (206158) must be an integer – confirm accepted value ranges,
• Field must be between 0 and 650 – check if fields like “Delivery info” are too long,
• Parameter id 216325 values may not be longer than 255 characters – shorten long text inputs (like Additional features).

3. If the issue persists, contact us. Send a screenshot of your auction draft and template via the support form.

Allegro no longer allows listing auctions using the old HTML-based description format. Auctions must use the new block-based format.

To list an auction with a new description format using our plugin:

1. Add a new description template:
   

   

2. Ensure the template is in new description mode:
   

   

3. Create the template using blocks and shortcodes:
   

   

4. Save your changes
5. Go to the auction template editor and select the new description template:
   

   

6. Save your changes
7. When listing products, use the updated auction template:
   

   

8. You can also download ready-made templates from:
   Allegro description templates for download

You can list several auctions linked to one WooCommerce product. Each Allegro auction can have a different price.

To update the price, go to Allegro → Auctions, change the value, and update the auction.

You can also enable price synchronization between the product and the linked auction. In this case, prices will sync automatically every 10 minutes.

Stock synchronization applies to all auctions linked to a given product, for example, after a sale or manual stock adjustment in WooCommerce.

You can also update the quantity from Allegro → Auctions for each listed offer.

Auction prices are managed through auctions linked to your WooCommerce products.

When listing an auction, you can set the price using a multiplier or by adding a fixed amount. For example, a multiplier of 0.5 will list the auction at half the store price. You can also set -2 to reduce the auction price by that value.

Set this rule in the auction template under Price Settings.

If you end or delete an auction directly on Allegro, the related auction status in WooCommerce will be marked as Ended. You can remove such auctions manually from Allegro → Auctions using bulk actions and the Move to Trash option.

Alternatively, you can leave ended auctions to quickly create similar ones using the Relist/Duplicate feature. The new draft can be edited before publishing it on Allegro.

Check the answer in this FAQ entry: I received a critical error related to category 260443; I see a "category not found" message.

Yes, if price synchronization is enabled in the plugin settings.

Check whether price sync is active in the plugin’s main settings.

Go to Allegro → Settings. Fill in the store address details in the Allegro account settings.

Save your changes, go back to the auction draft, and try listing the auction again (or run a check). The message should no longer appear.

Modifying the product description before it's sent to Allegro can be helpful when it contains characters not allowed by the platform.

You can use the allegro_auction_description filter to adjust the description to your needs. Below is an example where all letters in the product description are converted to uppercase:

add_filter('allegro_auction_description', function($desc) {
return strtoupper($desc);
});

The filter modifies the description sent to Allegro but does not affect the original WooCommerce product.

The settings template groups all the required Allegro options in one place. Without at least one template, you won’t be able to list auctions. When creating a template, make sure to define:

• the Allegro account used for listing,
• auction title and category,
• item features,
• item photos and description,
• sales format: Buy Now or Store,
• delivery and payment options,
• offer conditions,
• promotion options,
• product quantity.

You can find a full walkthrough in this guide. If you need help, reach out to our support team.

Yes. Once the Allegro WooCommerce plugin is activated, a new Allegro tab appears in the product edit panel. Go to that tab to configure your auction settings.

Settings configured in the product take priority when listing the auction. Regardless of template or mapping data, the auction will be listed using the values set in this tab.

From the product edit screen, you can configure:

• auction title,
• auction description,
• gross price,
• description template,
• category,
• thumbnail (first photo used specifically for the auction).

You can save your settings, which allows you to pause and return later. Alternatively, click Save and list auction to save the settings and proceed directly to the next step.

The process is described in this guide. If you run into issues despite following the instructions, contact our support team.

To successfully list or import auctions, you need to configure the plugin and connect your store to your Allegro account. Start by setting up:

• REST API authorization. If it’s correct, you’ll see a short ok status message,
• event logging. It’s recommended to enable this initially to record all communication between your store and Allegro, making it easier to identify issues,
• shipping settings in WooCommerce, since the plugin supports shipping integrations with selected carriers,
• default categories. The plugin will not work correctly without this step,
• category mapping. This helps manage categories—when a product is assigned to multiple categories, the first mapped category will be used when listing,
• attribute mapping to fully automate auction listing from your store’s products,
• synchronization. The plugin lets you import orders from Allegro to WooCommerce, register users, sync stock quantities, update prices, and manage tasks via Cron.

You’ll find a detailed explanation of each step in this guide. If you encounter problems after reviewing the documentation, reach out to our support.

Make sure that any changes you make to the auction description template or the auction settings template are saved using the Update and Update auction buttons. In the Item photos and description section of the auction template, next to the list of available description templates, you’ll also find a Download template and update auction description button. Every change in the description template must be confirmed using this button.

We’ve described the process in detail in the plugin documentation. If you follow the steps and still encounter issues, contact our support team.

This message appears when the Brand parameter is missing or incorrectly filled.

Even if a brand is provided, make sure it exactly matches the brand registered on your Allegro account. Pay attention to special characters and spacing.

Use consistent naming in both WooCommerce and Allegro to avoid errors.

This warning usually means there is an empty tag in the auction description, such as [row][/row].

To resolve the issue, add the missing content to the tag in the description editor.

This message is shown if your WooCommerce store is connected to a private Allegro account.

To publish auctions, ensure your Allegro account is verified as a business profile.

This message appears when mandatory parameters are missing.

Make sure these fields are filled out in the auction template or on the product page in the Allegro tab.

If you are using attribute mapping, go to Allegro → Settings → Attribute Mapping and assign attributes to the required parameters (e.g., Size, Offer conditions, Condition, Manufacturer, Length, Height, Capacity, Product code).

Keep in mind:

• Attribute mapping has higher priority than auction templates.
• Product-level settings override both mappings and templates.

More about attribute mapping is available in the documentation.

This error may occur if:

• You are using a private Allegro account. Switch to a business account.
• Your business account is not active. Log in and complete the necessary payment.

If the issue persists despite having an active business account, and the Allegro or plugin documentation does not help, please contact our support team.

Allegro requires every auction to be linked with a product from its catalog.

To link a product to an existing auction, go to the auction edit screen and use the Select product from catalog field to find the appropriate item.

You can read more about product linking in this guide.

If no match is found during auction creation, the plugin will attempt to add a new product to the Allegro catalog.

To ensure successful addition, make sure the product has a name, EAN, all required category parameters, and an image.

When importing auctions from Allegro, the plugin will fetch the EAN value for both the newly created product and the linked auction in the following locations:

During auction import, product images are saved in the product gallery of the linked auction.

You can import an auction and link it to an existing product in your store or a new product created during the import. In the latter case, the images will also be available for the new WooCommerce product. The first image from the Allegro auction will be used as the product's main image, and the rest will be added to the product gallery.

By default, WooCommerce themes display product images from the gallery on the product page.

Remember that only active Allegro auctions can be imported into the store. If you are importing active auctions and nothing appears, the issue may be related to PHP limits.

In that case, follow these three steps:

• Check the plugin's PHP requirements
• Increase your WordPress memory limit to more than 256MB, e.g., 512MB or 1GB. See how to increase PHP memory limit
• You can also set the max_execution_time to 300 or 600. See how to increase the PHP execution time limit
• If the issue persists, enable debugging, attempt to import auctions again, and send us the link to the debug file. Submit your request using the support form.

Before importing auctions into WooCommerce, set default categories and map them to WooCommerce categories. See how to do it.

During the import, you can filter auctions by Allegro category:

When importing an auction and creating a new WooCommerce product from it, you can assign or change the default WooCommerce category for that product:

The indicated category ID may have changed on Allegro.

To fix this, go to the default category mapping screen and remove the outdated category. Then, re-add it by selecting the subcategories all the way to the end of the tree.

This should resolve the issue. Next, edit the auction and assign the correct, new category:

Do the same in the auction template. Make sure the correct category is selected.

If the category name hasn’t changed, you can still update the template by saving it again:

Uncaught AllegroVendor\WPDesk\HttpClient\Curl\Exception\CurlException: Default exception: SSL certificate problem: unable to get local issuer certificate

Ask your server administrator to define the certificate file paths (cainfo and cafile) for the website.

You can follow this English-language guide on how to fix CURL SSL issues in php.ini.

If you're using AZ hosting, you can also add the paths in a user.ini file:
curl.cainfo="/public_html/cacert.pem"
openssl.cafile="/public_html/cacert.pem"

1. Make sure all fields on the Allegro API connection settings screen are filled in correctly. The WebAPI key should match the value in the Client ID field.
2. Also check your store data and the API connection status at the bottom of the screen.
   

   

3. If all fields are correct, try reauthorizing the connection.
4. Ensure that two-step verification on your Allegro account is disabled, as noted in the Allegro WooCommerce plugin requirements.
5. The issue may also be caused by a temporary outage on the Allegro API side.
6. If reauthorizing doesn’t work, send us a screenshot of the Allegro → Settings screen. Submit your request via the support form.

The plugin syncs with Allegro every 10 minutes using cron jobs:

allegro_orders_schedule
allegro_auctions_schedule
allegro_stock_schedule
allegro_price_schedule


These handle order import, auction sync, stock sync, and price sync respectively.

You can trigger these tasks manually using a plugin like Advanced Cron Manager, or set custom times directly on the server following our guide on WordPress cron jobs.

You can also change the interval using the allegro_cron_schedules_delay filter:

add_filter('allegro_cron_schedules_delay', 'set_new_allegro_cron_delay');

function set_new_allegro_cron_delay($delay){

$delay = 300;

return $delay;

}

1. Check the plugin requirements.
2. Increase your WordPress memory limit to more than 256MB, e.g. 512MB or 1GB. See how to increase the memory limit in WordPress.
3. You can also set the max_execution_time to 300 or 600. Learn how to change max_execution_time in WordPress.

Stock synchronization between WooCommerce and Allegro is based on several rules and requires specific settings to be enabled.
Key rules:

• A product sold on Allegro will update the stock quantity in WooCommerce, but only if the order import option is enabled in the plugin settings.
• A manual stock quantity change in WooCommerce will sync to Allegro (e.g., when you edit the quantity on the product edit screen).
• A manual stock quantity change in Allegro will not trigger a stock update in WooCommerce.
• An order from Allegro is imported into WooCommerce only after the buyer completes the payment and shipping form.

Yes, you can remove products from your WooCommerce store without closing the corresponding auctions on Allegro. However, once the product is deleted, price and stock synchronization will no longer work, and orders placed on Allegro won't be imported into your store.

On the auction list, you'll see a message indicating the product is missing: Product not found (possibly deleted). Product ID: XXX. To restore synchronization, reimport the auction from Allegro to WooCommerce.

As a workaround, instead of deleting the product, you can move it to the trash. The link between the product and the auction will remain, but the product won't be visible in your store's offer.

You can also hide the product in the catalog to stop selling it in the store while keeping it synchronized with the auction on Allegro. To do this, open the product edit screen in WooCommerce and in the Publish metabox, change the Catalog visibility option:

Note: If you disconnect the store from Allegro, any changes made to products that are still listed on Allegro will no longer affect their listings.

If you're migrating the full site, including files and the database, the plugin will continue working as before.

If you're migrating to a new domain or address, first revoke the current authorization. After migration, reauthorize the plugin by setting up a new API authorization for the new Allegro application (domain).

To migrate your site, you can use a plugin like Duplicator.

Before starting the migration, back up your website files and database. This ensures you can restore the site if something goes wrong. Once the migration is complete, check if everything works correctly at the new address. Then, reconnect to Allegro and reauthorize the API keys in the WP Desk menu.

Keep in mind: When exporting and reimporting products into a new environment, product IDs will be regenerated. As a result, existing auction connections (which depend on product IDs) will be lost.