Extended Properties for listings

Extended Properties on listings are used to define the product specifications on a SKU level and add these details to listing templates. While the stock item itself keeps basic information (description, image, title), Extended Properties allow adding item details like item condition, brand, model, material, shipping prices, variation attributes like size, colour, etc.

Table of contents:


Adding Extended Properties

To map Extended Properties on configurators, they must first be added to your inventory items. Extended Properties can be added in bulk via an inventory import (see this guide) or one-by-one in the Extended Properties tab in Product details (see steps here).


Mapping Extended Properties

When the necessary Extended Properties are added to your items, you can map them to different parts of the configurator. The options available depend on the channel. For full details on each channel configurator, please see the respective documentation from this list.

Mainly, Extended Properties are used for adding attributes/specifications to listings. This can be done in the Attributes section of a configurator (Specifications section on an eBay configurator).


 In the Attributes/Specifications screen, you can see two fields for each available attribute: Extended Property and Default Value.

  • Extended Property column: retrieves the attribute/specification from the item Extended Properties specified in the column. It will override the default value for this attribute if an Extended Property is present on the item.
  • Default Value column: sets a default value for the attribute/specification for all items listed using this configurator which do not have the mapped Extended Property added.

To map your needed Extended Property to an attribute, select the Extended Property name from the dropdown of the Extended Property column.
mapping extended properties

If you would also like to add Default Values, please check the specifics and examples given here on working with both options at once.


Updating the listing

When your Extended Properties have been mapped, then any new listing templates created with the configurator will automatically pull the data from the needed properties when the template is created.

If you need to add new attributes to existing listings or apply Extended Property mapping to existing listings, then the listings will need to be revised. There are several ways for updating existing listings depending on which templates need to be updated at once. Check the detailed Revising listings guide to apply the option which suits best with the specifics of your update.


Extended Properties vs Default Values

Alongside mapping Extended Property names, you can add Default Values that will be used in the template. In modules where information from Extended Properties can be mapped to an attribute, values from Extended Property will always have a priority over the default value.

  1. If an Extended Property is mapped and a Default Value is also specified, Extended Property value will always take priority over the default value.

  2. If only an Extended Property is mapped and no Default Value is specified, Linnworks will only submit details to the channel for the items with the respective Extended Property added.

  3. If only a Default Value is added to the configurator, Linnworks will submit the specified value to all items listed with the configurator.

  4. If no Extended Property and no Default Value are specified, Linnworks will not send any details to the channel.
Example 1: Configurator > Attributes/Specifications (eBay)

In the  Attributes (Specifications on an eBay configurator) section, you can add item specifications to display on the listing. Some attributes are mandatory, depending on the channel specifics.

The attribute/specification Colour is mapped to the Extended Property "Colour" on the configurator and also has a default value "Green".

ep priority1

Linnworks SKU1 has an Extended Property called "Сolour".

ep priority2

 Linnworks SKU2 does not have an Extended Property with that name.

If you create listing templates for these items using this configurator, Linnworks SKU1 will have the "Colour" value pulled from the Extended Property "Colour" and display "Blue" on the listing template.

ep priority3

Linnworks SKU2 will have the "Colour" value picked up from the default value specified in the configurator and display "Green" on the listing template.


Example 2: eBay Configurator > Main Settings > Condition

 When you create a new listing on eBay, you need to specify the item condition.

ep priority5

Linnworks SKU1 has the Extended Property called "Condition" with value "3000" (Used - See Item Condition IDs and Names for eBay for the accepted values).

ep priority6

Linnworks SKU2 does not have an Extended Property with that name.

When listing templates are created with this configurator:

  • Linnworks SKU1 will have the condition "Used" specified in the Extended Property.
  • Linnworks SKU2 will have the condition "New" taken from the default value.
Example 3: eBay Configurator > Shipping > Shipping Services

You can specify available shipping services in the configurator for eBay. Since the shipping price can be different for items listed with this configurator, it can be specified in Extended Properties and mapped in the configurator; or defined as a default value for all SKUs without an Extended Property.

ep priority7

  • Price Default Value column: sets a default shipping price for the service applicable for all items listed with this configurator.
  • Extended Property column: retrieves a shipping cost stored as an Extended Property on the item. If the Extended Property is not present on the item, the default value will be used.

 Linnworks SKU1 has the matching Extended Property with a value of 3.

EP example3

Linnworks SKU2 does not have an Extended Property with that name.

When listings for the SKUs are created with this configurator: 

  • Linnworks SKU1 will have a shipping price of 3 specified in the Extended Property.
  • Linnworks SKU2 will have a shipping price of 4 taken from the default value.