Custom Values

When configuring your app, you'll often see the option to choose a 'Custom Value' instead of just a column value. The idea of a custom value can be a little confusing so let's look at a few contexts.

The custom value field in a filter condition

Custom values in components

A text component's text configuration

Above you can see the settings for a text component. Currently, it's bound to the Description column. This means that for every item in that list, the description will be different โ€“ because it is coming from the data in that list's table.

However, we can also choose for the text component to have a custom value โ€“ย in other words โ€“ย a value that we write within the text component's configuration. When we do this, this custom value will be the same for every component in that list (unless we've changed the list settings to have independent screen configuration for each item).

The Rich Text Component allows you to add custom Markdown within the custom text field.

Custom values in conditions

A filter condition with an empty custom value

When you create a condition, the value you test for in the condition defaults to an empty field where you can enter a custom value. Initially, this looks like the only option you have, however, if you click on the three dots you'll get access to a menu with more options. Depending on the condition's context, you may see Column Values, User Profile Columns or Screen Values in this menu.

Clicking on the three dots in the custom value field opens up the menu with other value types

If we use a custom value in our filter condition then that condition will evaluate that custom value on every one of our list items. In other words, if we filter our list to show items where Item SKU is 'ERO-LC1' (a custom value we enter in the condition itself) then every one of our list items will have that same condition.

In this case, this will show only one item โ€“ย the item with the SKU of 'ERO-LC1'.

Filtering a list with a custom value

This is a slightly unrealistic example. A more realistic use would be filtering a list of employees to show only managers. Here, we know the value we want to match in our filter โ€“ย so we can just enter it as a custom value.

Filtering a list of employees to only show managers