Storing Files using Amazon S3

Overview

In this tutorial, we'll show you how to set up the app to store files in your own S3 bucket.

This feature is only available on Plus plans.

Why would I want to set up an S3 bucket?

Enterprise customers often prefer to keep control of their own files for a variety of reasons, including the ability to utilize a CDN for faster page load times. Once set up in Custom Fields, you have the added benefit of removing file upload size restrictions.

Getting Started

First things first, before going into Amazon, we need to make sure that we have a plan that will support the S3 bucket. Go into the Custom Fields app, hover over settings on the menu bar, and click on "Settings". This will bring you to the Settings Page of the app.

2019-03-19_1634.png

Ensure that you're on a Plus plan, or upgrade before continuing.

2019-03-19_1635.png

Getting Started with Amazon S3

Amazon S3 is a simple online web storage system and it is completely free to sign up for! Learn how to set up an Amazon S3 bucket here!

Once you have an Amazon S3 Bucket setup, for security reasons, create an IAM User with necessary permissions. Go to Security Credentials on the account and Generate a New Access Key. Take note of the Access Key ID and the Secret Access Key. You'll enter these credentials in Custom Fields.

Technical Notes

Note that we recommend a new Amazon S3 bucket for this purpose. You can use an existing bucket, however, the app will generate a new folder to store the files in that bucket. The app needs read and write access to the bucket. It's not possible to use your own folder structure. If you have existing files in existing folders, you'll need to import those resources so they are properly attached to the appropriate Shopify product IDs. Our import tool supports importing files. In this case, you'd be importing the files back into your own S3 bucket, just in a way that the app and Shopify can use.

Enter The Credentials In Custom Fields

Go back to Custom Fields and Open the Amazon S3 Settings in the Settings Menu. Here you can edit the Bucket name to match your new bucket. Paste your S3 Access Key ID and Secret Access Key in their respective places and select the region of the Bucket. After you are finished editing your settings, click 'Save Settings' at the bottom of the page.

2019-03-19_1636.png

Field Configurations

Once the connection is configured, you'll be able to choose to use either your own S3 bucket or our file storage, on a per-field basis. Head over to the edit screen for a file or image field and select your S3 bucket. You can now use the app as usual.

CDN Domain Use

In this menu, you can also click the "Use CDN Domain" to expand the CDN settings. For more information on this, please visit the help desk article on Using Amazon CDN in Custom Fields.