# 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.

Screenshot: JSON preview of app-config.json as a tree with Tree and Text views

Screenshot: CSV preview: a table of orders with the header row detected and a KMS key note

Screenshot: PNG image preview with pinch to zoom

Screenshot: A KMS-encrypted object the role cannot decrypt: Needs kms:Decrypt on the key

## 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](https://cloudconsole.dev/help/share-s3-file). 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](https://cloudconsole.dev/help/free-and-pro) action, at your [guardrail](https://cloudconsole.dev/help/guardrails) 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:GetObject` on `arn:aws:s3:::bucket/key` and, 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-payer` header 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.

**Still stuck?**

Email [support@cloudconsole.dev](mailto:support@cloudconsole.dev) with what you tried and any message the app showed. Don’t send access keys or secrets. We reply within two working days.

## Related

- [Share an S3 file with a link](https://cloudconsole.dev/help/share-s3-file) – Using the app
- [Understand "No permission" and other access errors](https://cloudconsole.dev/help/access-denied) – Permissions & errors
- [Recommended read-only permissions](https://cloudconsole.dev/help/recommended-permissions) – Permissions & errors
- [Permissions for changes (Pro actions)](https://cloudconsole.dev/help/permissions-for-changes) – Permissions & errors

[All help topics →](https://cloudconsole.dev/help/)

---

Source: https://cloudconsole.dev/help/preview-s3-objects

CloudConsole is an independent iPhone and Android app for Amazon Web Services by Cloudconcur Ltd. It is not affiliated with Amazon Web Services.
