Format a value symbol
- Last UpdatedSep 24, 2025
- 3 minute read
Use the Format Value pane to create a short, custom label for your value symbol. You can also use it to hide the label, the units of measurement (UOM), or the timestamp as well as to change the fill, text, value colors, or UOM of the symbol.
-
Right-click a value symbol and click Format Value to open the Format Value pane.
-
Under Style, set the colors, font, number format, and text alignment:
-
Fill
Background color.
-
Text
Color of text.
-
Font Size
Size of font.
-
Value
Color of value.
-
Format
Number format:
Format
Description
Database
Show numbers in a format that depends on the data item:
-
For PI points or PI AF attributes with a PI point data reference, the format depends on the value of the point's DisplayDigits attribute:
-
Zero or positive numbers specify the number of digits to display to the right of the decimal point.
-
Negative numbers specify the number of significant digits.
-
-
For PI Vision calculations or PI AF attributes without a PI point data reference, numbers show 5 significant digits.
All data items show the thousands separator.
General
Show all significant digits for numbers except for trailing zeros. If the absolute value of the number is greater than 1x107 or less than 1x10-4, the format will switch to use scientific notation.
Number
Show numbers in the custom format that you specify:
-
Decimal Places
The number of digits shown after the decimal.
-
Use 1000 separator
Select this check box to show the thousands separator in large numbers.
Scientific
Show numbers in the format 0.00E+00.
-
-
Text Alignment
Either Left, Center, or Right.
-
Units
Either Default for the base units or a listed unit to convert to. Only units appropriate for conversion from the base unit are listed.
-
-
Under Font, select your preferred font from the Name dropdown.
Note: If the selected font is not installed on a user’s system, an alternative font will be used by the browser. Roboto and Roboto Slab are installed with PI Vision, so will display consistently for all users.
To change the font size:
-
Select or enter a size in the Size dropdown.
-
Use the Increase Font Size
and Decrease Font Size
buttons to change the size incrementally.
-
-
Under Visibility, specify the information that appears in the value symbol.
-
Label
Create a custom label or choose a default label from the list. Clear the check box to hide the label.
-
Units
Clear the check box to hide the units of measurement.
-
Timestamp
Clear the check box to hide the value's timestamp (consisting of a date and time).
-
Value
Clear the check box to hide the value.
-
Show Indicator
If the target is defined, select the check box to view the target indicator. See Add a target indicator.
-
-
If you want to reset all the settings in the pane to the default settings, select Reset to default.
-
If you want to save the current settings as the default settings for value symbols, select Save as default. The saved settings are applied by default when a user creates a new value symbol, and they are applied when a user selects Reset to default in this pane.
Note: You must have administrator privileges to save defaults.
-
Click the down arrow
at the top of the pane and then click Add Navigation Link to add a navigation link to the symbol.