> 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/account/app-settings.md).

# Settings

{% 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/account/app-settings.md).
{% endhint %}

The app's own settings: the language, saving task photos and videos to the phone's gallery, buying a plan where that is offered, reloading the app's data, and deleting the profile.

* **Where:** iOS and Android: side menu "Settings", which opens the profile hub on its "Settings" tab. The hub's other tabs are "Notifications", [My profile](https://docs.snapfix.com/how-the-apps-work/screens/account/profile.md) and "Help Hub".
* **Who:** every signed-in user, for their own account and this phone.
* **Feature:** [Profile and settings](https://docs.snapfix.com/product/features/account/profile.md)

The web has no Settings screen: its language choice is in [My profile](https://docs.snapfix.com/how-the-apps-work/screens/account/profile.md).

## Layout

Top to bottom, on both apps:

1. "Language" and the current language's name. Tapping the row opens the language sheet. Both layouts hold a flag next to the name, but it is hidden.
2. "Backup Task Media to Gallery", with switches for "Backup video to gallery" and "Backup image to gallery".
3. Buying a plan, only when the paywall request returns at least one of the person's sites with in-app purchase turned on:
   * iOS: a "Subscriptions" row that opens the plan screen.
   * Android: "Upgrade your Snapfix", which opens a sheet with the upgrade information and a way to get in touch.
4. "Reload Snapfix App".
5. "Delete Profile".

Hidden parts that never show:

* iOS: an older subscription block ("Per User" and "Snapfix Pro", each with "Buy Monthly", and the terms line) sits in a container the storyboard hides. The view controller also declares a version label and a "Sync all Data" button that the storyboard does not connect; the version and that button are on the [My profile](https://docs.snapfix.com/how-the-apps-work/screens/account/profile.md) tab.
* Android: "Communication Preferences" ("Receive account updates", "Receive periodic group & task updates", "Receive product & feature updates"), a card with "Help Articles", training videos and "Contact Support", a second "Change Language" and "Reload Snapfix" card, and a "Feed" card are all `gone` in the layout \[[ASK-27](https://github.com/snapfix/docs/blob/main/ASK.md#ask-27-where-do-users-change-their-communication-consent-and-how-should-it-be-stored)]. Three copies of the subscription block, with their "Buy Monthly" labels, are inside XML comments, so they are not in the screen at all (android @ 86068bfeea, `app/src/main/res/layout/layout_content_profile_settings.xml:399-532`, `:582-715`, `:944-1077`).

## Inputs

| Field                     | Type               | Required | Default                   | Rules and messages                                                                                                                                                                                                                    |
| ------------------------- | ------------------ | -------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Language                  | Choice, in a sheet | Yes      | The language the app uses | The app's own translations: 26 on iOS; Android has its own list \[[ASK-37](https://github.com/snapfix/docs/blob/main/ASK.md#ask-37-which-languages-should-each-platform-offer)]. Choosing the current language only closes the sheet. |
| "Backup video to gallery" | Switch             | No       | Off                       | iOS asks for photo-library access when it is turned on. If access is refused, the switch flips back off, but the stored choice stays on. Android stores the switch with no permission prompt here.                                    |
| "Backup image to gallery" | Switch             | No       | Off                       | Same as the video switch.                                                                                                                                                                                                             |

## Actions

| Action                           | Who                        | What happens                                                                                                                                                                                                                                                                                         | API                                                                                                                                    |
| -------------------------------- | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| Change the language              | Signed-in user             | Stores the choice on the phone, sends it to the account, and restarts the app at the [splash screen](https://docs.snapfix.com/how-the-apps-work/screens/account/splash.md) in the new language. Android skips the server call when offline; iOS sends it anyway.                                     | `save_pri_user_v7` on [Users API](https://docs.snapfix.com/engineering-reference/api/users.md)                                         |
| Gallery switches                 | Signed-in user             | Stored on the phone. Task photos and videos are then saved to the gallery, or not.                                                                                                                                                                                                                   | -                                                                                                                                      |
| "Subscriptions" (iOS)            | Signed-in user, when shown | Offline: an "Error" alert with the internet message. Online: opens the plan screen for the sites ([In-app purchase](https://docs.snapfix.com/product/features/billing/in-app-purchase.md)).                                                                                                          | Shown from `paywall` on [Billing API](https://docs.snapfix.com/engineering-reference/api/billing.md)                                   |
| "Upgrade your Snapfix" (Android) | Signed-in user, when shown | Opens the upgrade sheet.                                                                                                                                                                                                                                                                             | Shown from `paywall` on [Billing API](https://docs.snapfix.com/engineering-reference/api/billing.md)                                   |
| "Reload Snapfix App"             | Signed-in user             | Offline: iOS shows "You must be connected to the Internet to carry out this task. Please connect and try again." with "Ok"; Android shows its connection alert. Online: a confirmation sheet, then [Reloading Snapfix](https://docs.snapfix.com/how-the-apps-work/screens/account/download-data.md). | -                                                                                                                                      |
| "Delete Profile"                 | Signed-in user             | Opens the delete dialog (below).                                                                                                                                                                                                                                                                     | [`DELETE ?action=delete_user_account`](https://docs.snapfix.com/engineering-reference/api/account.md#delete-actiondelete_user_account) |

## States

* **Loading:** the plan row stays hidden until the paywall request returns. Delete shows "Refreshing..." on iOS while the request runs.
* **Empty:** a person with no site that offers in-app purchase sees no plan row.
* **Error:** delete shows the server's message, or the generic failure, with "Ok". On iOS a 403 signs the user out, and a 406 or unauthorised answer opens a short sign-in and retries the delete.
* **No permission:** the iOS gallery switches need photo-library access; see Inputs.
* **Offline (mobile):** the language and gallery switches still work on the phone. Reload and delete need a connection. The plan row stays hidden.

## Dialogs and sheets

* **Language:** a sheet with the language list (`LanguageChangeVC` on iOS, `BottomSheetLanguageSelection` on Android).
* **Reload confirmation:** iOS a sheet titled "Reload" with "Are you sure you want to reload all Snapfix tasks?" and a "Reload" button. Android a sheet titled "Reload" with the same question, "Yes" and "No"; "Yes" runs the storage check described in [Reloading Snapfix](https://docs.snapfix.com/how-the-apps-work/screens/account/download-data.md).
* **Delete:**
  * iOS: "Delete Profile", "Are you sure you want to delete your Snapfix profile?", "Deleting your profile will remove you from Snapfix. You will not be able to log into Snapfix again." and "A deleted profile can not be reinstated.", with "Delete Profile" and "Cancel". Success opens a full-screen "Snapfix profile deleted" confirmation whose "Close Snapfix app" button signs the person out.
  * Android: "Delete Snapfix Profile", the same question, "Deleting your profile will remove you from Snapfix.You will not be able to log into Snapfix again." (no space after the full stop) and "A deleted profile can not be reinstated.", with "Cancel" and "Delete Snapfix Profile". Android will not open it offline. Success clears the local data and shows a dialog whose button closes the app.

## Platform differences

| Topic                 | iOS                                                       | Android                                                                                                                                                                                              |
| --------------------- | --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Plan row              | "Subscriptions", opens the plan screen                    | "Upgrade your Snapfix", opens a contact sheet                                                                                                                                                        |
| Gallery permission    | Asked when a switch turns on; a refusal still stores "on" | Not asked here                                                                                                                                                                                       |
| Language sync offline | Sent anyway                                               | Skipped                                                                                                                                                                                              |
| Reload confirmation   | "Reload" button                                           | "Yes" and "No"                                                                                                                                                                                       |
| Delete dialog title   | "Delete Profile"                                          | "Delete Snapfix Profile"                                                                                                                                                                             |
| Hidden content        | Old subscription block                                    | Communication preferences, help links, extra rows \[[ASK-27](https://github.com/snapfix/docs/blob/main/ASK.md#ask-27-where-do-users-change-their-communication-consent-and-how-should-it-be-stored)] |


---

# 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/account/app-settings.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.
