Skip to content
List files in a S3 bucket in a web browser
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information. Create Jul 18, 2014 not necessary to edit default CORS configuration anymore Oct 20, 2015
list.html adding the content + creating the documentation Jul 18, 2014


List files in a S3 bucket in a web browser with a link to each file (cf. example).


Upload the file list.html in your bucket

In the bucket Permissions

  • Grant Everyone to list
  • Add this bucket policy, replacing <your_bucket_name>:
    "Version": "2008-10-17",
    "Statement": [
			"Sid": "PublicReadGetObject",
			"Effect": "Allow",
			"Principal": {
				"AWS": "*"
			"Action": "s3:GetObject",
			"Resource": "arn:aws:s3:::<your_bucket_name>/*"

Note: It's not necessary to activate the website hosting

Access the web page

Display the list at this address: http://<your_bucket_name>.<your_endpoint>/list.html

To know what is your endpoint: Example for Europe (Ireland):

Note: It also works with HTTPS. It won't work with a S3 website endpoint (the hostname must point to the request endpoint)


  • It is compatible with Internet Explorer (has been tested with IE7, IE8 and IE9)
  • It doesn't follow folders


Only this documentation has been added


You can’t perform that action at this time.