Skip to main content

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

Adding MIME types through dynamic system settings

Updated on July 8, 2022

Multipurpose Internet Mail Extensions (MIME) is a standard that indicates the nature and format of a document or file. Pega Platform supports new MIME-type mappings of file type and documents to meet all of your business requirements.

Before you begin: Determine the document or file type that you want a different MIME type to support.

If you want to add a new mapping for a MIME type, or you want to change an existing mapping of a MIME type, you can use dynamic system settings to provide MIME types for your determine document or file type. Static content refers to file types cached from a rule and moved to the web or application server. Using MIME types provides additional static content to seamlessly support file types or documents not included in the standard functionality of Pega Platform for use in your application. For more information about using static content, see Deploying static content to an edge server.

Note: Ensure that you change MIME-type mappings consciously. Changes made to MIME type mappings affect your entire application throughout.

DSS settings uses MIME type keystrings in order to support a given file type. A keystring consists of the following information:

  • File extension - the extension used by the file that you want Pega Platform to support.
  • MIME type - the general category in which the document or file type can be classified.
  • MIME subtype - the exact type of document or file type supported.
  • Optional: The character set associated with this document or file type.
The full file format string is: <file_extension>=<mimetype/subtype>;<charset>.

For example, vbs=application/vbs, xml=text/xml;charset="UTF-8".

Attention: You can assign a single MIME type and subtype to one extension.

For an example, see the following table.

txt = plain/texttxt = plain/text
html = plain/texttxt = plain/html
  1. Create a dynamic system setting. For more information, see Creating a dynamic system setting.
    1. In the Owning Ruleset, enter Pega-RULES
    2. In the Setting Purpose field, enter web/mimetypes.
  2. Click Create and open.
  3. In the Value field, enter the MIME type keystring.
    1. Enter the file extension followed by an equals (=) sign. For example, vbs=

      Note: The file extension is case insensitive.
    2. Enter the MIME type and subtype. For example, application/vbs.
    3. Enter additional MIME types as needed, separated by a comma and whitespace. For example, wsdl=application/wsdl+xml, xml=text/xml.

      Note: The MIME type and MIME subtype are case insensitive.
    4. Enter the character set that you want the MIME types to use, separated from the MIME types with a semicolon and wrapped in quotes. For example, ;charset="UTF-8".
  4. Click Save.
  • Previous topic Updating dynamic system settings by using a direct connection to the database
  • Next topic Updating dynamic system settings by using Java methods

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