Skip to main content

Table of Contents

Requirements and restrictions for case attachments in a file storage repository


Only available versions of this content are shown in the dropdown

You can configure your application to store case attachments in a repository. When you use a repository, Pega Platform appends the case ID and time stamp to the attachment name. For example, an attachment called loanapplication.pdf becomes loanapplication_19691231T115959999_CASE-1234.pdf.

Consider the following requirements and restrictions to ensure that your attachments are stored and retrieved correctly from a repository.


  • You must use the D_pxGetFile API to access the contents of an attachment.
  • Your email listener service package must enforce basic authentication.
  • Your email listener must be configured with an operator whose primary application uses the repository that your application uses.


  • Repositories support file attachments only. All other types of attachments are stored in a database.
  • You cannot change the content storage type from repository to a different type.
  • Once you switch from database storage to repository storage, you cannot switch back to database storage without losing access to the attachments stored in the repository.
  • You cannot modify the configuration of a repository after the repository is in use.
  • Application attachments that you provide on the application form are always stored in a database.
  • Multiple applications in the same application rule stack must have the same repository configuration or the end users canot access the file attachmens.
  • Because the application Pulse gadget cannot prompt for authentication details, Pulse attachments that you provide on the Application Overview landing page are stored in the repository only when your session is already authenticated or when the repository supports non-interactive authentication. If neither of these conditions is true, then an error occurs and the operation fails.
  • The following features are not supported for custom repositories during DevOps:
    • Import/export
    • File listener
  • For large images and .pdf attachments, poster creation is skipped and creates a placeholder thumbnail.

Multiple files with the same name - differences between database storage and repository storage

When using database storage, you can attach multiple files with the same name to the same case. For external storage, you cannot attach multiple files with the same name to the same case because storage providers treat the file name plus the path as a key. Attempting to attach more than one file with the same name to a case results in an error. You can, however; attach files with the same name to different cases.

Did you find this content helpful?

Have a question? Get answers now.

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

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

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

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us