Skip to main content

Product links

On the "Relations" tab of products, you can set up attribute-based links for catalog or multimedia elements. This means you can link products by a specific criterion, for example, set up a link for all black phones.

Main interface elements​

Created links are listed in a table with three columns:

  • "Name": the link name
  • "Marker": the unique unique identifier that can be used to retrieve the entity of the link
  • Actions column (no header): actions available for each link:

    • eye

      Hide: hides the link from users of your site or application but does not delete it from the admin panel.

    • edit

      Change: opens the link editing page.

    • remove

      Delete: deletes the link.

The link creation form has two input fields:

  • "Name": required. Enter the link name.
  • "Marker": required. Enter a unique unique identifier that can be used to retrieve the entity for the link (only Latin letters and the "_" and "-" characters are allowed).

It also has an "Add" button, which adds the link if the values in the "Name" and "Marker" fields are valid.

Click "Change" to open the editing page of a link. The page has the following blocks:

  • Editing the "Name" field
  • Editing the "Marker" field
  • Creating conditions for the link
  • List of added conditions
  • List of catalog items found by the specified conditions

The block for creating link conditions has three input fields:

  • "Attribute": a dropdown list for selecting the attribute to search by, from all created attribute sets of catalog items.
  • "Condition": a dropdown list for selecting the search condition. Available filters:
    • contains
    • does not contain
    • equal to
    • not equal to
    • more
    • less
    • contains any value
    • does not contain a value
    • value based on the pattern - используйте маску вида: **-**, где * означает любой символ
    • the same value as the selected attribute
    • same value of the attribute part (truncated value)
  • "Value": an input field for the value the condition is created with.
  • "Non-indexed products" checkbox: selects only catalog items that have not been indexed yet. While it is selected, the condition fields are hidden.
  • "Categories": selects the or screens of the Catalog type to search with the specified condition. It has a field for quickly finding or screens and a list of all or screens. If nothing is selected, the search covers all or screens of the Catalog type.
  • Buttons:
    • "Add": adds the condition
    • "Reset": resets the current data in the condition creation block
    • "Reset all": resets the current data in the condition creation block and deletes all previously created conditions
    • "Copy filter": copies the specified condition parameters to the clipboard as JSON

List of added conditions​

When you add a condition, it appears in a table below the condition form. The table has 6 columns:

  • Attribute: the attribute name and unique identifier that can be used to retrieve the entity
  • Condition: the condition the attribute was selected by
  • Value: the value the attribute was selected by
  • Category: the categories the attribute was selected by
  • Products found: the number of attributes found by the specified condition
  • Content language code (short): the content language (opens in a new tab) of the attribute

Each row of the table has a button that deletes the condition:

edit

Below the table, a "Show found" button appears. It displays the catalog items that match the specified condition. The button appears only if the condition finds at least one catalog item.

At the bottom of the page are two buttons:

  • "Save": saves the link but keeps it hidden. You stay on the link editing page.
  • "Save and activate": saves and activates the link, making it visible within your system, and takes you to the Product links page with the list of created links.
Product links

A catalog item can fall under several links; links do not exclude each other. For example, if you set up a link for all black phones and another for all white phones, the "Cross-selling and upselling" tab shows both black and white phones.

Conditions of catalog item links

You can add several conditions to one link. Keep this in mind: unlike the links themselves, the conditions of one link are mutually exclusive.

Last updated on