< Back to all Documentation

Extension for Magento v1.x

eBay Integration

M2E Pro for Magento v2.x is available. Information about releases can be found here.

Skip to end of metadata
Go to start of metadata

Item description is one of the main customer decision-making criteria. The more comprehensive your product description the more buyers your offer will attract. Complete the following options to achieve the best result.


In M2E Pro advanced mode, you can:

  • customize description settings for each product individually by switching to the Settings View Mode in M2E Pro Listing
  • save description settings as a Policy to reuse them in the future
  • add a new Description Policy by navigating to eBay > Configuration > Policies and clicking Add Policy.


  • Condition - select either eBay Condition or Magento Attribute. If Magento Attribute is used, make sure it contains the proper Item Condition ID.

  • Seller Notes - provide the extra details about your offer. Can be applied for all Condition types, except 'New, New with tags, New with box, Brand New'.


It is important that prospective buyers get accurate information about Item condition. It may reduce the risk of returns.

For more details, please see the eBay API reference: Item Condition IDs and Names.


'New' condition may be indicated as 'New: With Tags', 'New Other' as 'New: Without Tags', etc. depending on the eBay category.

Images and Watermarks

  • Main Image – an image that the prospective buyers will see on your eBay Item page and next to the Item title in search results.

  • Super Size – allows displaying larger, more detailed pictures (up to 800w x 800h pixels - 800 pixels on the longest side) if enabled. This feature may come with an additional fee.

  • Gallery Images – allows adding up to 11 additional photos for each Item. The gallery images will be displayed as the small thumbnails under the Base Image on eBay Item page.

  • Change Images for Attributes (only for Configurable products) – allows selecting the option by which the Item images should be switched on eBay.


For each Configurable Product, images can be switched only by one variational attribute.

If your product varies by two or more variational attributes, M2E Pro will take the first selected in the list.

  • Variation Attribute Images (only for Configurable and Grouped products) - allows adding up to 12 images for each variation of Variational Item.


Find more details about image uploading images here.

  • Watermarks - allows adding watermarks to your images.

    • Use Watermark – allows enabling/disabling watermark feature. 
    • Watermark Upload – allows uploading watermark image. 
    • Watermark Transparency – allows adding watermark transparency of 30 %. 
    • Scale Watermark Image – allows scaling watermark image.
    • Watermark Position – allows specifying watermark position on the image.


Please read more details here.


  •  Title – allows providing a title for the Item. The clear and descriptive title makes it easy for customers to recognize your offers on eBay. Include the key details of your product when writing its title. You can use Magento Product Name attribute or Custom Value option.

  •  Subtitle – allows you to specify the additional details about your offer. eBay charges the fee for using this option. Find out more about Insertion Fees.

  •  Cut Long Titles – if enabled, automatically cuts the Item titles to 80 characters and subtitles to 55 characters to comply with eBay limitation.


  • Description Source - select either 'Product Description' or 'Product Short Description' to take the related data from Magento. Alternatively, you can create a Custom Description using the WYSIWYG / HTML tool and Attribute / Image inserts.

Read more information on how to set up a Custom Description here.

eBay Catalog Identifiers

By specifying the unique eBay Catalog Identifiers (brand, MPN, and GTIN), you make it easy for prospective buyers to find your Items on eBay.

In Description Policy, you can specify the GTIN, ePID, Brand, and MPN values for your Simple, Configurable and Grouped Products:

  • EAN (European Article Number, also known as International Article Number) - a unique 8 or 13 digit product identifier.

  • UPC (Universal Product Code) - a unique 12 digit identifier commonly used to identify the products in Music (e.g., CDs), DVDs & Movies, and Video Games categories (or domains).

  • ePID (Product Reference ID) – a unique Item identifier used in the eBay catalog.

  • ISBN (International Standard Book Number) – a unique 10 or 13 digit book identifier.

  • Brand - a brand of product you are selling.

  • MPN - a part design identifier used in the particular industry.

If your Product does not have UPC/EAN/ISBN/MPN code or any Brand data, you can select 'Does not apply' or 'Unbranded' values accordingly.


The logic of eBay Catalog Identifier submitting:

- the Brand value is taken from Magento Parent Product and applied to the whole Item including its variations.

- GTIN and MPN values for each variation of your Configurable and Grouped Products can be provided in two ways. If they are set in Description Policy, the relevant values will be taken from Magento Child Products. eBay Catalog Identifiers provided for Configurable and Grouped Products via Manage Variation pop-up will have a priority over the settings made in Description Policy.

-  eBay Catalog Identifiers for each variation of your BundleDownloadable and Simple with Custom Options Products can be provided only via Manage Variation pop-up. You will find Manage Variations link in the eBay View Mode of M2E Pro Listing next to a Multi-Variation Product. 

- 'Does not apply' and 'Unbranded' values can be set for all Variational Products only via Description Policy.

After at least one eBay Catalog Identifier is specified (except 'None', 'Does Not Apply', 'Unbranded' values), two more options become available:

  • Use Description From eBay Catalog - enable to include the additional information about the product, e.g. publisher's description or film credits, to your Item description.

  • Use Image From eBay Catalog -  enable to include the stock photos from eBay catalog to your Item description.


Some eBay catalog identifiers may not be available for eBay Sandbox environment.

Listing Upgrades

To stand out your Listing from others you can use eBay standard tools. Be aware, these features come with additional eBay fees.

  • Value Pack Bundle – combines Gallery, Subtitle, and Listing Designer to get a discount.

  • Bold Title – makes the Item title bold.

  • Highlight – adds an eye-catching background to your Item in the search results.

  • Gallery Type – adds Item images using different modes in the search results.

  • Hit Counter – enables the tool that counts the overall visits to our eBay Item page. If you select the Hidden Counter, the number of Item page views will be available only for you. The Green LED, Honesty

    Style and Retro Style are only available in the US.


The Hit Counter tool may not be available for eBay Sandbox environment.