Shortcuts
Next region
F9
Previous region
ShiftF9
Jump to toast
⌥Enter
Dismiss toast
⌥Q
Go to incoming interaction popup.
⌥Enter
Dismiss incoming interaction popup.
⌥Q

Currency input

Currency input allows a user to enter a monetary value that will be auto-formatted to match a particular currency, such as pounds sterling, euros, dollars, etc.

The currency component will only allow a user to enter numerical data, and any other characters will be ignored.

Usage

The currency component can be configured to have a prefix, suffix, or both (e.g., $, USD). It can be displayed prefilled with a value, in which the default is set to “0.00”, or the international equivalent.

The formatting for the currency (e.g., separators, decimals), as well as any numerical formatting necessary for a particular locale, will be applied as a user types. All numeric fields (including currency, integer, decimal, and percentage fields) always include thousands separators.

New for 24.2: Now labels can use property references, making them dynamic; creating more personalized, engaging experiences.

For more best practices on building forms with inputs in Constellation, visit Pega Academy.

Example

Enter a numerical value

Display options

Required

This will prevent any form submission until the required selection is made.

Readonly

Readonly inputs are typically recommended to use when they provide information that a user shouldn't edit, but makes sense in the logical order of the form. (e.g. A state input may be readonly based on certain business restrictions, but the street and province or state are freely editable.)

Disabled

Not recommended, has serious accessibility implications.

Configuration

To learn how to configure this component in your Constellation application, visit Pega Documentation.

All information on this site pertains to the Constellation UX System (from 8.8 and onwards). Looking for something else? See resources specifically for Theme Cosmos. If you have questions, concerns, or any other feedback, please reach to us on Pega Support and include the capability 'User Experience' and 'Constellation' in your request.

Related components