Data patterns

Address inputs

Address inputs vary widely from country to country. Pega UX recommends the following pattern for the most inclusive workflow.

  1. If available and the user is online, use the Location Autocomplete component to capture user data.
  2. Otherwise, if a user's needs are exclusive to a single specific country, find and follow the country standards found on Wikipedia.
  3. However, a user's needs may span across multiple countries, in which case use the generic template below (source: Wikipedia)
    • Country: Fields, labels, and languages may need to change based on this answer, so it must be first.
    • Street
    • City area / District
    • City / Town / Village
    • County
    • Postal code

Finally, all address values should use the standard naming found in the semantic autocomplete attribute spec.

Last updated: Mar 2020


At no time should a business user ever be confused about whether a figure is 100,000 or 1,000,000. Number separators (commas in the US, periods or spaces in most other parts of the world) are critical to the clear display of numbers.

Whenever numbers are displayed within a table cell or need to be tallied, they should be right-aligned and use the same decimal place consistently. (e.g. Row 1 may have 10.54, so row 2 must have 1.00 for the sake of comparison)

Last updated: Oct 2020

Date and time


Relative times give a general idea of a past or future event. This is the format most common in Pega applications. Examples of usage include conversations or object updates.

Show relative times in the user’s current time zone. The order of dates and months should be valid for that region. Use of 12 hour or 24 hour clock should also be valid for that region.

Time to displayPastFuture
Under a minuteJust nowRight now
Under 1 hour11m agoIn 11m
This yearJan 15Dec 23
Other yearsJan 15, 2017Dec 23, 2024


Exact timestamps are detailed and very technical. Reserve them for things such as audits and detailed histories. Exact times will always include a time, and almost always a date.

If the application will have an international audience, use the ISO-8601 standard (Y-M-D). If the application is for a specific region, use the region appropriate layout (M/D/Y for USA; D/M/Y for most others).If the application is for no particular region, use the American standard (shown) as a default.

General usageDec 31, 2017 2:13pm
Audits and logs2017-12-31 14:13:30
Exact timestamp2017-12-31T22:30+04

For internationalized guidance on month abbreviations, Princeton has a decent overview of the variations.

Last updated: Apr 2020