How to manage a reference data list

Create a reference data list, add and sort its values, and delete it when you no longer need it. You need access to the ReferenceData administration area. Some lists are used by openlane itself and must be edited with care: they are listed at the bottom of this page.

Create a list

1. In the menu, select Admin, then Reference data.
2. Click Add new.
3. In Key, enter the list key. You cannot change it once saved.
4. Click New value for each value and fill in:
   • Key: the value key stored in products. You cannot change it once saved;
   • Description: the text users see, which is the same in all languages;
   • Sort order: the value's position in the list.
5. Click Save.

A key, description and position are required for each value. openlane does not check that the list key is unique: before creating a list, check that no list with the same key already exists.

To use the list in an attribute, link it in the attribute configuration, as described in How to configure an attribute.

Edit values

1. In the Reference data list, click the Edit icon in the list's row.
2. Edit Description and Sort order, add values with New value, or remove values you no longer need using the Remove icon.
3. Click Save.

When there is more than one value, Sort by key and Sort by description appear. These sort the values alphabetically by key or description. Sorting uses the saved list and reloads the page: save any other changes first, or they will be lost.

Delete a list

1. Open the list, remove all its values using Remove, then click Save.
2. In the Reference data list, click the Delete icon in the list's row and confirm.

You cannot delete a list that still contains values: the message Unable to delete reference data because there are some values inside appears.

Lists used by openlane

openlane identifies these lists by their key. Their values depend on your installation and can be updated, but you must not delete or duplicate the lists.