Updated: October 5, 2018

How To Use Semantic Colors

Intro

Semantic colors visualize a meaning or value state. SAP Fiori has four semantic colors that are associated with the following predefined value states:

  • Bad / error
  • Warning / critical
  • Good / positive
  • Neutral

This article provides guidance on when to use which semantic color.

For more information about the color values for the Belize theme, check out the Colors article.

Object status with semantic colors for different meanings
Object status with semantic colors for different meanings

Usage

Use semantic colors if:

Do not use semantic colors if:

  • The color has no meaning and is only used for decoration.

When To Use Which Semantic Color

Only use a semantic color if you need to convey the meaning defined for that color. This section looks at each semantic color in turn, and indicates when to use each one.

Bad / Error

This color is used for errors, or to indicate a bad or negative status or consequence.

Use bad/error semantic color if:

  • Something bad has happened, or is about to happen. The issue requires the user’s attention. Until the issue is resolved, the user can’t carry on working.
  • You want to indicate that a value has caused an error.
  • The user needs to be prevented from finalizing the current mode or page.
  • The user input failed a validation, and the problem must be fixed before the user can continue.
  • message contains information about an error.

Do not use the bad/error semantic color if:

  • A status or event is fine. Use the good/positive color instead.
  • The user input was validated successfully. Use the neutral color instead.
  • The user input was validated and only minor problems occurred. The user can still finalize the current mode or page. Use the warning/critical color instead.
  • You are using form field validation, and the surrounding page (or part of it) is in display mode.

Examples

An object has been damaged. The negative object status is used.

Negative object status
Negative object status

An error was identified while validating the entry for a checkbox. The checkbox has an error value state.

Error value state for a checkbox
Error value state for a checkbox

An error occurred while saving a draft. An error message box is used.

Error message
Error message

Warning / Critical

This color indicates a critical situation or warning.

Use the warning/critical semantic color if:

  • You want to highlight a critical status.
  • A minor problem has occurred. The user can carry on working, but might run into an error later on.
  • The current mode or page can be finalized, but doing so might lead to an error later on.
  • The user input was validated and a minor problem occurred. The user can continue without fixing the problem, but might run into an error later on.
  • A message contains information about a warning.

Do not use the warning/critical semantic color if:

  • The user input was validated successfully. Use the neutral color instead.
  • The user input was validated and a major problem occurred. The user must fix the problem before finalizing the current mode or page. Use the bad/error color instead.
  • You are using form field validation, and the surrounding page (or part of it) is in display mode.

Examples

The stock level for a product is low. The critical object status is used.

Critical object status
Critical object status

The user’s input could lead to an error later on. The input field has a warning value state.

Warning value state for an input field
Warning value state for an input field

The user tries to leave a page without saving. A warning message box is used.

Warning message
Warning message

Good / Positive

This color stands for a good, positive situation, or for successful completion of a task.

Use the good/positive semantic color if:

  • You want to highlight a good or positive status.
  • message contains information about a process that was finalized without any issues. Users will need this information later on (for example, values that need to be copied to another app).

Do not use the good/positive semantic color if:

Examples

A product is available. The positive object status is used.

Positive object status
Positive object status

You want to indicate that the user’s input was successful. The input field has a success value state.

Success value state for an input field
Success value state for an input field

A success message needs to be acknowledged by the user. A success message box is used.

Success message
Success message

Neutral

This color is used for a neutral state.

Use the neutral semantic color if:

  • You want to indicate a neutral object status.
  • There is no reason to use another value state.
  • The user input has not yet been validated.
  • Validation of the user input was successful, without any issues.
  • message contains non-critical, additional information for users.

Do not use the neutral semantic color if:

  • The user input was validated and a problem occurred. Depending on the severity, use the warning or error state instead.
  • You want to highlight a positive or good thing. Use the good/positive color instead.
  • message contains information about a warning or error.

Examples

A product is planned. The neutral object status is used.

Neutral object status in a table row
Neutral object status in a table row

A standard input field uses the default neutral value state.

Neutral value state for an input field
Neutral value state for an input field

You want the user to acknowledge a message, but no further action is required. Use the neutral information message box.

Information message
Information message

Styles

The semantic colors are themeable.

Resources

Want to dive deeper? Follow the links below to find out more about related controls, the SAPUI5 implementation, and the visual design.

Elements and Controls

Implementation