Sending product descriptions to Allegro

If you pair the optional elements name, images and product description in your Mergado Marketplaces campaign, the app will try to upload this data to Allegro.

If you get the orange message “The given description does not comply with the Allegro format, the description provided by Allegro will be used instead, or the offer will be published without a product description” in the validation, you don’t need to worry about it. We will upload the offer to Allegro even though your description does not meet Allegro’s requirements. In this case, we will use the description that Allegro has for the product card (if a description is available).

:exclamation: If you would like to have your offer with your own description on Allegro, you need to have the data in the product description element correctly formatted with HTML.

Would you like to have a custom description for your offers on Allegro?
If you wish to have your own product description on Allegro, you must format the text according to Allegro’s requirements. If you make changes in the Mergado Editor, don’t forget to regenerate your feed after you have made the changes, which will also regenerate the data in the Mergado Marketplaces application.

How to format the labels correctly?
Allegro only supports the following HTML tags:

  • h1 - title
  • h2 - subtitle
  • p - paragraph
  • ul - bullet list
  • ol - numbered list
  • li - list item
  • b - bold font

Another restriction by Allegro is that the h1 and h2 tags must not be formatted.

Example of correctly formatted text:

   <h1>Heading</h1>
     <p><b>Sample of properly formatted label</b>. Below is an example of a numbered and bulleted list.</p>
     <ul>
         <li><b>The first bulleted item in bold.</b></li>
         <li>Second bulleted list item.</li>
     </ul>
     <ol>
         <li><p><b>The first item in the number list in bold.</b></p></li>
         <li><p>The second item of the number list.</p></li>
      </ol>

The description must always begin and end with an HTML tag!

:bulb: Other important information:

  • <ul> and <li> tags must not be wrapped in <p>
  • <b> must not stand alone unwrapped
  • <h1> and <h2> must not be wrapped in <p>
  • Disallowed characters also include & and <a>

How do I edit the formatting of a description using Mergado Editor?

  1. If you have formatted the labels but only need to replace <strong> with <b> for example, you can apply the “Find and Replace” rule in the Mergado Editor. For more information about this rule, see here.

  2. If your product descriptions contain characters that are not allowed by Allegro, you can also use the “Strip HTML tags” rule via Mergado Editor and then just add <p> at the beginning of the text and </p> at the end using the “Rewrite” rule, where the new value will be <p>%DESCRIPTION%</p> (instead of DESCRIPTION, add the name of the element in which you have product descriptions).
    :exclamation: If your description was richly formatted with bullets, bold, etc., then using this rule will lose the formatting and everything will be displayed within a single paragraph.

  3. If you don’t have the description formatted at all, just insert <p> at the beginning of the text and </p> at the end using the “Rewrite” rule, where the new value will be <p>%DESCRIPTION%</p> (instead of DESCRIPTION, add the name of the element where you have the product descriptions).

After making the changes, don’t forget to apply the rules so that the changes are also reflected in the Mergado Marketplaces application.

In the Allegro menu you have both your product images and some other people’s?
If you wish to have only your own images in the Allegro menu, you must provide a properly formatted product label. If you do not pair the DESCRIPTION element or if the DESCRIPTION element is not formatted correctly, Allegro will add your product images to your offer, in addition to your product images, also images of the product from the Allegro product card.

Not sure why Allegro is still not accepting your descriptions? Try inserting one of your descriptions into an online HTML formatting validator, or email our support team at mergado@mergado.cz