Finale Knowledge Base

How Do I Add Conditional Color and Text Formatting to List Views?

Conditional formatting applies background and text colors to list-view cells based on rules you define, so key values stand out at a glance. The video below gives a quick overview, and the sections that follow cover each task in detail.

https://www.youtube.com/watch?v=EXpKh4QPpZI


Using Conditional Formatting

Tip: Ask FIVA to write the formula for you.

FIVA chat window writing a conditional formatting formula on request

The best way to use Conditional Formatting is to also use Custom View presets to truly optimize a page view for a specific workflow. Creating different views that each serve one specific purpose is better than having a single view try to do too many different things. Learn how to configure custom views here.

Follow the steps below to conditionally format a list view.

  1. On a list screen, please select the Customize column in (View Name) link in the Views dropdown. For this example, the View Name is Default.


    Screen_Shot_2024-09-19_at_10_32_35_AM.png


  2. Click on the highlighted field to select the column to set conditional formatting.
    For this example, we will set the conditional formatting on the Fulfillment Status field on the sale screen.


    app_finaleinventory_com_demoshipstation_sc2__order_sale_view.png


  3. Click the Conditional formatting tab and create the conditional formatting rule.


    app_finaleinventory_com_demoshipstation_sc2__order_sale_view.png


Creating a Basic Formula

The conditional formatting relies on a formula, and if the formula is "true", then it will apply the format to that cell.

A list of formulas can be found here, but the easiest to use is ifs(), which will be used in all of the examples below.

The basic way to use an ifs() formula is as follows.
How_to_add_conditional_formatting_in_list_screens.png

  1. This is the field you're referencing. If it's for the column itself, use cellValue. If it's a different column, you'll need to edit the column you want to reference and use the column ID.

  2. This is the operator. You can do any type of argument. Greater than, less than, equals, does not equal, etc.

  3. This is last part of the equation. In the example above, we're saying eligible to ship equals backordered. If it's a word, it always needs to be in quotations. If it's a number, enter the number without quotation marks.

  4. This comma is required to tell the formula that the equation part is finished.

  5. This is required to tell the formula what to do if it's true. In the example above, if the status is backordered, it will make the text. Multiple formatting options can be used here, separated by a semi-colon (no space after the semi-colon).

  6. This is required if you want to do multiple rules. If you're doing one rule, you do not need this. In the example above, we're telling the formula if it equals backordered, make the text yellow, if that isn't true, then it moves to the next line to test and checks if it equals incomplete. If that isn't true, then it goes to the next row, and so on and so on.


Available Colors and Font Weight Options

There are nine colors to choose from, each with 5 shading choices, for a total of 45 potential color options for both background and text coloring. Background coloring can also be combined with text coloring for even more combinations.

In addition to color formatting, the text weight can also be formatted.

The font weight options are:

  • text-light

  • text-bold

  • normal (do not specify the text weight, the formula will default to using normal weight)


    Font weight options for conditional formatting in Finale


The color choices are:

  • Red

  • Orange

  • Yellow

  • Green

  • Blue

  • Purple

  • Brown

  • Pink

  • Gray

  • White (text only, no background)

  • Black (Background only, no text)


    Conditional formatting color chart with the shading options for each color


Using Red Text as an example, the shading options are (replace "text" with "background" for background formatting):

  • text-red-x-dark

  • text-red-dark

  • text-red

  • text-red-light

  • text-red-x-light


Examples

Changing Background Color

If the Fulfillment Status field is the following:
1. "Backordered" = Yellow background
2. "Incomplete" = Red background
3. "Fully Shipped" = Green Background
Using the formula shown below will output the following:

ifs(
orderEligibleToShip == "Backordered", "background-yellow",
orderEligibleToShip == "Incomplete", "background-red",
orderEligibleToShip == "Fully shipped", "background-green"
)


Note: The formulas are case-sensitive. As a result, Backordered cannot be written as backordered.

app_finaleinventory_com_demoshipstation_sc2__order_sale_view.png


app_finaleinventory_com_demoshipstation_sc2__order_sale_view.png


Changing Text Color

If you wanted to change the conditional formatting to change the text color, then you would use the following formula.

ifs(
orderEligibleToShip == "Backordered", "text-yellow",
orderEligibleToShip == "Incomplete", "text-red",
orderEligibleToShip == "Fully shipped", "text-green"
)

app_finaleinventory_com_demoshipstation_sc2__order_sale_view.png


Changing Background and Text Colors (Multiple Arguments)


ifs(
number(productSalesVelocity) > 100, "background-green",
number(productSalesVelocity) > 10, "text-green"
)

Tip: For any formula involving a number column, use the number() function to ensure the field is converted to a number (see above).

app_finaleinventory_com_yhe_sc2__stock_view.png

app_finaleinventory_com_yhe_sc2__stock_view.png


Changing Background and Text Colors (Single Argument)


ifs(
number(cellValue)>0, "background-green-x-dark;text-white;text-bold"
)


To combine formatting options in a formula, each format needs to be separated by a semi-colon. For example, the formula above has a dark green background, white text and the text is bold.

app_finaleinventory_com_ferrarifab_sc2__stock_view.png


Formatting Using Date Comparisons


ifs( 
and(
dateDiff(today(), receiveDate, "days") > 0,
shipmentsStatusSummary != "Fully received"
),
"text-red"
)


This formula compares today's date (referencing using today()) against the estimated receive date column (receiveDate). The third argument can be days, weeks or months. The argument subtracts the first date (today) from the second value (receiveDate). If it is in the past, it will be a positive amount (one week ago was 7 days away). If it is in the future, it will be a negative number.

This formula also uses an "and()" function. This allows us to do the date comparison in conjunction with checking against a different column. The formula above says if the date is in the past AND the shipment summary is not Fully received, then make the text red.

Additional date formatting formulas can be found here.

List view with red text applied by the date comparison formula


Shading an Entire Column


ifs(
true, "background-green"
)


This formula is used to apply the formatting to every row in the column. This can be used to shade a column a specific color, or change the text formatting, regardless of the value.
app_finaleinventory_com_ferrarifab_sc2__product_view.png


If you need assistance with a specific formula, please send your suggestion to Finale Support


Additional Tools to Improve the Finale Experience

In addition to Conditional Formatting, there are several other features that are used to optimize your Finale experience:


Back to top