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

# Select asset register

{% 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: iOS and Android. [Source on GitHub](https://github.com/snapfix/docs/blob/main/spec/screens/assets/select-asset.md).
{% endhint %}

Link assets to a task by picking an asset register, then its assets.

* **Where:** iOS: a task's "+" menu, "Add Assets"; the tagging sheet's Assets tab; the assets step of a new or planned task; the asset list's multi-select ("Add Asset"). Android: the task's tagging sheet, assets; planned tasks; multi-select. The iOS button "Add Asset to Task" sits in an old bottom menu of the task screen that never opens (see [Old iOS picker](#old-ios-picker)).
* **Who:** members who may change the task. Android does not open the picker for an archived, locked or future task, a task outside its time range, or a user who is inactive in the group. When the site's plan has no assets, iOS shows "Not included in this business account".
* **Feature:** [Asset tasks](https://docs.snapfix.com/product/features/assets/asset-tasks.md)

On the web, the same job is the "Assets" dialog on a task ([Task detail](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md#assets)), which saves through [`POST /v1/app/tasks/asset-link`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksasset-link) and [`asset-unlink`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-v1apptasksasset-unlink).

## Layout

1. **Register step.** The site's asset registers from the device copy, with their image and name. iOS (`SelectAssetGroup`) shows the number of open assets the user may see in each and sorts by name. Android (`AssetGroupSelectFragment`) titles it "Select Asset Register" and has a search.
2. **Asset step.** The register's assets with a search and a tick box on each; the assets already linked are ticked. iOS (`SelectAssetForTask`) lists all assets to admins and members with "View All Tasks", and to others only those they created, are assigned to or follow; Android (`MultipleAssetSelectFragment`) lists every asset of the register.
3. An add button at the bottom (`btnAddAsset` on Android).

## Inputs

| Field    | Type       | Required               | Default                   | Rules and messages                                                                |
| -------- | ---------- | ---------------------- | ------------------------- | --------------------------------------------------------------------------------- |
| Register | One choice | Yes, to see the assets | None                      | Opens the asset step.                                                             |
| Search   | Text       | No                     | Empty                     | Filters as you type. iOS's asset search matches title, description and reference. |
| Assets   | Tick boxes | No                     | The task's current assets | Ticking links, unticking an existing link removes it on save.                     |

## Actions

| Action                                 | Who                             | What happens                                                                                                                                                                                    | API                                                                                                                                                                                                                                                                                          |
| -------------------------------------- | ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Pick a register                        | Members who may change the task | Opens the asset step.                                                                                                                                                                           | None; the device copy                                                                                                                                                                                                                                                                        |
| Tick or untick an asset                | Same                            | Toggles the selection.                                                                                                                                                                          | None                                                                                                                                                                                                                                                                                         |
| Add (a task)                           | Same                            | Saves the links on the device and closes; the task's assets reload. iOS's picker writes a chat line "Added : {asset name}" for each new link and "Removed : {asset name}" for each removed one. | Device copy, synced as [`?action=save_pri_jobjoblink`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionsave_pri_jobjoblink); iOS chat lines as [`?action=save_pri_job_chat`](https://docs.snapfix.com/engineering-reference/api/chat.md#post-actionsave_pri_job_chat) |
| Add (a planned task or a multi-select) | Same                            | Returns the selection to the form or list that opened the picker; a planned task saves it with the planned task.                                                                                | With the caller's save                                                                                                                                                                                                                                                                       |
| Back                                   | Anyone                          | The asset step returns to the register step; the register step leaves without changes.                                                                                                          | None                                                                                                                                                                                                                                                                                         |

## States

* **Loading:** none worth noting; the lists come from the device copy.
* **Empty:** a register with no assets shows an empty asset step.
* **No plan:** "Not included in this business account" (iOS) when the site's plan has no assets.
* **Offline (mobile):** works offline; the links sync later.

## Dialogs and sheets

### Old iOS picker

`SelectAssetRegisterVC` and `SelectAssetVC` read the legacy asset tables over [`?action=parent_asset_rules`](https://docs.snapfix.com/engineering-reference/api/assets.md#post-actionparent_asset_rules) and [`?action=parent_asset_details`](https://docs.snapfix.com/engineering-reference/api/assets.md#post-actionparent_asset_details) \[[ASK-101](https://github.com/snapfix/docs/blob/main/ASK.md#ask-101-are-site-level-attribute-rules-still-meant-to-apply-to-asset-registers)], need a connection ("no internet" with a try-again button), and their save is commented out. They open only from "Add Asset to Task" in the task screen's old bottom menu, which never shows, so no one reaches them; "Add Assets" opens the current picker.

## Platform differences

| Topic                        | iOS                                           | Android                                               | Web                                   |
| ---------------------------- | --------------------------------------------- | ----------------------------------------------------- | ------------------------------------- |
| Entry from a task            | "+" menu "Add Assets", tagging sheet          | Tagging sheet                                         | The task's "Assets" dialog            |
| Assets listed                | Filtered by what the user may see             | Every asset of the register                           | The site's registers and their assets |
| Blocked tasks ("Add Assets") | The task's inactive state, and the plan check | Archived, locked, future, out of range, inactive user | Per the task's permissions            |


---

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