You are browsing the documentation for version 4.2 of OroCommerce, OroCRM and OroPlatform, which is no longer maintained. Read version 5.1 (the latest LTS version) of the Oro documentation to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Available in OroCRM Available in OroCommerce

Configure Global Upload Settings

To define the size and formats of the files, reduce the size of images to be uploaded into the website back-office or the storefront, you need to configure the corresponding settings in the system configuration.

To configure the upload settings globally:

  1. Navigate to System > Configuration in the main menu.

  2. Go to System Configuration > General Setup > Upload Settings.


For faster navigation between the configuration menu sections, use Quick Search.

  1. The following page opens:

    Upload settings on global level
  2. Clear the Use Default check box next to the option.

  3. In the File Size Settings section, provide the maximum file size (in MB) that is allowed to be uploaded to the application.

  4. In the MIME types section, select a set of mime types that will be supported for the file and image attachments in the system. MIME types are Multipurpose Internet Mail Extension types which help identify the types of the attachments and, thus, limit the possibility of uploading the documents of inappropriate extensions.

  5. Add any MIME type by writing the required file or image format in the text box.


The MIME types settings can be configured globally and per organization.

  1. In the Image Processing section, you can control whether to optimize or not the size of the uploading images in the storage. By default, the setting is enabled, which means that the size of all images that you upload to the system is compressed while preserving the quality.

    Upload settings on global level

    Enable Image Optimization — Select whether to enable the system to optimize the image, reducing the final image size. If disabled, all the images are uploaded without size modifications.

    Keep in mind that all the images uploaded in earlier application versions, remain intact. They won’t be deleted or replaced even after migration. If you want to resize them, then you should delete them manually and reupload.

    JPEG Resize Quality (%) — The setting determines the percentage of the .jpg image resize quality. You can set the values from 30 to 100. The higher the value, the better the image quality.

    PNG Resize Quality (%) — The setting provides two options for controlling the quality of .png images. Preserve quality enables the system to slightly resize the image with the full preservation of the quality. Minimize file size enables the system to resize the image to its minimal possible size while still keeping the high quality.

  2. In the File Names section, you can control whether to use original file names.

    File names section on global level


    The File Names setting is available starting from v4.2.11. and can be configured globally, per organization and per website.

    Enable Original File Names — When enabled, the original file name is appended to the system-generated hash value. All non-alphanumeric characters (e.g., “:”, “)”, “,”, “~”) are replaced with “-” (dash).

    For example, the name of the file is coffee_maker/bosch_#RND123.jpg, the system-generated hash value is media/cache/attachment/filter/product_gallery_main/b6d3b12a2194f276376d682d2e7e6bd1/1/5bae287538.jpg. If the option is enabled, the file name is displayed in the storefront as follows media/cache/attachment/filter/product_gallery_main/623364376a0e8125036727/1/5bae287538-coffee-maker-bosch-RND123.jpg


    When this option is enabled, the Enable Original File Names setting for Product Images is hidden from the system configuration page.

  3. Click Save Settings.

If attachments are enabled for an entity, the configuration of the entity will prevail and override the corresponding global one.