Define and Format Widget Text

Use the Dashboard Editor to define and format Widget text. A Widget has different kinds of text:

  • Label: Text to display in the Widget header to identify the Widget. By default, the Widget label comes from the Widget title.
  • Data: Data to display inside the Widget (ex: Numbers, charts, etc.).

You can manually change any label and apply different fonts, if needed.

Good to know:

  • Label text can be conditional (Expression-driven). For example, define an Expression to change a label when a threshold is surpassed ("Too Many Open Incidents!").
  • Text wrapping in labels can be turned On or Off.
  • Text formatting options include:
    • Font: Theme or explicit font family.
    • Font size: Point size for an explicit font, or relative size (small/medium/large) for a Theme font.
    • Font style: Bold, underline, or italics (explicit fonts only).
    • Font alignment: Horizontal (left, center, right) and vertical (top, middle, bottom) alignment of text ONLY on a Text, Button, or Link Shape Widget.
      Note: Text color is defined as a foreground color.
  • See Dashboard Editor Behaviors for tips on working with Widgets on Dashboards.

To define and format Widget text:

  1. Open a Dashboard in the Dashboard Editor
  2. Click a Widget.
  3. Define a label, either static or conditional text:
    • Static: In the Label text box, provide the label to display in the Widget.
    • Expression-driven text (conditional): Click the Expression button Text Expression Button, and then define the Expression (condition) to determine the label, using either:
      • Custom Expression: Select this option to open the Custom Expression Builder, and then create a custom Expression specifically for this scenario.
      • Expression Manager: Select this option to open the Expression Manager, and then select an existing stored Expression or create a new stored Expression. Stored Expressions can be re-used in numerous places in CSM.
  4. Define text formatting:
    1. Font: In the Font drop-down on the Dashboard Editor toolbar, select a font family, either:
      • Theme font: Font comes from your default system font (ex: Segoe UI).
      • Explicit font: Font is selected by you.
    2. Font style (explicit fonts only; Theme font defines this): On the Dashboard Editor toolbar, click the Bold, Underline, and/or Italics buttons Format Text Buttons.
    3. Font size, either:
      • Exact (explicit font): In the Font Size drop-down Font Size, select a point size (ex: 10).
      • Relative (Theme font): On the Dashboard Editor toolbar, click the Small/Medium/Large button Text Size Buttons.
    4. Horizontal alignment (Text, Button, or Link Shape Widgets only): On the Dashboard Editor toolbar, click one of the Horizontal Alignment buttons (Left, Center, or Right) Horizontal Text Alignment to align the text on a horizontal axis within the control box (ex: Left, Center, or Right).
    5. Vertical alignment: On the Dashboard Editor toolbar, click one of the Vertical Alignment buttons (Top, Middle, or Bottom) Vertical Text Alignment to align the text on a vertical axis within the control box (ex: Top, Middle, or Bottom).

  5. Continue making changes, or select OK to save and close the editor.