Walkthrough of matcher options

  • Updated

Introduction

TRADE’s image importer includes a wide range of configuration options that help control how product and variant images are matched. This guide explains each setting, with examples to help you decide how and when to use them.

 

 

Overview of image importer options

Below is a breakdown of each configuration setting in the image importer, including what they do and when to use them.

🔹 ISO number separator

  • Defines how TRAEDE should split the filename to separate the product (ISO) from the variant.

  • Example filename: 577_black.jpg

    • Recommended: use _ (underscore) as it’s rarely used in ISO numbers.

  • Avoid using characters (like -) if they are commonly found in your ISO numbers.

🔹 Ignore separator

  • Used to split the variant value (e.g. color) if the filename includes an additional separator.

  • Default: -

  • Example filename: 577-black-main.jpg

    • - is used to isolate black for matching.

🔹 Attribute match name

  • Matches the middle part of the filename to a variant attribute name (e.g. Color).

  • Example: If your variant is named "Black", and the filename contains "Black", it will be matched.

🔹 Attribute match code

  • Allows matching based on attribute codes instead of names.

  • You must define a code in Settings → Attributes.

  • Example: If your color "Black" has the code 1000, the image file should include 1000.

🔹 Fixed length separator

  • Use if your ISO numbers always have a fixed number of characters.

  • TRAEDE will use that fixed length to identify the product number.

  • Example: If ISO is always 12 characters, enter 12.

🔹 EAN match mode

  • Matches images to products by EAN only (filename should be the EAN).

  • Best for products without variants.

🔹 SKU match mode

  • Matches images to products by SKU only.

  • Also best used when no variant mapping is needed.

🔹 Match variants

  • Toggle on/off whether images should be matched to variants or just the product.

  • Disable if:

    • All variants have the same image

    • Your filenames don’t include any variant info

🔹 Purge existing images

  • ❗ DANGEROUS OPTION

  • Replaces all existing images on matched products.

🔹 Replace images with the same filename

  • Replaces only images that have the same filename as existing ones.

  • Safer than purging all images.

🔹 ISO number first occurrence

  • Use when filenames contain multiple separators (e.g. -) and you want to split at the first one.

  • By default, TRAEDE splits at the last separator.

  • Enable this option if the ISO number appears before other parts like color codes.

 

Item number separator 577004_Black-1.jpeg
Attribute match name 577004_Black-1.jpeg
Attribute match code 577004_1000-1.jpeg
Ignore separator 577004_1000-1.jpeg
Fixed length separator 577004_1000-1.jpeg (first X characters before separating)
EAN match mode 5712142190215.jpeg
SKU match mode 577004-100-XS.jpeg
Match variants Should we attempt to match images to variants
Purge existing images Remove all existing images on the product
Replace images with same filename If an image exists on the product with same filename then replace it
Item number first occurrence 577-004-Black_1.jpeg

Was this article helpful?

0 out of 0 found this helpful