Skip to main content

Manage lists of choices with value sets

A value set is a list of choices behind a field. Your own attributes of the type Enum get their choices from a value set, and so do built-in fields such as the manufacturer of a product, the tag of a company and the payment status of an order.

Value Sets overview showing a table with ID, Type, Name, Description and dates

Before you begin​

You need Backoffice access and the Configuration role. To create or delete a value set or an item you need Owner access.

Know the built-in lists​

Value sets whose name starts with SYSTEM_ are lists that the screens of Propeller read. You can add, change and remove their items, for example to add a manufacturer. Do not rename or delete such a list, because the screens find it by its name.

Built-in listFeeds
SYSTEM_MANUFACTURERS, SYSTEM_SUPPLIERSManufacturer and Supplier of a product
SYSTEM_USER_TAGSThe tag of a company, contact or customer. A price sheet calls it a user group
SYSTEM_TURNOVER_GROUPSThe turnover group of a product
SYSTEM_PAYMENT_STATUS, SYSTEM_SOURCE, SYSTEM_SHIPPING_METHODPayment status, source and shipping method of an order
SYSTEM_ADDRESS_COUNTRIESThe countries of an address
SYSTEM_APP_LANGUAGES, SYSTEM_DATA_LANGUAGESThe languages in the top bar

The Type column says System or Custom. A value set or an item of the type System is locked and cannot be changed.

Create a value set​

  1. Go to Admin > Valuesets and click New Valueset.
  2. Type a Name and a Description.
  3. Click Save.

The new set is empty. Add its items next.

Add the choices​

  1. Click the value set in the list. Its items open.
  2. Click New Valueset Item.
  3. Fill in the dialog and click Save.

Items page of the SYSTEM_SOURCE value set with five items

FieldWhat it isRequired
ValueWhat Propeller stores when someone picks this choice. Keep it short and do not change it once it is in useYes
DescriptionWhat people read in the list, per languageNo
ExtraA free field for additional information, for a connected systemNo

Edit Valueset Item dialog showing Description, Value and Extra fields

To change an item, click its row. Click Back to list to return to the value sets.

Set the languages of your environment​

The two language lists in the top bar are value sets.

Value setHolds
SYSTEM_APP_LANGUAGESThe languages for menus and buttons, under Interface. Propeller has English, Dutch, French and German
SYSTEM_DATA_LANGUAGESThe languages for your content, under Data, such as product names

SYSTEM_APP_LANGUAGES value set in Admin

Add or remove an item to change which languages your colleagues can pick. For an interface language that Propeller does not have yet, contact Propeller. See Switch language.

Delete a value set or an item​

  1. Tick one or more value sets, or items inside a set.
  2. Click Delete and confirm.

Deleting a value set deletes all its items, and it cannot be undone. Fields that used the list lose their choices, so check first that no attribute uses it.