What's new in Serenity EE & GE?
Discover our features per version

Heads up! This is the documentation for our Akeneo Serenity Enterprise and Growth editions. Serenity clients benefit from exclusive access to our latest PIM features. If you're interested in other versions, click on the drop down menu on the top right corner or check out everything you need to know about your version.

Manage your measurements

#See all your measurement families

Measurement families are used to store your product information with measurement e.g. weight, length or frequency inside your PIM.

Here are a few definitions to help you understand what we will speak about in this article.

To see all your measurement families, edit them or create a new one, go to the Settings/Measurements menu:

  • Label is the label of a measurement family in the UI locale
  • Code is the identifier of a measurement family
  • Standard unit is the unit used to convert the other units of a measurement family
  • Number of units is the number of units for a measurement family (standard unit included)

List of measurement families

Type in a family code or label in the search bar to find a measurement family. You can also sort measurement family information using the columns in the grid.

#How to create a measurement family?

To create a new measurement family, follow these steps:

  1. Go to Settings/Measurements
  2. Click on Create Create a measurement family
  3. The pop-in to create a measurement family is displayed
  4. Enter the new measurement family code (this code is required and must be unique)
  5. Fill in the label in the current UI locale
  6. For the standard unit used to convert the other units of this measurement family, add the code (this code is required and must be unique), the label in the current UI locale and the symbol
  7. Click on Save

The measurement family is now created and the screen to display and add other units opens.

Measurement family with standard unit

The standard unit is set once and for all.

To guarantee that the PIM is functional and runs smoothly, we defined a volume limitation of 300 measurement families. You cannot create more than 300 measurement families.
If you need more than 300 measurement families, please reach out to our support team and inform them about your use case.

#Edit properties of a measurement family

To edit a measurement family:

  1. Go to Settings/Measurements
  2. Select the measurement family you want to edit in the grid and click on the line or on the edition shortcut
  3. The screen to display the measurement family opens
  4. Translate the labels in the Properties tab and click on Save

Measurement family edit properties

#Manage units in a measurement family

To manage units in a measurement family:

  1. Go to Settings/Measurements
  2. Select the measurement family to edit in the grid and click on the line or on the edition shortcut
  3. The screen to display the measurement family opens on the Units tab

Measurement family units

#Add a unit to a measurement family

If a product attribute is linked to a measurement family, once a unit is created, you will only be able to edit its translated labels and symbol.

Once you are on your measurement family edit form, go to the Units tab:

  1. Click on Add unit
  2. The pop-in to add a new unit to a measurement family is displayed Measurement family add unit
  3. Enter the new unit code (this code is required and must be unique)
  4. Fill in the label in the current UI locale and the symbol
  5. Enter the conversion operations to convert the unit to the standard unit (click on Add new operation to add several conversion operations with their value and mathematical operator, click on the cross to remove an operation)
  6. Click on Add, the screen with all the units opens Measurement family add unit
  7. Translate the labels of the added unit in the Label translations section
  8. Click on Save

The unit is now added.

One conversion operation per unit is required and you can have a maximum of 5 conversion operations per unit.

If you have several conversion operations, the order of the conversion operations is important.
For example, for the Temperature measurement family to convert the Fahrenheit unit to the standard unit Kelvin, you need to define 3 conversion operations:

  1. Subtract 32
  2. Divide by 1.8
  3. Add 273.15

If you have several units to add, you can stay in the Add a new unit pop-in to quickly add as many units as needed:

  1. Enter the first record label
  2. Tick Create another unit
  3. Press Enter
  4. Add the code, label, symbol and conversion operation for each record
  5. Once you've done, press Esc or Echap

To guarantee that the PIM is functional and runs smoothly, we defined a volume limitation of 50 units per measurement family. You cannot create more than 50 units per measurement family.
If you need more than 50 units per measurement family, please reach out to our support team and inform them about your use case.

#Edit a unit in a measurement family

If a product attribute is linked to a measurement family, you will only be able to change the translated labels and symbols of existing units.

Once you are on your measurement family edit form, go to the Units tab:

  1. Click on the unit you want to edit in the list Measurement family edit unit
  2. Edit its symbol
  3. Edit its conversion operations (click on Add new operation to add several conversion operations with their value and mathematical operator, click on the cross to remove an operation)
  4. Translate the labels of the unit in the Label translations section
  5. Click on Save

You can change the following properties of a unit:

  • Symbol: the symbol of the unit
  • Conversion operations: the operations to convert the unit to the standard unit
  • Label translations: the translated labels for the unit for all the UI locales

One conversion operation per unit is required and you can have a maximum of 5 conversion operations per unit.

If you have several conversion operations, the order of the conversion operations is important.
For example, for the Temperature measurement family to convert the Fahrenheit unit to the standard unit Kelvin, you need to define 3 conversion operations:

  1. Subtract 32
  2. Divide by 1.8
  3. Add 273.15 Measurement family conversion

#Delete a unit in a measurement family

If a product attribute is linked to a measurement family, you won't be able to delete its units.

Once you are on your measurement family edit form, go under the Units tab:

  1. Click on the the Delete unit button
  2. Confirm the action from the validation message
  3. Click on Save

The unit is deleted.

#Delete a measurement family

If a product attribute is linked to a measurement family, you won't be able to delete the measurement family.

  1. Go to Settings/Measurements to list the measurement families
  2. Click on the measurement family you want to delete
  3. Click on ... for other actions and then Delete measurement family on the top right corner
  4. Confirm the action from the validation message

The measurement family is deleted with all its units.


Want to find out more? Take a look at these related articles