Set up Amazon S3 (AWS) in Classic CMS

  • Updated
These settings are only configurable if you are on version 5.2.2312 or prior.

Amazon S3 can be used by Optimizely Configured Commerce to store product images, and documents associated with products. This section provides an overview of the components necessary to set up Configured Commerce to use Amazon S3.

Visually, the Admin Console will not change. As such, adding content such as images is exactly the same as it is when using a local file system. For more information, see the Local File System article.

When using the Amazon S3 Storage Provider, if a file has a space in its name, it must be requested via the /userfiles path with spaces encoded as %20. However, Chrome (and other browsers) will request with a plus (+) sign instead of %20 if the URL is not encoded first. The /userfiles controller does not take this into account and ends up causing a 404 error. To avoid this, ensure your files do not have spaces in the filename. For example, use dashes instead.


To use Amazon S3 in Configured Commerce, you must have the following prerequisites:

  • An active Amazon S3 Account
  • Your Amazon S3 Access Key
  • Your Amazon S3 Secret Key
  • The name of the Amazon S3 bucket you wish to use to contain your content


The following Application Settings must be set in order to use Amazon S3 as your file store location.?These settings display if your storage provider is not set in the appSetting file of your project. If your storage provider is set in the appSetting file, these settings will appear grayed out and some data may appear blank or masked by field based on its sensitivity.

Setting Name


Storage Provider


Once AmazonS3 is selected, the Settings listed below will display.

Access Key

This is an alphanumeric string that uniquely identifies who owns an account. This is analogous to a username.

Bucket Name

This determines the name of the bucket that is being used to hold your content. This is set up through Amazon S3.

Secret Key

This is a Password that is paired with the Access Key to form a secure information set that confirms the user's identity

Custom Domain



The region for Amazon S3. Default value: us-east-1.