> 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/assets/asset-list.md).

# Asset list

{% 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/assets/asset-list.md).
{% endhint %}

The assets in one register, as a grid or a list, with search, sorting, filters and multi-select; from here people open an asset, create one, or change many at once.

![Asset list](https://3653879137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVVGa79QbcEkJ7n8srxe%2Fuploads%2Fgit-blob-5c8ca9a145c8c79ac093fe4bf42edf611643f275%2Fasset-list.png?alt=media)

* **Where:** web `/asset-register/:id/assets`; iOS and Android: [Asset registers](https://docs.snapfix.com/how-the-apps-work/screens/assets/registers.md) > a register. Back returns to the registers.
* **Who:** members of the register. The list holds only the assets the user may see: admins and members with "View All Tasks" see all, others only those they created, are assigned to or follow ([`POST /v1/app/assets/list`](https://docs.snapfix.com/engineering-reference/api/assets.md#post-v1appassetslist)); the apps apply the same rule to the device copy. Creating needs the "Create New Task" permission of the register. Menu items and bulk actions follow the register's task permissions ([Who can do what](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md#who-can-do-what)).
* **Feature:** [Asset registers](https://docs.snapfix.com/product/features/assets/asset-registers.md); bulk actions: [Multi-select](https://docs.snapfix.com/product/features/tasks/multi-select.md)

## Layout

**Web**, top to bottom:

1. Header: the back button (tooltip "Back"), the register's image and name, and a gear button (tooltip "Settings") that opens [Asset register settings](https://docs.snapfix.com/how-the-apps-work/screens/assets/register-settings.md).
2. Row 1: the tab "ASSETS" with the count in brackets ("filter / total", as in "Assets (7 / 38)", while a search or filter is on; the live page shows "Assets (n)"), the filter button (tooltip "Filter"), the search field "Search", the "+" (tooltip "Create", only with the create permission) and the three-dot menu with "Mark All as Read" and "Select Asset". In a multi-site view the three-dot menu is hidden.
3. Row 2: four icon buttons for sort, date ("Display Assets"), "Assigned to me" and priority. They have hover tooltips but no visible label or accessible name. The grid or list switch sits at the right end.
4. The filter banner, one chip per filter, while filters other than the default are on.
5. The assets. Grid: one card per asset with the photo (or large text), the status icon and the priority mark, and the title. List: the same, plus the last edit time ("MMM D HH:mm") and the red, amber and green counts of the asset's tasks. More assets load as the list scrolls.

Multi-select replaces rows 1 and 2 with a bar: "Select All" (menu "Select Loaded Assets" or "Select ALL Assets"), the count ("{{$1}} asset(s) selected"), "Actions", "Changes Priority", "Changes Status" and a close button.

**iOS:** the header (back, the register's name and counts, and purpose), a search and filter row, the asset rows (photo, title, status, priority, attributes), a scan button and a camera button, and an overflow menu.

**Android:** a header with back, the register's name, a settings button (the purpose page for users without the settings permission) and the "+" menu button; a sort menu and a filter drawer; and the asset rows or grid.

## Inputs

| Field                     | Type                         | Required | Default                                | Rules and messages                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ------------------------- | ---------------------------- | -------- | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Search                    | Text                         | No       | Web: the last search for this register | Placeholder "Search". The web reloads the list one second after the last key press; the server matches the asset's search text (colour, reference, title, description), its exact reference, a text message in its chat, or an attribute value. The apps filter the device copy.                                                                                                                                                               |
| Sort by                   | One of seven                 | No       | "Latest update (newest-oldest)"        | "Priority", "Latest update (newest-oldest)", "Latest update (oldest-newest)", "Create date (newest-oldest)", "Create date (oldest-newest)", "Alphabetical (A-Z)", "Alphabetical (Z-A)", with "Cancel" and "Apply". Assets have no due-date option. The server sorts.                                                                                                                                                                           |
| Display Assets            | Date range                   | No       | "All Assets"                           | "See only the assets updated in the last:" "Week", "Month" or "All Assets", then "Cancel" or "Apply".                                                                                                                                                                                                                                                                                                                                          |
| Assigned to me            | Toggle                       | No       | Off                                    | Applies at once, with no panel.                                                                                                                                                                                                                                                                                                                                                                                                                |
| Priority                  | Options                      | No       | None                                   | "Show only assets with priority:" 1 and 2, with "Clear Filters" and "Apply".                                                                                                                                                                                                                                                                                                                                                                   |
| Filters (drawer "Filter") | Switches, users, dates, text | No       | Active assets only                     | "Snapfilters": "Asset Status" ("New Assets", "Assets In Progress", "Completed Assets"), "Priority" (1, 2), "Assigned to me", "Unread", "Active assets", "Archived assets". "Advanced": "People" ("Created by", "Assigned to"), "Dates" ("Created date", "Activity date"), "Attribute" (a text box) and "Only includes assets with cost". "Clear Filters" and "Apply". "Active assets" and "Archived assets" are a pair, one of which stays on. |
| View (web)                | Grid or list                 | No       | Grid                                   | Remembered per register for the session.                                                                                                                                                                                                                                                                                                                                                                                                       |

## Actions

| Action                            | Who                                     | What happens                                                                                                                                                                                                                                                                                     | API                                                                                                                                                                                                                                                                                                                                                                  |
| --------------------------------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Page opens (web)                  | Members                                 | Reads the register, then the first page of assets and their update flags. A register that cannot be read sends the user back.                                                                                                                                                                    | [`GET /v1/app/asset-regs/{uuid}`](https://docs.snapfix.com/engineering-reference/api/assets.md#get-v1appasset-regsuuid), [`POST /v1/app/assets/list`](https://docs.snapfix.com/engineering-reference/api/assets.md#post-v1appassetslist), [`POST /v1/app/tasks/get-updates`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksget-updates) |
| Open an asset                     | Anyone who sees it                      | Opens [Asset detail](https://docs.snapfix.com/how-the-apps-work/screens/assets/asset-detail.md). On the web, its "Previous" and "Next" walk through the list this page loaded.                                                                                                                   | None on this page                                                                                                                                                                                                                                                                                                                                                    |
| Search, sort, filter              | Anyone                                  | Reloads the list from the first page (web); filters the device copy (apps).                                                                                                                                                                                                                      | Web: [`POST /v1/app/assets/list`](https://docs.snapfix.com/engineering-reference/api/assets.md#post-v1appassetslist)                                                                                                                                                                                                                                                 |
| Load more (web)                   | Anyone                                  | Scrolling to the end loads the next page.                                                                                                                                                                                                                                                        | [`POST /v1/app/assets/list`](https://docs.snapfix.com/engineering-reference/api/assets.md#post-v1appassetslist) with `offset`                                                                                                                                                                                                                                        |
| Create an asset (web, "+")        | "Create New Task" on the register       | Opens [Add an Asset](#add-an-asset-web). On success the new asset opens.                                                                                                                                                                                                                         | [`POST /v1/app/assets`](https://docs.snapfix.com/engineering-reference/api/assets.md#post-v1appassets); attributes: [`POST /v1/app/assets/save-attributes`](https://docs.snapfix.com/engineering-reference/api/assets.md#post-v1appassetssave-attributes)                                                                                                            |
| Create an asset (apps)            | Create permission                       | Android: "Create a new Asset" in the "+" menu. iOS: the camera button; after the photo the app opens [Asset attributes](https://docs.snapfix.com/how-the-apps-work/screens/assets/asset-attributes.md) for the new asset, once the site's task limit and the assign-user rule have been checked. | Device copy, then the sync                                                                                                                                                                                                                                                                                                                                           |
| Mark All as Read (web)            | Anyone                                  | Marks every asset in the register as read, with no dialog.                                                                                                                                                                                                                                       | [`GET /v1/app/tasks/mark-as-read/{type}/{itemUuid}`](https://docs.snapfix.com/engineering-reference/api/tasks.md#get-v1apptasksmark-as-readtypeitemuuid)                                                                                                                                                                                                             |
| Select assets (web)               | Anyone                                  | "Select Asset" turns on the selection boxes; a click then selects instead of opening. "Select Loaded Assets" selects the loaded rows ("38 Asset(s) Selected" was seen live); "Select ALL Assets" selects every asset that matches the filters.                                                   | None until an action runs                                                                                                                                                                                                                                                                                                                                            |
| "Changes Priority" (web)          | Any member who sees the assets          | Opens "Set priority for {{$1}} asset(s)" or "Remove priority for {{$1}} asset(s)", then "Cancel" or "Ok".                                                                                                                                                                                        | [`POST /v1/app/assets/multi/priority`](https://docs.snapfix.com/engineering-reference/api/assets.md#post-v1appassetsmultipriority) or [`all/priority`](https://docs.snapfix.com/engineering-reference/api/assets.md#post-v1appassetsallpriority)                                                                                                                     |
| "Changes Status" (web)            | Members with the colour permission      | Opens the status dialog. All selected assets must have the same colour.                                                                                                                                                                                                                          | [`POST /v1/app/assets/multi/status`](https://docs.snapfix.com/engineering-reference/api/assets.md#post-v1appassetsmultistatus) or [`all/status`](https://docs.snapfix.com/engineering-reference/api/assets.md#post-v1appassetsallstatus)                                                                                                                             |
| "Actions" > "Add Checklist" (web) | Users who may manage checklists         | Opens the add-checklist dialog for the selection; when some assets already have a checklist, a dialog asks to replace it first.                                                                                                                                                                  | [Checklists API](https://docs.snapfix.com/engineering-reference/api/checklists.md)                                                                                                                                                                                                                                                                                   |
| "Actions" > "Archive" (web)       | "Delete or Archive Tasks"               | "You're about to archive {{$1}} asset(s). Do you want to proceed?"                                                                                                                                                                                                                               | [`POST /v1/app/assets/multi/archive`](https://docs.snapfix.com/engineering-reference/api/assets.md#post-v1appassetsmultiarchive) or [`all/archive`](https://docs.snapfix.com/engineering-reference/api/assets.md#post-v1appassetsallarchive)                                                                                                                         |
| "Actions" > "Lock" (web)          | Group admin or the creator, per the API | "You're about to lock {{$1}} asset(s). Do you want to proceed?" The bulk action only locks; unlocking is per asset.                                                                                                                                                                              | [`POST /v1/app/assets/multi/lock`](https://docs.snapfix.com/engineering-reference/api/assets.md#post-v1appassetsmultilock) or [`all/lock`](https://docs.snapfix.com/engineering-reference/api/assets.md#post-v1appassetsalllock)                                                                                                                                     |
| "Actions" > "Delete" (web)        | "Delete or Archive Tasks"               | "You're about to delete {{$1}} asset(s). Do you want to proceed?" In the archived view this is the only item.                                                                                                                                                                                    | [`POST /v1/app/assets/multi/delete`](https://docs.snapfix.com/engineering-reference/api/assets.md#post-v1appassetsmultidelete) or [`all/delete`](https://docs.snapfix.com/engineering-reference/api/assets.md#post-v1appassetsalldelete)                                                                                                                             |
| Bulk actions (apps)               | Per action                              | See [Dialogs and sheets](#dialogs-and-sheets). Done on the device and synced.                                                                                                                                                                                                                    | Sync                                                                                                                                                                                                                                                                                                                                                                 |
| Scan (apps)                       | Anyone                                  | Opens the [Code scanner](https://docs.snapfix.com/how-the-apps-work/screens/assets/code-scanner.md); iOS's "Search by code" puts the scanned text into the search field.                                                                                                                         | None                                                                                                                                                                                                                                                                                                                                                                 |
| Leave (web)                       | Anyone                                  | Back returns to the registers. When the list had updates, the page marks the register as visited.                                                                                                                                                                                                | [`GET /v1/app/businesses/mark-as-visited/{businessUuid}`](https://docs.snapfix.com/engineering-reference/api/groups.md#get-v1appbusinessesmark-as-visitedbusinessuuid)                                                                                                                                                                                               |
| Leave (iOS)                       | Anyone                                  | Before going back, iOS warns when assets the user changed still have photos that are not uploaded, and lists them.                                                                                                                                                                               | None                                                                                                                                                                                                                                                                                                                                                                 |

Bulk actions send the selected IDs, or the filters for "Select ALL Assets". The web refuses lock, archive, priority and status when every selected asset is locked ("All selected assets are locked"), and refuses status when the colours differ. The bulk endpoints take asset IDs from any register.

## States

* **Loading:** web: a skeleton of tiles; a loader at the bottom while the next page loads. Apps: the device copy shows at once.
* **Empty:** web: "Manage your Assets in a Snap!" and "To add an asset, click on the + button." The "+" in that line does nothing, and the line shows to people who cannot create too. A search or filter with no match shows the same first-use text. The apps show their own empty views with a create button.
* **Error:** web: a failed list request shows no message; the list stays empty and shows the placeholder.
* **No permission:** no "+" without the create permission. An asset the user may not view is not listed.
* **Archived view:** with the archived filter on, the web's bulk menu offers only "Delete".
* **Offline (mobile):** the apps list the device copy, including assets not synced yet, and queue changes for the sync ([Shared behavior](https://docs.snapfix.com/how-the-apps-work/shared.md)).

## Dialogs and sheets

### Add an Asset (web)

The task create dialog in asset mode ([Add a task](https://docs.snapfix.com/how-the-apps-work/screens/tasks/add-task.md)).

* The signed-in user's picture and name at the top, then the field "Asset name" (up to 255 characters).
* The media buttons: text, sketch, picture, video and microphone. In text mode the area is a large-text box of 50 characters with a counter ("0 / 50"). "Block Photos from Gallery" on the register turns off picture and video.
* "Save" is off while the name is empty or only spaces, and, outside text mode, until a photo, sketch, video or recording is added.
* When the register has a mandatory attribute, the attributes dialog opens before the asset is saved ([Asset detail](https://docs.snapfix.com/how-the-apps-work/screens/assets/asset-detail.md#attributes-web)); the values are saved after the asset.

### Selection dialogs (web)

* **Changes Status:** a mixed selection gets the alert "Selection contains assets with different statuses. Please select assets with the same status to proceed." with "OK".
* **Results:** "You've archived {{$1}} asset(s)", "You've locked {{$1}} asset(s)", "You've deleted {{$1}} asset(s)", "You've set a new status for {{$1}} asset(s)".
* **Checklist:** the add-checklist dialog for the selection ([Checklist](https://docs.snapfix.com/how-the-apps-work/screens/checklists/checklist.md)).

### Plus menu (Android)

"Scan Asset QR or Barcode" and "Scan Asset Smart Tag" (see [Code scanner](https://docs.snapfix.com/how-the-apps-work/screens/assets/code-scanner.md)), "Create a new Asset" (with the create permission), "Asset Details Report (XLSX)" (admins and users with the report permission), "Analytics", and "Advanced Actions" with "Mark all as read", "Archive selected" and "Delete selected", which act on the register's assets, each with its permission.

### Overflow menu and bulk bar (iOS)

* The overflow menu: the scan items, "Create new", "Asset Details Report (XLSX)" (users who are not plain users, or who may make reports), "Analytics", and "Advanced Actions" with "Mark all as read", "Archive selected" and "Delete selected" (for users who may delete). "Unarchive Selected" shows only to six accounts named in the app. The menu has no settings item; its settings entry is commented out.
* The bulk bar after "Select all": priority, status, tags, users, reminders, adding assets, copy or move, archive, lock and delete for the selection. In the archived view it keeps "Delete".

## Platform differences

| Topic                 | Web                                                                                                     | iOS                                                                                                                                             | Android                                             |
| --------------------- | ------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| Source                | The server, paged                                                                                       | The device copy                                                                                                                                 | The device copy                                     |
| Create                | "+" opens "Add an Asset"                                                                                | Camera button, then [Asset attributes](https://docs.snapfix.com/how-the-apps-work/screens/assets/asset-attributes.md); "Create new" in the menu | "Create a new Asset" in the "+" menu                |
| Bulk actions          | Status, priority, checklist, archive, lock, delete                                                      | Also users, tags, reminders, adding assets, copy, move, removing priority; on the device                                                        | Mark all as read, archive and delete for all assets |
| Scan                  | No                                                                                                      | Scan button, "Search by code"                                                                                                                   | "+" menu                                            |
| Reports and analytics | Not here ([Asset reports](https://docs.snapfix.com/how-the-apps-work/screens/reports/asset-reports.md)) | Menu                                                                                                                                            | Menu                                                |
| Multi-site            | Three-dot menu hidden                                                                                   | The selected site                                                                                                                               | The selected site                                   |

Which bulk set is intended is not known \[[ASK-105](https://github.com/snapfix/docs/blob/main/ASK.md#ask-105-which-bulk-actions-should-assets-have-on-each-platform)].


---

# 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/assets/asset-list.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.
