Preview S3 objects
Text, JSON, CSV, gzipped logs and images shown on your phone from a ranged read; PDFs and media open through a 5-minute link; clear answers for KMS keys, Glacier and denied reads.
Open Services → S3, a bucket and an object. Under Preview CloudConsole fetches only the start of the object it needs (an HTTP Range request to S3), straight from your phone, and decodes it on the phone. Nothing passes through a CloudConsole server. Previews are reads, so they're free; you need s3:GetObject on the object.




What it shows, and the limits
| Kind | How it's shown | Most it reads |
|---|---|---|
| Text, logs, code, XML, YAML, Markdown | Monospace text you can select and scroll sideways. | The first 256 KB. A bigger file says, for example, Showing the first 256 KB of 4.2 MB. |
| JSON (and JSON lines) | A tree you can open and close (CloudTrail records are labelled by event name), or Text for the indented JSON. If the file is cut off at 256 KB it's shown as text. | The first 256 KB. |
| CSV and TSV | A table that scrolls sideways, with the header row detected and quoted fields, commas and line breaks handled. | The first 256 KB, up to 200 rows. |
Gzip (.gz, or stored with Content-Encoding: gzip): CloudTrail, ALB, CloudFront and VPC Flow Logs | Decompressed on the phone, then shown as text or JSON. | The first 1 MB of the compressed file, decompressed to at most 2 MB. |
| PNG, JPEG, GIF, WebP, BMP (HEIC where your phone can decode it) | The picture, with pinch to zoom. | The whole image, up to 10 MB. Images over 2 MB wait for Show image. |
| SVG | Its source as text. Draw it renders it on request (no scripts, no external files). | The first 256 KB. |
| PDF, video, audio, Office files, archives | Open hands them to your phone's viewer or browser. | Nothing in the app: the viewer downloads it. |
| Anything else | The first bytes as hex, with the file type they suggest (for example a pg_dump or Parquet file). | 512 bytes. |
The type comes from the object's Content-Type, then its file extension, then its first bytes.
Open
Open (on every object you can read) makes a presigned link on your phone that works for 5 minutes and passes it to the system viewer or browser. It's for you, so it isn't a Pro action and isn't logged; to give a file to someone else, use Share link. In the demo the link is signed but doesn't open.
Encrypted with KMS
When HeadObject says an object uses SSE-KMS, the screen notes the key and that reading also needs kms:Decrypt on it. If S3 refuses because of the key, the preview says Needs kms:Decrypt on the key and names the key, not just s3:GetObject; Details has the key ARN and a minimal policy for your admin. The key's own key policy also has to let your account use it.
Glacier, Deep Archive and Intelligent-Tiering archives
Archived objects can't be read until they're restored. The screen says which archive the object is in and, from HeadObject's restore status, whether a restore is In progress or a copy is available until a date. Restore (a Pro action, at your guardrail level) lets you choose the speed and, for Glacier, how many days to keep the copy:
- Glacier Flexible Retrieval: Expedited (usually 1–5 minutes), Standard (3–5 hours) or Bulk (5–12 hours); keep the copy for 1, 3, 7 or 30 days.
- Glacier Deep Archive: Standard (within 12 hours) or Bulk (within 48 hours).
- Intelligent-Tiering Archive Access: Standard or Bulk. The object moves back to the Frequent Access tier, so there are no days to choose.
AWS charges for the retrieval and, for Glacier, stores the temporary copy at the Standard rate while it lasts. Pull to refresh to see when it's ready.
When a read is denied
- If the preview is refused, it names
s3:GetObjectonarn:aws:s3:::bucket/keyand, where AWS's message says so, whether your role, the bucket policy or an organisation policy (SCP) said no. Details has the minimal policy. - If even the object's details (HeadObject) are denied but you could list the folder, the size, date and storage class from the listing stay on screen with an Unavailable row.
- Requester Pays buckets (another account's bucket where the reader pays): when a read is refused and the bucket says it's Requester Pays, the app explains it and only adds the
x-amz-request-payerheader after you tap Read as payer and agree. Your account then pays for those requests and the data transfer. - A bucket in another region is handled automatically.
Permissions
| Action | Needed for | Read-only? |
|---|---|---|
s3:GetObject | Object details (HeadObject), the preview and Open | Yes |
kms:Decrypt | Previewing or opening an object encrypted with a KMS key (on that key) | Yes |
s3:GetBucketRequestPayment | Telling you a refused bucket is Requester Pays (optional) | Yes |
s3:RestoreObject | Restore (Pro) | No (it's a change, and AWS bills it) |
Questions
Does the app download the whole file to preview it?
No. It asks S3 for the first 256 KB of text, the first 1 MB of a gzip file, or 512 bytes of an unknown file. Only images up to 10 MB are fetched whole.
Can it preview files encrypted with KMS?
Yes, if your role has kms:Decrypt on the key and the key policy allows your account. If not, the preview names the key and the missing permission.
Why is Restore a Pro action?
It changes the object and AWS bills the retrieval, so it goes through the same confirm, guardrail and activity log as other changes.
Email [email protected] with what you tried and any message the app showed. Don’t send access keys or secrets. We reply within two working days.