Parent/Child items are a feature of Commerce5 that will allow you to group multiple regular items onto the same product page either as Grouped or Configurable items.

This can be very helpful for items that have not been set up as gridded items in Counterpoint but should be shown like gridded items on the website.

Configuring the Child item

Since the attributes for the child items have not been defined in the grid, we have to define them manually in the Custom tab. 

By default we add Color and Size attribute fields to the form, but we can create fields for any attribute you might need for your website.

To add the attributes, follow these steps:

1. Navigate to the Custom tab in the item record of the item you'd like to turn into a child item.

2. Enter a value for the first attribute ( in this case, we defined the Color as "Blue"). If the value hasn't been used before, you may have to add it.

Click the Search icon then "Add" to create a new attribute. Enter a code and Description for the attribute ( Description is what will show to the customer on the front end of the website).

    3. Click Save.

    4. Enter a value for any other attributes, if applicable.

5. If desired you can use the color filter to assign a "Color Family" used for searching and navigation. This can be helpful if your color is unique and wouldn't otherwise show up in a specific search. For example, if your product's color was a shade of pink called "Flamingo" you could enter "Flamingo" as the Color and "Pink" as the Color Filter value. Then when searching for pink items on the site, your Flamingo colored product would show up in the search results.

6.Create the Parent item by clicking the search icon in the Parent Item # field. If the "Parent Item #" field isn't present in your custom tab, contact Red Rook Support to have it added.

7. Click the search button and click Add. This will bring up the Parent Item form where you can set up the new Parent Item.

Creating the Parent Item

  1. Enter a Parent Item number. 
    Note: This can be any unique number you want. Sometimes it makes more sense to name the parent item similarly to its child items, or you can start with an arbitrary number and increment new parent items sequentially.
  2. Give the Parent Item a name. This is what will show as the product name on the website. It should not say any of the attribute values that the children items might have (green, small, etc.)
  3. Choose an attribute set. (This is almost always Default unless you use different attribute sets on the web)
  4. Enter a value for Grid Dim 1. This is what the header of the dropdown will be on the website (Color, Size). 
  5. Enter a value for Grid Dim 2,3, or 4 (if applicable)
  6. Enter a Description, which will be used as the html description for the product, and any other information shown in the form relevant to the Parent Item.
  7. Click Save. Now the value for Parent Item should show the Parent Item number you just created. 
  8. Repeat the above steps for other child items, assigning the appropriate attribute values to add other options.

-Note: Parent Item images are determined just like regular item images. The item will need an image named like parentitemnumber.jpg. You can either create/ assign a new image or copy a child image and rename it to match the parent item number

You have now created a Parent/ Child item. When these products are synced with the website, they will be created as configurable items.