Skip to main content

Table of Contents

Adding MIME types through dynamic system settings

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.

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.

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".

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

For an example, see the following table.

Correct Incorrect
txt = plain/text txt = plain/text
html = plain/text txt = 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=

      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.

      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.

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