> For the complete documentation index, see [llms.txt](https://docs.snapfix.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.snapfix.com/how-the-apps-work/screens/tasks/gallery.md).

# Gallery

{% hint style="info" %}
Draft, written by an agent and not yet checked by a person ([how to read these docs](https://docs.snapfix.com/how-to-read.md)). Platforms: web, iOS and Android. [Source on GitHub](https://github.com/snapfix/docs/blob/main/spec/screens/tasks/gallery.md).
{% endhint %}

Swipe through a task's photos and videos full screen.

* **Where:** web: a photo, sketch or video in the chat of a task ([Task detail](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md)) or of an asset ("Messages" in [Asset detail](https://docs.snapfix.com/how-the-apps-work/screens/assets/asset-detail.md)). iOS and Android: the task image or a photo, sketch or video in a task's chat; the asset image or a photo or video in an asset's messages.
* **Who:** anyone who can open the task or asset. Changing the task image and creating a task from a photo depend on the role (see Actions).
* **Feature:** [Tasks](https://docs.snapfix.com/product/features/tasks/tasks.md)

## Layout

**Web.** A full-screen lightbox from the ng-gallery library, over the task page: the item in the middle, a counter such as "3 / 7", and a strip of thumbnails. It holds the photos, sketches and videos of the chat messages loaded so far, newest first, then the task image at the end. A task with large text instead of a photo adds a picture of that text. Older messages join the gallery only once the chat has loaded them by scrolling up.

**iOS and Android.** A full-screen pager:

1. **Top bar:** close (iOS) or back (Android), the sender ("You" for the current user, otherwise the name) and the date, as "Today, 14:30" or "Nov 10 2025, 14:30". Then the action icons: create task, change image, download, share (see Actions).
2. **Item:** the task image first (a photo, or the task's large text), then the chat's photos, sketches and videos, oldest first. Deleted messages are left out. It opens at the item tapped; tapping the task's own image opens on the first item.

Photos zoom with a pinch, up to six times on iOS. Large text can't be zoomed. A video shows its thumbnail with a download or play button and a progress ring while it downloads.

## Inputs

None.

## Actions

| Action           | Who                                                                                                                                                                                                        | What happens                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | API                                                                                                |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------- |
| Open             | Anyone who can see the task                                                                                                                                                                                | Web: clicking a photo or video opens the lightbox at it. iOS and Android: the gallery opens at the item tapped; a tapped video starts downloading and plays when ready. iOS needs a connection to open on a video that isn't downloaded yet ("No Connection")                                                                                                                                                                                                                  | -                                                                                                  |
| Next or previous | Anyone                                                                                                                                                                                                     | Swipe sideways (all platforms); the web also has arrows and the thumbnails                                                                                                                                                                                                                                                                                                                                                                                                     | -                                                                                                  |
| Close            | Anyone                                                                                                                                                                                                     | Web: the close button. iOS: close, or drag the item down more than 200 points. Android: back, or swipe up or down                                                                                                                                                                                                                                                                                                                                                              | -                                                                                                  |
| Play a video     | Anyone                                                                                                                                                                                                     | Web: plays in the lightbox with controls, starting on its own. iOS: the first tap downloads it, a tap while downloading cancels, and a tap when downloaded plays it in the system player. Android: the first tap asks for storage access, downloads it and plays it while it downloads; a tap while downloading cancels; a downloaded video plays from the device                                                                                                              | -                                                                                                  |
| Download         | Anyone (iOS and Android)                                                                                                                                                                                   | iOS: saves the photo or video to Photos after asking for access, then "This image has been saved to your photo Gallery." or "This video has been saved to your photo Gallery."; a video not yet downloaded downloads first, with "Saving to Gallery...". Android: asks for storage access, saves the file, then "This image has been saved to your photo Gallery." or, for videos, "Saved to Gallery". Hidden for large text. On Android it crashes for a task without a photo | -                                                                                                  |
| Share            | Anyone (iOS and Android)                                                                                                                                                                                   | Opens the system share sheet with the photo or video file ("Share Image", "Share Video" on Android); a video downloads first. Hidden for large text                                                                                                                                                                                                                                                                                                                            | -                                                                                                  |
| Change image     | Group admins and the task's creator (iOS and Android). Only on the task image, while the task isn't archived, locked, a future planned task or outside its time range, and the user's membership is active | Opens the [Camera](https://docs.snapfix.com/how-the-apps-work/screens/tasks/camera.md) to take a new task image, or to edit the large text. The change saves on the device, adds "changed Task Image" to the chat, and syncs                                                                                                                                                                                                                                                   | Through the offline sync ([shared behavior](https://docs.snapfix.com/how-the-apps-work/shared.md)) |
| Create task      | iOS: active users in task groups. Android: anyone, in task groups. Only on chat photos, sketches and videos                                                                                                | Takes the photo (or the video and its thumbnail) into [Photo edit and name](https://docs.snapfix.com/how-the-apps-work/screens/tasks/photo-edit.md) as a new task, then [Add task to a group](https://docs.snapfix.com/how-the-apps-work/screens/tasks/pick-group.md). iOS needs a connection and reads the location first                                                                                                                                                     | -                                                                                                  |

The gallery itself can't delete anything. Messages are deleted from the chat's message menu ([Task detail](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md)).

## States

* **Loading:** web: the lightbox shows each item as the browser loads it. iOS and Android load images from the network or the device cache; a video shows a progress ring while it downloads, and Android shows a spinner while it buffers.
* **Empty:** the gallery opens only from an item, so it is never empty. A task without a photo still gets a first item, which stays blank on iOS and Android.
* **Error:** iOS: a failed video download leaves the download button. Android: "Downloading in progress…" when saving or sharing a video that is still downloading, and "Something went wrong. Please try again." when sharing fails.
* **No permission:** without access to Photos, iOS shows "Permission denied", "Please enable photo access for Snapfix in your Settings" and "CHANGE SETTINGS". Android asks for storage access with "To share/save image allow Snapfix access to your device's storage."; when the system blocks the request, it points to the app settings.
* **Offline (mobile):** photos and videos already on the device still show and play. iOS needs a connection to share or save photos too, and shows "No Connection" with "You must be connected to the Internet to carry out this task. Please connect and try again."; Android shows the same message when a download is needed.

## Platform differences

* **Order and content:** the web runs newest first and puts the task image last; iOS and Android put the task image first and run oldest first. Only the apps show the sender and date.
* **Actions:** only iOS and Android have download, share, change image and create task. On the web, the message menu in the chat has "Create Task" for photos and videos instead.
* **Zoom:** iOS and Android zoom photos; the web doesn't.
* **Video:** the web plays in place; iOS downloads before it plays, in the system player; Android streams while it downloads.
* **Opening the screen from outside the app (Android):** the gallery screen is open to other apps. Started without the app's own data, it crashes on open.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.snapfix.com/how-the-apps-work/screens/tasks/gallery.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
