Changelog - Linked Products
All notable changes to Linked Products are documented in this file.
The format is based on Keep a Changelog.
[1.0.2] - 2026-11-03
The 1.0.2 release adds a permission check to native exports and a --strict option to the CLI import. It fixes product saves that failed on a taken group name and exports that emptied a group on re-import, and speeds up the duplicate name check of imports.
Check Admin Roles Before You Upgrade
Exporting Linked Product Groups from System → Data Transfer → Export, and downloading or deleting their export files, now requires the Linked Product Groups view permission as well as Export. Grant it to the admin roles that need these exports. See Export Permissions.
Added
--strictoption forbin/magento hyva:linked-products:import: when validation finds any error, the whole file is refused, nothing is written, and the command exits with an error code. Without it, rows with errors are skipped and the rest is imported, as before. See Importing and Exporting Linked Product Groups from the CLI.
Security
- Native Linked Product Groups exports check the Linked Product Groups view permission when the export is requested and when an export file is downloaded or deleted, including files generated by another admin. Before, an admin with only the Export permission could export every group and download or delete the files. The grid's Export to CSV action and the CLI export are unchanged.
Fixed
- Saving a product from the Product Edit page no longer fails with "Unique constraint violation found" when the name of the group it creates is taken, even with the product ID added. The product ID is then followed by a number, from
(2)to(20), and a long name is shortened to fit 255 characters. If all of these names are taken, the group is created without a name and the product still saves. See Linking Products to the Product You're Editing. - Imports check a file for repeated group names with one database query per row. Before, every row was compared with each earlier row, one query per pair, so large files took much longer to check.
- Exports no longer write groups without products, in any export, including groups ticked in the grid. Before, importing an unnamed group's
Group #<group ID>row left the original group without products, the next export listedGroup #<group ID>twice, and importing that file emptied the new group. - A group without a name is exported under a name no other group has. Before, its
Group #<group ID>name could be another group's, for example one created by importing another store's export, and importing the file replaced that group's products. The name now gets a number when it is taken, fromGroup #12 (2)up to(20). See The Linked Products CSV Format. - The Export screen no longer offers filters for
skusandlink_attributes, which the export ignored. Onlygroup_namecan be filtered; the other columns can still be excluded. - The CLI import copies the file in parts instead of reading it into memory, so PHP's memory limit no longer caps the size of the file it can import.
- The import's permission messages, "You do not have permission to save linked product groups." and its delete counterpart, can be translated. Before, the words save and delete were inserted into one English sentence.
bin/magento hyva:linked-products:dedupe-group-names --fixclears duplicate blank group names, leaving those groups without a name, instead of renaming them to- #<group ID>. Only stores upgrading from0.1.0can have more than one group with a blank name.
[1.0.1] - 2026-11-02
The 1.0.1 release fixes permission checks, group saves, import notices, and swatch styles. It adds no features.
Check Admin Roles and Integrations Before You Upgrade
Changing groups from the Product Edit page now requires the Linked Product Groups create/edit permission. On Adobe Commerce, imports of Linked Product Groups through the REST API now check the token's Linked Product Groups permissions, and asynchronous REST imports of Linked Product Groups are refused. Grant these permissions to the admin roles and integrations that need them, and move asynchronous imports to the CLI import or a Scheduled Import run by cron. See Import Permissions.
Products Left Alone in a Group Leave It on Their Next Save
In 1.0.0, saving a product that is the only one left in its group, for example after the other products were deleted, kept it in the group. In 1.0.1, saving such a product from the Product Edit page without adding linked products takes it out of the group, if you have the Linked Product Groups create/edit permission. Its Linked Products section warns about this before you save. Saves from REST, Update Attributes, product imports, and Scheduled Updates keep it in the group. See When the Product Is the Only One Left in Its Group.
Rebuild Your Theme CSS
The swatch styles changed. After upgrading, rebuild your Hyvä themes' styles. See Generating CSS.
Security
- The Linked Products section on the Product Edit page checks the Linked Product Groups permissions. Before, any admin who could edit products could create groups, change their products and link attributes, and add copies to groups from it. The section is now editable with create/edit, read only with view alone, and hidden without either. Save & Duplicate by an admin without create/edit leaves the copy out of the original's group, and a notice says so.
- On Adobe Commerce, Linked Product Groups imports through
POST /V1/import/csvandPOST /V1/import/jsoncheck the token's Linked Product Groups create/edit permission for Add/Update and delete permission for Delete. Before, a token with only the import API permission could create, change, and delete groups. Only the CLI import and imports Magento runs by cron skip the check. Imports run anywhere else without a user to check, such as the asynchronous REST endpoints, are refused.
Fixed
- Removing every row from the Linked Products section, then saving the product, takes the product out of its group, as documented. Before, the product stayed in the group. A notice names the group it left.
- Saving a product that is the only one left in its group from the Product Edit page, without adding linked products, now takes it out of the group, and its Linked Products section warns about this beforehand. Save & Duplicate keeps it in the group and adds the copy. See When the Product Is the Only One Left in Its Group.
- When another save puts one of the same products into a different group at the same time, the group form names the products that are now in another group, instead of saying that the group name is taken.
- Check Data on the Import screen lists at most 100 rows for products moved from another group, and 100 for colliding members, then the number of rows left out. Products moved from another group are no longer listed twice when the file has an error.
- Hyvä themes on Tailwind 3 (Hyvä 1.3) no longer fail to build their CSS on the Linked Products swatch styles.
- Image swatches are round on Hyvä 1.4 themes too.
[1.0.0] - 2026-10-12
The 1.0.0 release adds bulk transfer, a storefront switch, and warnings for products shoppers can't reach, and makes group saves safer.
Group Names Must Be Unique Before You Run setup:upgrade
Group names are now unique, ignoring case. If your store has groups that share a name, bin/magento setup:upgrade fails on the HYVA_COMMERCE_LINKED_GROUP_GROUP_NAME index. The command that resolves this comes with 1.0.0, so run it after updating the code and before bin/magento setup:upgrade: bin/magento hyva:linked-products:dedupe-group-names lists such groups, and rerunning it with --fix renames all but the oldest group of each name, or with --remove deletes them. Both ask for confirmation and default to No. In a deploy script, add --force (-f), or the command prints "Aborted" and exits with an error. Without --fix or --remove, the command also exits with an error while duplicates remain, so a deploy script stops before setup:upgrade.
Rebuild Your Theme CSS When You Upgrade
Color swatches now take their size and color from a style rule that is compiled into your Hyvä theme's CSS. After upgrading from 0.1.0, run bin/magento hyva:config:generate and rebuild every Hyvä theme's styles, even if you rebuilt them for 0.1.0. Until you do, color swatches render as empty circles. See Generating CSS.
Added
- CSV import and export of Linked Product Groups as a Magento import and export entity, Linked Product Groups under
System → Data Transfer, with an Export to CSV mass action in the Linked Product Groups grid and thehyva:linked-products:importandhyva:linked-products:exportcommands. Imports support Add/Update and Delete behaviors and a dry run, and move products out of other groups. See Importing and Exporting Groups. hyva:linked-products:dedupe-group-namescommand to list, rename, or delete groups that share a name.- Enabled setting under
Stores → Settings → Configuration → Hyvä Commerce → Linked Productsto show or hide linked products on the product page per website or store view. See Configuring Linked Products. - Unreachable product marks in the group form, the Product Edit page, and both Add Products panels, plus a banner on the Product Edit page. See Unreachable Products.
- CSV imports warn when products in a group that are on the storefront share the same option for every link attribute, by the same rule as the unreachable marks.
- Link Attributes column in the Linked Product Groups grid.
Changed
- Group saves are validated and applied in a single transaction. A refused save returns to the form with your changes and the reason, such as a missing name, fewer than two products, or products that already belong to another group.
- Group names are unique, ignoring case. The group form refuses a name another group has, and a group created from the Product Edit page gets the product ID added to its name when the name is taken.
- Removing products from a group on the Product Edit page no longer deletes a group left with fewer than two products. No group is deleted automatically, including when a product is deleted.
- The storefront layout moved from
catalog_product_view.xmlandcatalog_product_view_type_configurable.xmlto thehyva_linkedproducts_enabledandhyva_linkedproducts_enabled_configurablehandles. Update theme layout XML that referencesproduct.info.linked. See Customizing the Product Page Output. - Prices in the admin product tables are formatted with the currency, such as
$63.00, and sort numerically. - Color swatches only accept hex color values.
Hyva\LinkedProducts\Api\LinkedGroupProductRepositoryInterfacegainsaddDuplicateToOriginalGroup(), andgetOrCreateGroupId()takes an optional$groupNameargument.Hyva\LinkedProducts\Api\LinkedGroupAttributeRepositoryInterfacegainssaveAttributeIdsForGroup(), which the CSV importer calls. A custom implementation of either interface, or a preference for it, must add them.
Fixed
- Linking products from the Product Edit page names the new group after the product.
- Saving a configurable product no longer copies its link attributes or linked products to its child products.
- Product saves that don't come from the Product Edit page form, such as REST, no longer change grouping.
[0.1.0] - 2026-07-28
The 0.1.0 release for Linked Products is the initial (beta) release.
Added
- Ability to assign/unassign multiple attributes to Linked Groups
- Ability to add/remove multiple products to Linked Groups
- Ability to filter out products based on assigned attributes
- Frontend UI to present Linked Groups on Product Detail Page