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.

Enabling attaching files to an application

Updated on April 5, 2022

Enable application users to attach files to a desktop, mobile, or an offline-enabled application by adding the Attach content control (pxAttachContent).

Users can add files to an application by using either the file browser or the drag-and-drop functionality. You can choose to display this control as a button, a link, or an icon.

The Attach content control is also supported in offline-enabled applications. For more information, see Attach content support in offline mode.

  1. On the Design tab, from the Action list, drag Attach content onto the work area.

  2. Click the View properties icon for the control.

  3. In the Cell Properties window, next to the control name, click Change, and then select Attachments.

  4. Optional:

    On the General tab, configure the following settings:

    • Display options for the control.
      1. In the Displayed as list, specify whether to display the control as a button, link or icon.
      2. In the Button caption list, specify the button caption as text or a property reference.
      3. In the Text field, enter a label for the control.
      4. In the Image source list, specify image source to be a simple image, property, icon class, or none.
      5. In the Helper text list, specify whether to display a tooltip.
      6. In the Visibility list, specify whether to always display the control, or only based on an expression or a when rule.
      7. In the Disable list, specify whether to never or always disable the control, or only disable based on an expression or a when rule.
    • Attachment settings for the control.
      1. In the File name list, specify whether to use the default file name, or based on a property reference or text.
      2. In the Category list, specify a category or one based on property reference.
      3. In the Attach to list, specify whether to attach to a work item or a page.
    • Attachment compression parameters for mobile apps. For more information, see Configuring file size options for the Attach content control.
  5. Click Submit.


At run time, users can attach files to cases according to the following scenarios:

  • In a desktop application, users can attach files to their application in the default file browser window.
  • In a Pega Client for a Windows-based application, when a camera is present in the device, a selection dialog box with two options opens. Users can open the native file picker component to attach files to their application or open a live camera view to take a snapshot. When a user takes a picture, the control creates a file with a timestamp-based file name and attaches the file to the application. If no camera is available, the control opens the native file picker component without displaying the selection dialog box.
  • In a mobile app, users can select a file of any type from the device storage, or from any mobile app that is installed on the device, for example, Dropbox, Google Drive, iCloud, Audio Recorder or Camera. In addition, you can configure compression parameters to limit the size of files that are created on a mobile device. The Attach content control also supports sharing file attachments with external mobile apps, except for signature files.
Note: When users restart a mobile app, pending file attachments that they added but did not send to the server might no longer be available.

  • Configuring file size options for the Attach content control

    To limit the size of files that the user attaches to a mobile app, for example to conserve bandwidth during synchronization, you can configure attachment compression parameters, such as video clip format, video clip duration, maximum image size, and maximum image quality.

  • Customizing how the Attach content control is displayed

    After you configure a control in a section or a layout to support attaching content, you can customize how the control is displayed to application users.

  • Keystores

    A keystore is a file that contains keys and certificates that you use for encryption, authentication, and serving content over HTTPS. In Pega Platform, you create a keystore data instance that points to a keystore file.

  • harnesses

    Organize the content and structure of a portal by defining harnesses. By populating harnesses with sections, you can build a modular interface that promotes reuse and maintainability.

  • Sections

    Use sections in conjunction with harnesses to define the appearance of user forms, rule forms, or composite portals.

  • Previous topic Troubleshooting Show User Location feature in browsers
  • Next topic Configuring file size options for the Attach content control

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. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us