Products Hierarchy in Commerce Manager
A hierarchy is a tree structure that consists of a root node with one or more parent nodes. Each parent node can also have one or more children nodes, and so on, creating a parent-child relationship between nodes.
A product can belong to multiple nodes in multiple hierarchies. When you create a catalog, you specify one or more hierarchies. Any products associated with those hierarchies are included in the catalog.
If your store supports multiple languages, you can localize new and existing hierarchies and nodes.
The following example of Elpa basketball shoe for men shows different hierarchies and nodes that the product might be in:
- Brands > Elpa
- Shoppers > Men
- Shoes > Sports > Basketball
The root of a hierarchy specifies the aspect of the product data that the hierarchy displays. For example, root can be categories, brands, types, or manufacturers of the products. You cannot assign products to a root node.
A node in a hierarchy contains products grouped in a specific theme, such as a products from a specific brand.
Hierarchies and Catalog Releases
A catalog configuration includes one or more hierarchies of products. Any products associated with those hierarchies are included in the catalog. When you publish a catalog, all products whose status are live
appear in the catalog release. If you update a hierarchy to add, move, or delete nodes, you must republish the catalog for the changes to appear in the storefront. You can configure your hierarchies and nodes when configuring your products.
See the nodes that products belong to.
Create nodes and assign products to nodes.
Creating Hierarchies
A hierarchy is a tree structure that consists of a root node with one or more parent nodes. Each parent node can also have one or more children nodes, and so on, creating a parent-child relationship between nodes.
Create a hierarchy and then create the parent/child nodes.
You can either:
- Go to Product Experience Manager > Products and click All Products.
- Go to Product Experience Manager > Configurations and, click the Hierarchy tab.
Click Add Hierarchy or Create new hierarchy, depending on where you are in Product Experience Manager.
Enter the following information for a hierarchy:
Name Required Description Name Required The name of the hierarchy. Description Optional A description of the hierarchy. Slug Optional A slug for the hierarchy. Click Save.
Creating Parent/Child Nodes
A hierarchy is a tree structure that consists of a root node with one or more parent nodes. Each parent node can also have one or more children nodes, and so on, creating a parent-child relationship between nodes.
You must create a parent node first, then create your child nodes.
You can either:
- Go to Product Experience Manager > Configurations and, click the Hierarchy tab.
- Go to Product Experience Manager > Products and click All Products.
To create:
- parent nodes in a hierarchy, click the hierarchy.
- child nodes in a parent node, click the parent node.
Click Create new node or Create Child Node, depending on where you are in Product Experience Manager.
Enter the following details for a node:
Name Required Description Name Required The name of the node. Names must be unique among sibling nodes in the hierarchy. Otherwise, a name can be non-unique within the hierarchy and across multiple hierarchies. Description Optional A description of the node. Slug Optional A slug for the node. Slugs must be unique among sibling nodes in the hierarchy. Otherwise, a slug can be non-unique within the hierarchy and across multiple hierarchies. Weight Optional Enter a value to determine the order that nodes are displayed in your storefront. The node with the highest value is displayed first. The weight value must be greater than or equal to one. For example, 1, 2, 3, or 100, 90, 80, and so on. - If you don’t provide a weight, child nodes are displayed in the order they were last updated, with the most recently updated child node displayed first.
- If you set a weight for only a few child nodes, the child nodes with a weight appear first and then other child nodes appear in the order they were last updated.
Locales Optional If you have activated any languages for your store: - From the Locale list, select the language you want to use to localize your node details. You can activate and deactivate languages in Commerce Manager. You can activate a maximum of five languages. See Using Locales in Commerce Manager.
- Add a localized node name and description.
Click Create.
Click and drag your nodes to a different hierarchy at any time to reorder your nodes, depending on your requirements.
Duplicating Hierarchies
You can duplicate an existing hierarchy. This is useful because it enables you to quickly and easily create multiple hierarchies with the same node structure.
When you duplicate a hierarchy, you can specify a new name and/or a new description for the duplicated hierarchy. All other attributes, such as slug and locales, stay the same.
Any nodes in the existing hierarchy are also created in the duplicated hierarchy. In addition, you can specify whether you want products associated with the nodes in an existing hierarchy to be associated with the nodes in a duplicated hierarchy.
You can either:
- Go to Product Experience Manager > Configurations and click the Hierarchy tab.
- Go to Product Experience Manager > Products and click All Products.
Click the hierarchy you want to duplicate.
Click Duplicate or Duplicate Hierarchy, depending on where you are in Product Experience Manager.
(Required) In Name, enter a new name for the duplicated hierarchy.
(Optional) In Description, you can keep the existing description or enter a new description.
(Optional) Turn on the Retain a products relationship toggle to keep the products associated with the nodes in the existing hierarchy associated with the nodes in the duplicated hierarchy.
Click Confirm to save your changes.
Assigning Products to Nodes
You can assign products to hierarchies and their child nodes. This determines how the products are displayed in the shopping catalog of your storefront. For example, a Nike basketball shoe for men can be assigned to the following hierarchies and nodes:
- Brands > Nike
- Shoppers > Men
- Footwear > Sports > Basketball
You can assign products to nodes in the following ways:
- On the Product Experience Manager > Configurations page, you can assign multiple products to a hierarchy and its child nodes.
- On the Product Experience Manager > Products page, you can assign products to multiple hierarchies and their child nodes.
Assigning products to a node
- To add products to a node in a hierarchy, click the hierarchy.
- In the All Nodes window, click a node.
- In Add SKUs, enter a SKU number to search for a product. The product corresponding to the SKU number is displayed.
- To add the product to the node, click + next to the product. The product is added to the node and displayed in the list of products associated with the node.
Assigning products to multiple nodes
On the Products page, select appropriate products or apply a filter to select appropriate products. See Filtering.
Click the arrow next to the checkbox on the header row and then click Assign to Nodes.
The Assign to Nodes option is only available once you have selected the checkboxes next to the specific products or applied a filter.
The Assign your Products to Nodes window appears.
Click the arrow next to the hierarchy and the child nodes that you want to assign to your products.
Select the checkboxes next to the nodes that you want to assign to the products.
Click Next.
Click Confirm.
On the Products page, the hierarchies and their children nodes are displayed in a tabular format. Click the eye icon next to a node to view details of the products assigned to the node.
Dissociating products from multiple nodes
You can dissociate products from multiple hierarchies and their nodes.
On the Products page, select appropriate products or apply a filter to select appropriate products. See Filtering.
Click the arrow next to the checkbox on the header row and then click Unassign from Node.
The Confirm your Unassignment window appears.
Click Confirm.
Deleting hierarchies
When you delete a hierarchy, the hierarchy and all its descendant nodes are deleted from the database. The products that were associated with the hierarchy remain in the database and can be used with other hierarchies.
You can either:
- Go to Product Experience Manager > Configurations and click the Hierarchy tab.
- Go to Product Experience Manager > Products and click All Products.
Select the checkboxes of the hierarchies that you want to delete.
In the Action list, click Delete.
You can also click ... next to a hierarchy and click Delete to delete that hierarchy.
The updates in hierarchies do not appear in the storefront until you republish the affected catalog releases.
Deleting Parent/Child Nodes
When you delete a parent/child node, the parent/child node and all its descendant nodes are deleted from the database. The products that were associated with the parent/child node remain in the database and can be used with other hierarchies and parent/child nodes. If you want to keep the child nodes, change the parent for each child of the node you want to delete before deleting the node.
You can either:
- Go to Product Experience Manager > Configurations and click the Hierarchy tab.
- Go to Product Experience Manager > Products and click All Products.
Select the hierarchy that the parent/child nodes you want to delete belongs to.
Navigate to the node that you want to delete.
Select the checkboxes of the parent/child nodes that you want to delete.
In the Action list, click Delete.
You can also click ... next to a parent/child node and click Delete to delete that parent/child node.
The updates do not appear in the storefront until you republish the affected catalog releases.