All courses

Product families

How to create a family, choose its attributes and which ones are required, and give it to one product or to every product in a filter.

What is a product family and what is it for?

A family says which attributes belong to a type of product and which of them are required. It lives in Catalog → Families. Attributes don't belong to the family: the same attribute can be in several families, required in one and optional in another. A product without a family uses every attribute in the catalog.

The family decides what a product is missing: its required attributes count toward completeness (the guide “Attributes and families” explains how that number is calculated). Also, “Fill with AI” on a product record only suggests the attributes of its family.

  • A read scope can be limited by family (guide “Scopes: what each person sees and writes”).
  • In Images by destination, the brand rule and each format can apply to some families only (guide “Images by destination”).
  • A supplier's bulk upload template comes from a category with its own family (guide “Supplier bulk upload”).

How do I create or rename a family?

In Catalog → Families, type the name in “New family” and click “Create family”. It starts empty, with no attributes. To rename it, click its name, type the new one and press Enter; Escape cancels.

Next to the name you see its code, which comes from the name when you create it and never changes, and how many attributes and products it has. Two families can't share a code: if the new name gives the code of another family, the screen says that a family with that name already exists.

Creating, renaming, changing the attributes of and deleting a family takes Operator or higher. A Viewer or an Editor sees the screen, but their changes aren't saved. A supplier doesn't see it.

How do I choose a family's attributes and which ones are required?

On each family, “Edit attributes” opens the list of every attribute in the catalog, each with a checkbox. Tick the ones that apply; when you tick one, “Required” appears next to it. Each checkbox is saved right away, with no save button.

Attributes aren't created here: if one is missing, create it in Catalog → Attributes and come back. When you change the required ones, the completeness of every product in the family is recalculated in the background, so each record's number may take a little while to move.

If your organization has technical documents, the same family shows “Files it requires”: each file type you tick, up to 10, counts as one more required item in the completeness of the family's products (guide “Technical documents”).

How do I give a family to one product or to many at once?

To one: on its record, tab “Attributes & family”, choose the family in the “Family” selector. It's saved when you choose it. “No family” removes it, and the product goes back to using every attribute in the catalog.

To many: in Catalog → Products, apply a filter (a search, a brand, the “Family” selector set to “No family”…) and “Assign a family to the N products in this filter” appears. Choose the family, click “Assign” and confirm. If a product already had another family, it's replaced by this one. Without a filter it isn't offered: it's not meant for the whole catalog by accident.

It goes in batches of 1,000, so keep the tab open until it finishes. If you click “Stop” or it gets interrupted, assign again: it continues with the products that don't have it yet.

A category can also give its “Default family” to the products without a family that enter it (guide “Categories”).

Setting or removing a product's family takes Editor or higher, and every product that changes saves a version in its history.

How do I delete a family?

On the family, click “Delete” and then “Confirm”. Only a family without products can be deleted: if any product has it, the screen asks you to remove it from them first.

To remove it from many products, filter Catalog → Products by that family and give them another one with “Assign”; for a single product, choose “No family” on its record. Deleting the family doesn't delete its attributes: they stay in the catalog and in the other families.

How many families and attributes can I have?

  • Up to 50 families per organization.
  • Up to 100 attributes in each family, chosen from the catalog's attributes.
  • Up to 10 required file types per family, if you have technical documents.