Think of a family as a blueprint. A Clothing family might require size, color, and material. An Electronics family might require voltage, wattage, and connectivity.
How families work

The order attributes appear in is assigned automatically as you select them, so you do not set it by hand here.
Families also support a per-attribute default value and validation overrides in the data model, but these are not yet editable in the family editor. Set validation on the attribute itself through its attribute settings.
Parent and child families
Families can be nested. A child family inherits every attribute from its parent and can add its own on top. Use this when product types share a common base but differ in the details. For example:- Apparel (parent): brand, material, care instructions
- Tops (child): adds sleeve length, neckline
- Bottoms (child): adds inseam, waist type
- Outerwear (child): adds insulation type, waterproof rating
Create a family
1
Open Product Families
Go to Product Families in the sidebar. You’ll see a table of every existing family.
2
Click New Family
Click New Family in the top-right corner to open the form.
3
Enter the details
Add a name (such as “Electronics”) and a unique code (such as
electronics). Add a description if it helps your team understand the family’s purpose.4
Set a parent (optional)
To inherit attributes from another family, pick a parent. Leave this empty for a top-level family.
5
Assign attributes
Choose the attributes products in this family should have. For each one, set whether it’s required and whether it’s a variant axis. Their order follows the order you select them in.
6
Save
Click Save. The family appears in the table right away.
Assign products to a family
After you create a family, assign products to it so they inherit its attributes.1
Open a product
Open any product from the Products page.
2
Find the Family field
Locate the Family field in the product details.
3
Select a family
Pick the right family from the dropdown. The product inherits every attribute that family defines.
Assign in bulk
To set a family for many products at once, use bulk editing on the Products page. Select the products, choose the bulk edit action, and set the family for all of them.Manage families
The Product Families page lists every family in a sortable table. Use the search bar to filter by name or code.Edit a family
Edit a family
- Click the edit icon (pencil) in the Actions column.
- Update the name, description, parent, or attribute assignments.
- Save your changes.
Delete a family
Delete a family
- Click the delete icon (trash) next to the family.
- Confirm in the dialog that appears.
Work with attributes
Families are built from attributes and attribute groups. Manage both from the Product Families page.Manage attributes
Create, edit, and organize the individual attributes that make up your data model.
Manage attribute groups
Group related attributes for cleaner organization. For example, put “width”, “height”, and “depth” in a “Dimensions” group.
Best practices
Plan your hierarchy first
Map out your product types and how they relate before you build families. A clear plan saves time and avoids duplication.
Keep families focused
Each family should represent one distinct product type. Avoid broad families with dozens of optional attributes.
Mark only essentials as required
Too many required fields slow down product creation. Require only the fields you truly need.
Lean on inheritance
Share common attributes through parent and child families. This keeps your data model lean and easy to maintain.
Troubleshooting
A family doesn't appear in the product form
A family doesn't appear in the product form
- Check that the family saved successfully.
- Confirm the family belongs to the correct project.
- Refresh the Products page to load the latest family data.
Attributes are missing from a child family
Attributes are missing from a child family
- Child families inherit from their parent. Check that the parent has the expected attributes assigned.
- New attributes added to a parent flow down automatically. Refresh the page if they don’t show up.
You can't delete a family
You can't delete a family
- Confirm you have permission to delete families.
- If the family has children, reassign or delete the children first.
Related
Managing attributes
Build the attributes your families are made of.
Managing products
Assign families to products and keep your catalog organized.
Bulk editing
Set a family for many products in one action.
Translating products
Translate product content into your project languages with AI.


