Amazon S3

The Amazon S3 Plugin allows you to host your Assets on an Amazon S3 bucket instead of hosting them on your local server. When creating an Asset you select from your S3 bucket, rather than your local computer.

Setting up an S3 bucket

To get started, you need to sign up for an Amazon account. Ensure you are familiar with the pricing tiers for S3 before you commit to using it.

If you are new to Amazon Web Services, follow these steps to set up your Amazon S3 account. The following steps are important to ensure you aren’t using your root account for day-to-day tasks:

  1. Create an AWS account

  2. Set up an IAM user

  3. Sign in as IAM user

  4. Set up your bucket


The region you select for your bucket is important from a data protection perspective and you will need to copy this value to use when you set up Mautic. Consult your privacy policy and act accordingly.

Now that you have created a bucket, create a user who can access it. Instead of using the credentials for your master account which expose you to significant risk if they’re ever exposed, use the credentials for this user in Mautic.

  1. Select your account name in the top right corner.

  2. Select Security Credentials from the drop-down list.

  3. Select Users > Add User and provide a name.

  4. Select programmatic access.

Screenshot of Amazon S3
  1. Select Attach existing policies directly, filter for S3 by typing it in the search box, and select AmazonS3FullAccess.

Screenshot of Amazon S3
  1. Click Next button to proceed through, as you don’t need to assign any tags.

  2. Create a user after reviewing the information submitted.

Screenshot of Amazon S3
  1. Next, you can view the Access Key ID and the Secret Access Key.


You must make a copy of these credentials as you won’t be able to access them again. Download them and/or save them securely.

Setting up S3 in Mautic

With the bucket details and a user with the correct credentials, it’s time to set up Mautic to use this bucket.

  1. Go to Settings > Plugins

  2. Click the Amazon S3 Plugin.

  3. Click the install/upgrade Plugins, if you don’t see the Amazon S3 Plugin.

  4. Enter the ID, secret from your user, and the bucket name.

Screenshot of Amazon Integration Form
  1. Enter the bucket location as configured in Amazon S3.

  2. Click Save to save your changes

  3. Click the next tab, Features, to ensure that the option to use a cloud provider for Assets is selected.

Screenshot of Amazon Integration Form
  1. Click Save & Close, and refresh the Plugins page - the Amazon S3 Plugin icon will be in color rather than Grayscale, indicating that it’s active.

When you upload an Asset to your S3 bucket you can select it by creating a new Asset and choosing Remote Files > S3.