Skip to content

Amazon S3 ​

Amazon S3 (Simple Storage Service) is AWS's cloud object storage service. Connecting S3 to FluentCart offloads your digital product files from your own web server into a dedicated, highly durable, globally available storage layer. Your site stays fast, your downloadable files stay safe, and your storage scales effectively without limit.

This guide walks you through the full setup — from getting AWS credentials, to picking or creating a bucket, to locking the bucket down with the right security settings.

Obtaining AWS Access Keys ​

Before you open the FluentCart Storage screen, create a pair of S3 access keys in AWS. The walkthrough below uses the current (2026) AWS console layout and produces a dedicated IAM user scoped just for FluentCart — so you can rotate or revoke its keys any time without affecting the rest of your AWS account.

Already have access keys? Skip this section and jump to Accessing Amazon S3 Settings.

1. Open IAM and Start a New User ​

  1. Log in to the AWS Management Console.
  2. In the top search bar, type IAM and open the service.
  3. In the IAM sidebar, expand Access Management and click Users.
  4. Click the Create user button in the top-right.

Tip: IAM is a global service — you do not need to pick a region for user creation.

2. Specify User Details ​

Give the new user a recognisable name (for example, fluentcart-s3). Leave Provide user access to the AWS Management Console unchecked — FluentCart only needs programmatic (API) access, not a console login. Click Next.

Why no console access? A dedicated API-only user reduces your attack surface. If the key ever leaks, the attacker cannot log into the AWS console with it.

3. Attach the S3 Policy ​

On the Set permissions screen:

  1. Choose Attach policies directly.
  2. In the Permissions policies search box, type s3full.
  3. Tick the row for AmazonS3FullAccess.
  4. Click Next.

Security-conscious alternative: instead of AmazonS3FullAccess, you can create a custom policy scoped to a single bucket ARN with only the actions FluentCart uses (s3:ListAllMyBuckets, s3:ListBucket, s3:CreateBucket, s3:PutObject, s3:GetObject, s3:DeleteObject, s3:PutBucketPublicAccessBlock, s3:PutBucketOwnershipControls). The managed policy is simpler and is what this guide assumes.

4. Review and Create the User ​

Double-check the user name and the attached policy. Tags are optional — you can skip them. Click Create user.

5. Open the New User's Security Credentials ​

Back on the Users list, click the user you just created (fluentcart-s3). On the user details page, open the Security credentials tab, scroll down to the Access keys section, and click Create access key.

6. Pick a Use Case for the Access Key ​

AWS asks what the key will be used for. Choose Third-party service (FluentCart is a third-party application calling the S3 API on your behalf). AWS will surface a best-practice reminder — tick I understand the above recommendation and want to proceed to create an access key, then click Next.

You can leave the optional description tag blank, or add something like fluentcart-production if you manage keys across several environments. Click Create access key.

7. Copy the Access Key and Secret Access Key ​

AWS now shows both values:

  • Access key — the public ID.
  • Secret access key — the private half. Click Show to reveal it.

The secret is shown only once

This is the only moment AWS will ever display the secret access key in cleartext. Either copy both values immediately into FluentCart, or click Download .csv file to store them safely. If you lose the secret, you cannot recover it — you will have to delete this access key and create a new one.

Once you have both values, click Done.

Credentials Recap ​

FluentCart fieldAWS valueSource step
Access KeyAccess keyStep 7
Secret KeySecret access keyStep 7
IAM user namee.g. fluentcart-s3Step 2
Attached policyAmazonS3FullAccessStep 3

Keep the two keys handy — you will paste them into FluentCart in the next section.


Accessing Amazon S3 Settings ​

From your WordPress dashboard:

  1. Go to FluentCart > Settings > Storage Settings.
  2. Click Amazon S3 (or its Manage button).

You will land on the Amazon S3 configuration wizard. Setup is split into three steps:

  1. Credential — how FluentCart will authenticate to AWS.
  2. Bucket — which S3 bucket will hold your files.
  3. Security — bucket-level protections against unintended public access.

Step 1 — Credential ​

The step is titled Verify Access Keys. FluentCart supports two ways to supply your AWS access keys.

This is the most secure option. Your keys live in your WordPress configuration file, never in the database, and are not readable from the admin UI.

Select Define access keys in wp-config.php (Recommended). The option has a Copy Snippet button. Copy the snippet below near the top of your wp-config.php (before the /* That's all, stop editing! */ line) and replace the placeholder values with your real AWS keys:

php
define( 'FCT_S3_ACCESS_KEY', 'your-access-key-id' );
define( 'FCT_S3_SECRET_KEY', 'your-secret-access-key' );

Once FluentCart detects the constants, this option reads "You have already defined your credentials in wp-config.php." and the database option is disabled.

Heads up: to later switch to a different method here, comment out or remove the FCT_S3_ACCESS_KEY and FCT_S3_SECRET_KEY defines from wp-config.php and reload the page.

Method B — Store Access Keys in the Database ​

Available when you need UI-only configuration. Keys are saved to the database, which is less secure than a file-based constant.

Select Store credentials in the database, then enter:

  • Access Key: your AWS Access Key ID.
  • Secret Key: your AWS Secret Access Key.

Click Save & Continue. FluentCart checks the keys before moving on to the bucket step.

No access keys yet? Head back to Obtaining AWS Access Keys above for the full IAM walkthrough.


Step 2 — Bucket ​

An S3 bucket is a named storage container inside your AWS account. On the Choose where files live screen, you either connect an existing bucket (typed in or picked from a list) or create a new one.

Option 1 — Connect an Existing Bucket, Entered Manually ​

If you already know the exact name of the bucket you want to use, type it directly.

  1. Select Connect an existing bucket.
  2. Under Bucket name, choose Enter bucket name.
  3. Type the bucket name and click Next.

Option 2 — Connect an Existing Bucket, Selected From AWS ​

FluentCart can fetch the list of buckets in the connected AWS account so you can pick one, with no copy-pasting and no typos.

  1. Select Connect an existing bucket.
  2. Under Bucket name, choose Select from existing.
  3. Use the Search buckets box to filter the list, or click Reload bucket list if you do not see a bucket you just created.
  4. Click the bucket you want, then click Next.

Option 3 — Create a New Bucket From the UI ​

No need to switch to the AWS console. FluentCart can create a fresh S3 bucket in the region you pick.

  1. Select Create a new bucket.
  2. Enter a Bucket Name. Bucket names must be unique across all of AWS globally, follow DNS-style naming (lowercase letters, numbers, hyphens), and cannot be reused after deletion for a while.
  3. Choose a Region — pick the one geographically closest to most of your customers (for example, US East (N. Virginia) for the Americas, EU (Frankfurt) for Europe).
  4. Click Create Bucket & Continue. FluentCart creates the bucket in AWS and selects it for you.

Region tip: once a bucket exists, its region is fixed. If you change your mind later, you create a new bucket in the new region and move your files over.


Step 3 — Security ​

This step is titled Review protection settings and configures two bucket-level protections on AWS. Each toggle shows a Recommended badge when on and Review when off.

Block All Public Access ​

Controls AWS's S3 Block Public Access setting for this bucket. When enabled, AWS refuses any bucket policy or ACL that would expose objects publicly — even if something is misconfigured downstream.

  • Enabled (Recommended) — your digital product files are kept private and only served through FluentCart's signed links.
  • Disabled — required only if you explicitly need objects to be publicly reachable, which is unusual for paid digital goods.

Object Ownership ​

Controls who owns objects uploaded into the bucket.

  • Enforced (Recommended) — the bucket owner (your AWS account) retains full control of all objects, regardless of who uploaded them. ACLs are effectively disabled.
  • Not enforced — uploader can retain ownership via ACLs, which complicates permission management.

Both toggles are surfaced as first-class controls with clear recommendation labels:

Click Save Settings to finish.


Connected State ​

Once all three steps are complete, the Amazon S3 card shows the provider as Active, with the bucket name, region, and security summary.

What each element does:

  • Active toggle: turn the provider on or off without losing its configuration.
  • Check again: re-verify the connection.
  • Edit Config: re-open the wizard to change credentials, bucket, or security.
  • Reset: clear all S3 settings after confirmation.

Below the buttons, info rows show the Bucket (links to the bucket in the AWS console), Region, Authentication (Defined mode or Database mode) and Security posture (for example "Public access blocked, ownership enforced").


Managing Files ​

Once connected, all digital product uploads flow through your S3 bucket automatically. Inside the FluentCart file browser you can:

  • Upload new assets directly to S3.
  • Browse and list files already in the bucket.
  • Search by filename.
  • Delete files you no longer need.
  • See a provider badge next to each file so you know at a glance whether an asset lives on S3, R2, or local storage.

Editing an Existing S3 Connection ​

Need to rotate your AWS keys, point FluentCart to a different bucket, or tighten the security settings?

  1. From Settings > Storage Settings > Amazon S3, click Edit Config. The wizard opens at the bucket step when a bucket is already set. Use Back or the step indicator to reach credentials, and Cancel to leave without changes.
  2. Move through the Credential, Bucket and Security steps as needed.
  3. Only the fields you change need to be updated.

You do not need to disconnect and reconnect — existing assets stay referenced correctly.

Enabling / Disabling the S3 Driver ​

Use the Active toggle on the Amazon S3 card to turn the provider on or off. Turning S3 off does not delete any files from AWS — it only tells FluentCart to stop routing new uploads through it.


Full wp-config.php Example ​

For teams standardising on Method A, here is a complete, paste-ready snippet:

php
// Add this near the top of wp-config.php, above
// the "That's all, stop editing!" line.
define( 'FCT_S3_ACCESS_KEY', 'AKIAEXAMPLEKEYID1234' );
define( 'FCT_S3_SECRET_KEY', 'wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY' );

Once saved, reload the Amazon S3 page in FluentCart and the credential fields will be locked and pre-filled from your config.


Troubleshooting ​

The connection test fails after I save credentials.

  • Double-check both keys were pasted without leading or trailing spaces.
  • Confirm the IAM user has the AmazonS3FullAccess policy (or an equivalent that allows s3:ListAllMyBuckets, s3:CreateBucket, s3:PutObject, s3:GetObject, s3:DeleteObject).
  • If you rotated keys recently, make sure the old key is deactivated and you are using the current one.

"Select from existing" shows no buckets.

  • The list reads "No buckets found or credentials are invalid."
  • The IAM user lacks s3:ListAllMyBuckets.
  • The account genuinely has no buckets yet. Switch to Create a new bucket.

Bucket creation fails with a name conflict.

  • Bucket names are globally unique across all AWS accounts. Try a more specific name (for example, yourstore-fluentcart-assets).

Files upload but customers cannot download them.

  • Block All Public Access is likely Enabled (good) — FluentCart serves files through signed URLs in this mode, so confirm the file was uploaded under the Amazon S3 tab of the Storage Providers dialog when you added it to the product.

I defined FCT_S3_ACCESS_KEY / FCT_S3_SECRET_KEY but the UI still shows empty fields.

  • Confirm both constants are in wp-config.php (not in a plugin file) and load before FluentCart.
  • Confirm the constant names match exactly — FCT_S3_ACCESS_KEY and FCT_S3_SECRET_KEY.

FAQs ​

Can I run S3 and Cloudflare R2 at the same time? Yes. You can configure both and keep both active. When you add a downloadable file, the Storage Providers dialog shows a tab for each active provider, so you choose where each file goes.

Is my secret key visible from the WordPress admin after I save it? No. With Method A, keys live only in wp-config.php. With Method B, the secret is masked in the UI after save.

Can I change the region later? A bucket's region is fixed at creation. To move to a different region, create a new bucket in the new region and either re-upload or use S3's cross-region replication to migrate your existing files.

Does FluentCart support server-side encryption? AWS S3 default encryption (SSE-S3) applies at the bucket level. Enable it on the AWS side and FluentCart's uploads will be encrypted automatically.

Do I have to use AmazonS3FullAccess?AmazonS3FullAccess is the simplest policy and is what this guide uses. Security-conscious setups can scope a custom policy down to the specific bucket ARN and only the actions FluentCart uses.