Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

This content has been archived and is no longer being updated.

Links may not function; however, this content may be relevant to outdated versions of the product.

Adding a file to the Image Library

Updated on April 29, 2020

Pega Platform™ allows you to customize the look-and-feel of your application by providing the ability to include your own logo, display an image on a button or link control, use custom sprites in the UI design, and determine what the user sees during a guardrail warning. To use custom icons or images to your Pega Platform application, you first need to add your binary file to the Image Library. To do this, create a Binary File rule to store your icon or image to the Pega Platform Image Library.

Requirements

Before you begin, determine where the images that you want to upload are located. For this example, images are in the local Windows directory C:\Images\Seasons.

You can then do these actions:

Create a Binary File rule

Image files are stored as binary file rules.

  1. Create a Binary File rule in Designer Studio by selecting +Create > Technical > Binary File.
  2. Complete the fields on the rule form:Binary File Record Configuration
    • Label – The Binary File rule label and identifier
    • App Name – The directory where the image is stored in the Pega 7 Platform system
    • File Type – The binary file extension (do not include a period ".")
  3. Click Create and Open to display file controls.
  4. Click Upload File to open the file browser.
  5. Browse for an image of the type specified in the New/Save as form, and then click Upload File.
  6. If the file is treated as a sprite, select the check box, and then enter the icon width and height.
  7. Click Save.

When the file save is successful, the image that was imported and added to the Image Library is displayed.

Saved binary image file

Find your image in the Image Library

After the image has been successfully uploaded and saved, you can find it in the Image Library.

  1. Open the Image Library by selecting Dev Studio > Technical > User Interface > Image Library.
  2. Search for the image by rule name or image (label) name.

Binary File Image Library

Import an icon

When uploading an icon, use an image with a transparent background. This example uses the image DisplayImageButton.png.

  1. Create a Binary File rule in Dev Studio by selecting +Create > Technical > Binary File.
  2. Enter:
    • Label – The Binary File rule label and identifier
    • App Name – The directory where the image is stored in the Pega Platform system
    • File Type – The Binary File extension (do not include a period ".")
  3. Upload a suitable image file that has a transparent background. In this example, an icon with the text "Display Image" is uploaded.
  4. Select the Treat image as a sprite check box. Optionally, enter the icon width and height.

Add Icon Binary File

  1. Click Save to store the Binary File rule.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us