Images and media


Images are not decorative and are only used to enhance the user's understanding of the work to be done. Each must be paired with descriptive 'alt' text and must be editorial in nature, never illustrative.

Imagery example

Users should also be able to preview uploaded visually-based content.

Image preview example

Last updated: Apr 2019


Generally, avatars are used to distinguish between different operators and objects when they are shown in a list or in a small space. Users of applications can upload a custom avatar of their choice.

Avatar example

User avatars are automatically generated by the system, but can be replaced with an image of the user’s choosing. Colors of generated avatars depend on the first letter of the “Full Name” property.

They are displayed as a 32px x 32px circle unless the avatar is the main focus of the view (48px x 48px) or shown in the portal header (24px x 24px).

Generated avatars example

When avatars indicate a group of users (e.g. a workgroup), avatars should show the first letter of the workgroup name, a single letter, and a white inner border.

Group avatars example

Objects can also have avatars. These are distinct from users as they are hollow and square. Object avatars are displayed as 32px x 32px in most of the UI, and 48px x 48px when they are the main focus of the view. The first letter of the first two words defines the content.

Object avatars example

Last updated: Jul 2018

Mobile app icons

All Pega applications used on mobile device use the default Pega app icon to start, but may customize for their app if desired.

Mobile app icons have a simple "flat" graphic toward the top, with "Pega" brand text below. iOS icons have a subtle gradient in a rounded-point square, Android icons have a solid white background in circle. Icons shouldn't use more than one area with the new Pega teal.

Application icon example

When submitting a mobile app to an app store, follow the guidelines for the various images required by the Apple App Store and Google Play Store.

Last updated: Jan 2018

Media player

Pega uses the browser's native video player to serve up time-based media and currently supports:

  • Showing and hiding user controls
  • Mute control (enabled by default)
  • Autoplay (only when muted for accessibility reasons)
  • Looping
  • "Poster" images

Last updated: May 2017