PXM Products Hierarchy in Commerce Manager
A hierarchy is a tree structure with a root node and descendant 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. You can set a relationship between a product and a hierarchy.
For more information about hierarchies in Product Experience Manager (EP PXM), watch a video:
Configuring Hierarchies in Elastic Path Commerce Manager
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 the target catalog, the active products in the hierarchies 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 hierarhies and nodes when configuring your products.
- See the nodes that products belong to.
- Create nodes and assign products to nodes.
Creating hierarchies
Create a hierarchy and then create the nodes. Each node can have one parent and multiple children. By default, if you do not specify a parent node for a node, root node is set as the parent of the node by default.
On the Product Experience Manager > Configurations page, click the Hierarchy tab.
On the Hierarchy tab, click Add Hierarchy.
Enter the following information for the hierarchy:
- Name
- Description
- Slug
Click Save.
Next step
- Create nodes in the hierarchy.
Creating nodes in a hierarchy
You can create child nodes only after creating a parent node. Each node can have one parent and multiple children. However, you can have more than one parent node in a hierarchy.
To create nodes in a hierarchy, click the hierarchy.
In the All Nodes section, click Create Parent node.
In the Create Node window, enter the following details for the node:
- Name
- Description
- Slug
Click Create.
To create a child node within a parent node, click the ... icon next to the name of the parent node.
Click Create Child Node.
Repeat step 3.
Click Create.
Click and drag your nodes to a different hierarchy at any time to reorder your nodes, depending on your requirements.
Click Save.
Next step
- Assign products to the nodes.
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. However, any products associated with the nodes in an existing hierarchy are not associated with the nodes in the duplicated hierarchy. Once a duplicate hierarchy is created, you must add your products to the nodes in the duplicated hierarchy.
- On the Product Experience Manager > Configurations page, click the Hierarchy tab.
- On the Hierarchy tab, click the hierarchy you want to duplicate.
- Click Duplicate.
- From Duplicate confirmation, click Confirm to duplicate the selected hierarchy. The hierarchy is created with a name of (Copy) name where name is the name of the hierarchy you selected to duplicate.
- Click the duplicate hierarchy to display the hierarchy details. You can amend the details, depending on your requirements.
Next step
- Assign products to the nodes.
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:
- In the Product Experience Manager > Configurations page: Through this method, you can assign multiple products to a hierarchy and its child nodes.
- In the Product Experience Manager > Products page: Through this method, 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 the Add SKUs field, 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 the + icon next to the product image. The product gets added to the node and is 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 Products.
Click the arrow next to the checkbox on the header row and then click Assign to Nodes.
The Assign to Nodes option is available only when you select appropriate products either by selecting the checkboxes next to the specific products or by applying 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 Products.
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.
Editing nodes
In the All Nodes section, click the node that you want to edit.
Update the following information as required:
Name
Parent Node
(Optional) Description
Slug
Products
You can change the parent node by selecting a node from the node list.
Click Save.
Editing hierarchies
Ensure that you republish the catalog release after editing hierarchies to reflect the changes in the storefront.
- On the Product Experience Manager > Configurations page, click Hierarchy tab.
- Click the hierarchy that you want to edit.
- Update the details as required.
- Click Save.
For the changes to appear in the storefront, you must republish the affected catalogs.
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.
- On the Product Experience Manager > Configurations page, click Hierarchy tab.
- Select the checkboxes of the hierarchies that you want to delete.
- In the Action drop-down menu, click Delete.
You can also click the ... icon in a hierarchy listing and click Delete to delete that hierarchy.
The updates in hierarchies do not appear in the storefront until you republish the affected catalog releases.