Configure

Alternative Products

Statistics

8

total pairs

8

manual alternatives

0

auto alternatives

0

feature rules

Bulk Tools

Global auto-match

Run the matching algorithm for all active products. Uses the selected mode (score or features). Does not overwrite manual alternatives.

Clean auto alternatives

Delete all automatically generated alternatives. Manual ones are not affected.

Recalculate scores

Recalculate similarity score for all existing auto pairs.

Display Settings

e.g. "Alternative Products", "Similar Products", "See also..."

Hide the "Similar products" section (ps_categoryproducts) when alternatives are defined.

If no alternatives are defined, show popular products from the same category.

Auto-Match Engine

Features: matches products from the same category that have the same values for the features defined in rules (e.g. Diameter=16mm). Score: legacy algorithm based on similarity score.

Only for "Similarity score" mode. Recommended: 30-50.

If A→B is added as alternative, also add B→A.

If enabled, products without the required feature values get NO auto-alternatives (no score fallback). Only applies when Match mode = Features.

Hide manually-added alternatives globally. Useful for testing auto-match. Manual entries remain in the database.

Hide out-of-stock products from auto-matched alternatives.

Hide out-of-stock products even if manually set as alternative.

Scoring Factors
Toggle individual scoring components used by the Similarity score algorithm. Factors that are OFF contribute 0 points. Changes require running "Rebuild all auto-match" in Bulk Tools.

Award points when candidate shares the reference product's default category.

Award points for each feature whose value matches the reference product.

+15 if candidate has a different manufacturer; -5 if same. Rewards cross-brand alternatives.

Award points based on price proximity: <10% diff +15, <25% +10, <50% +5, >200% -10.

Award points for each product tag (case-insensitive) shared with the reference.

Award points for each 3+ character word shared between product names (excludes stopwords).

Feature Match Rules 0/8 categories configured
For each category, select the features used for automatic matching. Products from the same category with the same values on the selected features will be shown as alternatives. If a category has multiple features, products must have all of them identical (AND logic). Categories without rules will use the scoring algorithm.
Category Products Matching features Add feature
Art #9 6 unconfigured
Beauty & Care #14 40 unconfigured no features
Electronics #10 40 unconfigured no features
Fashion #11 40 unconfigured no features
Home & Living #12 40 unconfigured no features
Home Accessories #8 8 unconfigured
Sports & Outdoor #13 40 unconfigured no features
Stationery #7 3 unconfigured
When do I need to rebuild auto-match?
These settings require a REBUILD to take effect:
  • Any Scoring Factor switch (Same category, Shared features, Price similarity, etc.)
  • Minimum score threshold
  • Match mode (Features / Similarity score)
  • Strict feature mode
  • Bidirectional
  • Feature Match Rules (add / remove a feature on a category)

After changing any of the above, scroll to Bulk Tools and click "Rebuild all auto-match". The scoring algorithm only runs during rebuild — stored alternatives keep using the OLD settings until you rebuild.

These settings apply IMMEDIATELY (no rebuild needed):
  • In-stock only (auto) and In-stock only (manual)
  • Show auto only (hide manual)
  • Fallback to same category
  • Display settings (title, columns, grid / carousel, max products)
  • Hide &quot;Similar products&quot; block
  • Show price / Show &quot;Add to cart&quot; button

These are applied when reading alternatives from the database, so changes are visible on the next product page view.

Usage Guide (FAQ)

How do I manually add alternative products for a product?

  1. From the Back Office, go to Catalog &rarr; Products
  2. Open the desired product
  3. On the product edit page, click the tab "Modules" (at the top of the page, next to "Basic settings", "Price", "SEO", etc.)
  4. Find the section "Alternative Products"
  5. Type the product name or reference in the search field &rarr; select &rarr; Add
  6. You can change the order with drag &amp; drop
Note: The "Modules" tab is not immediately visible on the product page. You need to scroll horizontally through the top tabs, or look for the "Modules" button that appears after "Shipping", "Options", etc.

How does automatic feature-based matching work?

From this configuration page (section "Feature Match Rules"), define for each category which features are used for matching.

Example: If you add the "Diameter" feature to the "Conduit" category, the module will show as alternatives all products from the same category that have the same diameter value (e.g. all conduits with 16mm diameter).

If you add multiple features, products must have all of them identical (AND logic).

What happens with the "Similar products" section?

When a product has alternatives defined (manual or auto), the "Similar products" section (generated by the ps_categoryproducts module) is hidden automatically. This is controlled by the option "Hide "Similar products"" from the settings above.
If a product does NOT have alternatives, the "Similar products" section remains visible as a fallback.

How do I run automatic matching for all products?

From this page, click the button "Run Auto-Match" in the "Bulk Tools" section. The process will analyze all active products and generate alternatives based on the defined feature rules. Manual alternatives are NOT overwritten.

Recommendation: First define the feature rules for the desired categories, then run Auto-Match.

Can I change the number of displayed products?

Yes, from the option "Max products displayed" in the settings above. The default value is 8. You can increase or decrease it as you prefer.
You can also choose the number of columns (2-6) and the display mode (Grid or Carousel).

What is the difference between manual and automatic alternatives?

Manual: You add them individually on each product from the Modules tab. They have maximum priority.
Automatic: Generated by the algorithm based on feature rules or similarity score. They can be regenerated any time via "Run Auto-Match".
"Delete all auto" deletes only automatically generated alternatives; manual ones remain intact.