Instructions for Product Name by Characteristics

What the add-on does

The add-on builds a product name from selected features and, if needed, adds the item code or the saved old product name. The final name is written to the standard product name field.

The add-on stores the original product name in a backup field, so the administrator can restore the name of a single product or perform a bulk restore of old names.

Where to find the add-on

Add-ons → Manage add-ons → Product Name by Characteristics — general add-on settings.

Products → Features → edit a feature — settings that define whether the feature is used in product names.

Products → Products → edit a product — the “MS: Product name from the specification” block with the old name and restore button.

Administration → Export/Import → Product import — name generation after import, if the corresponding setting is enabled.

General settings

Enable compilation of the product name from the characteristics — enables automatic name generation.

Add article to product name — adds the product code to the final name.

For article use — selects the source of the item code: the standard product code or manufacturer code when it is available through a compatible add-on.

Item position — defines where the item code is placed relative to feature values. Positions are sorted in ascending order.

Ignore characteristics used by a variation group — excludes variation group features from the final name.

Leave the old product name — adds the saved original product name before the generated feature values.

Pull up the name of the product from the exchange — during import, uses the imported product name as the base and then adds feature values.

Formation of the product name during import — runs name generation after product import.

Prohibition of editing the product name field — prevents manual editing of the standard product name field in the admin panel.

Product name by default, when creating — the value inserted for a new product when the product name field is locked.

Feature setup

Open the required product feature and enable Use in product name if this feature value should be included in the product name.

Set Position in the product name. Features with lower numbers are placed earlier.

If needed, define a Prefix symbol before the feature value and a Postfix symbol after the feature value.

Prefix and postfix values are stored in the feature description for each language separately, so check the settings for every language used in the store.

Product name generation

When a product is saved, the add-on collects marked features, sorts them by position, and joins the values into one string. If a feature variant has an SEO variant value, the add-on uses it; otherwise it uses the regular feature value.

If item code insertion is enabled, the code is placed in the configured position. If keeping the old name is enabled, the original product name is used as the beginning of the final string.

Product import

If Formation of the product name during import is enabled, the add-on rebuilds product names after product import. With Pull up the name of the product from the exchange enabled, the add-on uses the imported name and then adds feature values.

Restoring names

The product editing page contains a block with the old product name and a restore button. The button restores the saved old name for the current product.

The add-on settings contain a bulk action to restore old product names. It returns saved old names for all products where the backup field is filled. Before a bulk restore, make a database backup or test the action on a staging copy.

How to check the result

Enable the add-on and the name generation setting.

Open a feature, enable its usage in the product name, and set its position.

Open a product with this feature and save it.

Check that the product name has changed according to the configured order.

If the item code is used, check its position in the final name.

If import is used, import a test product and make sure the name is generated after import finishes.

Check the restore button on the product editing page and, if needed, the bulk restore action in the add-on settings on test data.