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

| Setting | What it controls |
|---|---|
| Required or optional | Whether the field must be filled in before the product counts as complete. |
| Variant axis | Whether the attribute creates product variants, such as size or color. |
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
Open Product Families
Go to Product Families in the sidebar. You’ll see a table of every existing family.
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.Set a parent (optional)
To inherit attributes from another family, pick a parent. Leave this empty for a top-level family.
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.
Assign products to a family
After you create a family, assign products to it so they inherit its attributes.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.| Column | What it shows |
|---|---|
| Name | The family name, indented to show its place in the hierarchy. |
| Code | The family’s unique identifier. |
| Attributes | How many attributes the family has. |
| Children | How many child families it has. |
| Actions | Edit and delete buttons. |
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.


