You are currently viewing documentation for Linnworks Desktop, if you are looking for documentation, click here.

Magento Mapping


The purpose of this tool is to control listings and generate templates for listings that have been created outside of LinnLive. This tool allows you to link non-variant listings with the items in your Inventory; or if the items do not exist in Inventory, mapping tool will let you create new stock items with a click of a button and generate templates for your listings.

Mapping Screen

Left-hand side of the mapping screen displays information about Magento listings. Right-hand side lists inventory items. Maximum 100 listings is displayed per page. To browse through the pages use the bottom part of the screen. Settings button located in the upper left-hand corner lets you select from the following settings (Fig. 1.1):

Do not show mapped listings- excludes mapped listings from the list.

Do not show confirmation messages- disables confirmation prompts.

  Fig 1.1 

Viewing Listings

Drop-down box to the right of the Settings button contains the list of the integrated Magento stores. To show all the listings on a Magento store, select the store you are interested in from the drop-down menu and click Download button.

To narrow down the search use Categories filter, Attribute sets filter or Search field.

All categories drop-down box contains the list of the categories available on the selected Magento store and is used for filtering purposes. All attribute sets drop-down box contains attribute sets created on the selected Magento store an can be used for filtering purposes. It is possible to search listings by Title by entering it in the Search field. Once the filter criteria have been selected, click Download for the listings to be displayed.

Magento listings will appear on the left-hand side of the screen. System will display listing SKUName of the listing, Set of attributesCategoriesStatus. For listings with NOT_MAPPED status Match (by how many per cent the configuator suits the listing) and Configurator cells will also be filled.


Each listing will have one of the following statuses assigned to them (Fig. 2.1):

MAPPED - mapped with template.

NOT_MAPPED- mapped with inventory item in Linnworks or not mapped at all.

  Fig 2.1 

Working with listings

In order for single-item listings to get displayed, Work with listings setting needs to be selected. Double click the row for each not mapped listing for the system to attempt to find the matching stock item in the Linnworks inventory that will appear on the right-hand side of the screen, or click Prepare for the system to attempt to find a relevant configurator and matching stock item in the Linnworks inventory.

After clicking Prepare, listing status will change to READY_FOR_MAPPING (Fig 3.1). 

This status means that system has prepared this listing and it can be linked with a Linnworks inventory item, or a new Linnworks item can be created, if system has not found any matches. 

During preparation system will attempt to find among existing configurators those that suit the selected listing, as well as offer to create a brand new configurator. The configurators will be available in the drop-down menu.

  Fig 3.1 

If none of the suggested configurators suit, select -- Create new configurator-- option available in the bottom of the drop-down box and click Edit to give the new cnfigurator a name. When selecting a configurator, check the Match column to see by how many per cent this configurator suits the listing.

Inventory item matching the listing will be displayed on the right-hand side. Select the item and click Link to generate a template and perform linking. If the item found by the system and displayed on the right-hand side of the screen is not the one the listing should be linked with, click Create button in the left-hand side of the screen to create a new stock item and link it with the selected listing.

If no inventory item identical to the listing has been found, then right-hand side of the screen will be empty. In this case you can search for already existing Linnworks items and link one of them with the listing or create a new stock item. Use the Search option on the right-hand side to look for items. (Fig ...) Search on the right-hand screen can be performed by SKU, item title or variation group name which have to be entered exactly as they are written in Linnworks. If you find an item identical to the listing, click Link button on the right-hand side of the screen. From the drop-down list select the configurator.


Listing Right-click Menu

Right-clicking Listing status on the left part of the mapping screen brings up a menu with the following options for listings with NOT_MAPPED status:

Copy - copies the cell content.

Find listing in inventory - does the same as double clicking the listing, looks for a matching Linnworks inventory item and if finds, displayes it on the right-hand screen.

Prepare listing for mapping - does the same that Prepare button, attempts to find a relevant configurator and matching stock item in the Linnworks inventory.

Create new stock item - creates new Linnworks item.

For listings with MAPPED status:

Copy - copies the cell content.

Unlink listing from inventory - unmaps the listing.


Note: Magento variations mapping is not supported by LinnLive.