> 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/product/features/account/profile.md).

# Profile and 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)). [Source on GitHub](https://github.com/snapfix/docs/blob/main/product/features/profile.md).
{% endhint %}

Every signed-in person has a **profile** with their name, photo, email address, phone number and **on-call** status. They change these themselves; other people are managed by a site admin ([Site users](https://docs.snapfix.com/product/features/console/site-users.md)). A new email address or phone number counts only after it is confirmed with a code. People can also change their password and their language, and delete the profile, after which they can't sign in again. On the web the profile is a drawer from the side menu. In the mobile apps it is the "My Profile" tab of a profile hub, and the language, the gallery switches and the plan options sit on its separate **Settings** tab.

## Rules

### Name and photo

* The web edits each field in its own dialog; the apps edit in place with "Save" and "Cancel" ([My profile](https://docs.snapfix.com/how-the-apps-work/screens/account/profile.md#platform-differences)).
* The web requires a first name and a last name, up to 30 characters each. The apps check only the first name. The API sets no length limit \[[ASK-35](https://github.com/snapfix/docs/blob/main/ASK.md#ask-35-is-the-webs-30-character-name-limit-intended)] ([My profile](https://docs.snapfix.com/how-the-apps-work/screens/account/profile.md#inputs)).
* The server saves the name exactly as sent. Nothing is escaped on save, and a group admin's "Delete User" dialog shows the name as HTML ([Account API](https://docs.snapfix.com/engineering-reference/api/account.md#put-v1appuser)).
* The web crops a new photo in the upload dialog; with no photo it shows initials. The apps save the name and photo together ([My profile](https://docs.snapfix.com/how-the-apps-work/screens/account/profile.md#actions)).

### Email and phone

* A new email address or phone number is confirmed with a six-character code sent to it; the old one stays until then. On the web the code uses digits and lowercase letters (api\_php\_live\_v2 @ ef3c4319f6, `UserController.php:233`, `app/Helpers/common.php:362-368`).
* On the web a code is valid for 30 days, and it is checked against the newest code the account was sent (`UserController.php:302-336`) \[[ASK-31](https://github.com/snapfix/docs/blob/main/ASK.md#ask-31-should-profile-verification-codes-last-30-days)].
* The apps send the stored password with an email or phone change (`ProfileViewModel.swift:286-288`; `MyProfileActivity.kt:1931`).
* Verified contacts show a tick (web) or "Verified" (apps); unverified ones offer a way to send a code ([My profile](https://docs.snapfix.com/how-the-apps-work/screens/account/profile.md#layout)).
* Email, phone and password can only be changed by people who sign in with a Snapfix password. For Google, Apple or Microsoft sign-ins the web and iOS hide these controls (ios @ aa31967ac8, `SnapFix/New Profile/Profile/ProfileVC.swift:162-176`; [My profile](https://docs.snapfix.com/how-the-apps-work/screens/account/profile.md#platform-differences)).

### Verification required

* When the server answers 409 because the email or phone is not verified, the web shows a verification dialog with "Go to Profile". While verification is required, the photo, name and on-call controls are disabled and the drawer's close button is hidden ([My profile](https://docs.snapfix.com/how-the-apps-work/screens/account/profile.md#states), `auth.interceptor.ts`). The apps open their verify sheets instead of the requested change.

### Password

* Changing a password needs the current password, unless the sign-in is recent or the account has a temporary password (`UpdatePasswordRequest.php:15-22`). The new password needs at least 8 characters, with an uppercase letter, a lowercase letter and a number, and the web shows the rules as a list ([My profile](https://docs.snapfix.com/how-the-apps-work/screens/account/profile.md#inputs)).
* In the apps a wrong current password offers a reset by text or email, which sends a new password ([Password reset](https://docs.snapfix.com/product/features/account/password-reset.md#legacy-reset)).

### Language

* The web picks the language from a list in the drawer, saves it with the profile and reloads the page ([My profile](https://docs.snapfix.com/how-the-apps-work/screens/account/profile.md#actions)).
* The apps pick it on the Settings tab, save it on the phone and to the account, and apply it. iOS saves on the language screen (`LanguageChangeVC.swift:120`). Android syncs on a best-effort basis and sends it again with a later profile save or data sync if it fails (`UserLanguageManager.kt:174-209`). The account has one saved language.
* The API accepts 26 language codes (`app/Enums/SupportedLanguage.php:7-32`).

### On-call status

* On-call status is set per site, with one switch for each site ([My profile](https://docs.snapfix.com/how-the-apps-work/screens/account/profile.md#actions)).
* The web changes one site at a time through `PUT /v1/app/user/on-call-status`. The apps change one site through `?action=update_on_call_status` and can switch all sites at once through the same `PUT` ([My profile](https://docs.snapfix.com/how-the-apps-work/screens/account/profile.md#actions)).
* People who are on call are shown in the site switcher ([Switching sites](https://docs.snapfix.com/product/features/groups/site-switching.md)). What else being on call changes is not documented \[[ASK-36](https://github.com/snapfix/docs/blob/main/ASK.md#ask-36-what-does-being-on-call-change)].
* Whether a site that has blocked the person still accepts their on-call change is open.

### Communication preferences

* The web has a card with three opt-in choices ("Receive site updates", "Receive periodic group & task updates", "Receive product & feature updates"), but no page shows it, so nobody can change email consent on the web \[[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)] (web\_app\_v2 @ 0989b8e685, `src/app/components/profile-drawer/profile-communication-preferences/`).
* The apps keep consent on the phone and upload it in the background (`?action=save_pri_log_usergdpr`) ([Account API](https://docs.snapfix.com/engineering-reference/api/account.md#post-actionsave_pri_log_usergdpr)).

### Gallery and plans (apps)

* Two switches save new photos and videos to the phone's gallery. They need photo-library access; when it is refused, the switch turns back off ([Settings](https://docs.snapfix.com/how-the-apps-work/screens/account/app-settings.md#inputs)).
* Only iOS sells plans in the app, in a Snapfix Pro block shown when the site's plans allow it. Android points to support ([Settings](https://docs.snapfix.com/how-the-apps-work/screens/account/app-settings.md#platform-differences), [In-app purchase](https://docs.snapfix.com/product/features/billing/in-app-purchase.md)).

### Deleting the profile

* "Delete My Profile" asks for confirmation: "Deleting your profile will remove you from Snapfix … You will not be able to log into Snapfix again." and "A deleted profile cannot be reinstated." ([My profile](https://docs.snapfix.com/how-the-apps-work/screens/account/profile.md#actions)). The web dialog shows raw markup and a broken warning image.
* Deleting needs a recent sign-in. Without one the server refuses (406), and the app asks the person to sign in again and then deletes ([Account API](https://docs.snapfix.com/engineering-reference/api/account.md#delete-v1appuser)).
* The row is kept and marked deleted. The first name gets a "DEL -" prefix, and the sign-in name is replaced by a marker that still contains the old email address and phone number; the phone fields are cleared. The last name, photo and everything the person wrote stay attached to the renamed user (`UserController.php:190-214`) \[[ASK-25](https://github.com/snapfix/docs/blob/main/ASK.md#ask-25-what-should-deleting-a-profile-remove)].
* The web's dialog and confirmation page say that the profile details are removed. The code does not remove them \[[ASK-25](https://github.com/snapfix/docs/blob/main/ASK.md#ask-25-what-should-deleting-a-profile-remove)].
* After a web deletion, [Snapfix profile deleted](https://docs.snapfix.com/how-the-apps-work/screens/account/profile-deleted.md) opens. It needs a flag set at deletion, so a reload goes to sign-in, and its "Close Window" button also goes to sign-in. iOS shows its own confirmation screen and signs the person out; Android shows a dialog and then opens sign-in ([Snapfix profile deleted](https://docs.snapfix.com/how-the-apps-work/screens/account/profile-deleted.md#platform-differences)).
* Some screens show deleted users as "Del -" and their first name.

## Flow

```mermaid
flowchart TD
  open["Open My profile"] --> what{"What to change?"}
  what -- "name, photo, language, on-call" --> save["Save; the change is sent"]
  what -- "email or phone" --> code["Send a code to the new email or phone"]
  code --> enter["Enter the six-character code"]
  enter -- "right and in time" --> verified["New contact saved and verified"]
  enter -- "wrong or expired" --> error["Error message"]
  what -- "password" --> recent{"Sign-in recent?"}
  recent -- no --> oldpw["Enter the current password"]
  recent -- yes --> newpw["Enter and confirm the new password"]
  oldpw --> newpw
  newpw --> rules{"Rules met?"}
  rules -- no --> newpw
  rules -- yes --> changed["Password changed"]
  what -- "delete profile" --> fresh{"Sign-in recent?"}
  fresh -- no --> mini["Sign in again, then delete"]
  fresh -- yes --> gone["Profile deleted, then sign-in"]
  mini --> gone
```

## Platforms

| Capability                            | Web                                                                                                                                                                    | iOS                                  | Android                             |
| ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ | ----------------------------------- |
| Where                                 | a drawer from the side menu                                                                                                                                            | "My Profile" tab of the profile hub  | "My Profile" tab of the profile hub |
| Name check                            | first and last name, 30 characters each                                                                                                                                | first name only                      | first name only                     |
| Email or phone change with a code     | yes                                                                                                                                                                    | yes                                  | yes                                 |
| Change password                       | yes, Snapfix sign-in only                                                                                                                                              | yes, Snapfix sign-in only            | yes                                 |
| Wrong current password offers a reset | no                                                                                                                                                                     | yes                                  | yes                                 |
| On-call per site                      | yes                                                                                                                                                                    | yes, and all sites at once           | yes, and all sites at once          |
| Language                              | in the drawer; the page reloads                                                                                                                                        | on the Settings tab                  | on the Settings tab                 |
| Photos and videos to the gallery      | no                                                                                                                                                                     | yes                                  | yes                                 |
| Plans in the app                      | no                                                                                                                                                                     | Snapfix Pro, when the plans allow    | points to support                   |
| Communication preferences             | built but not shown \[[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)] | kept and uploaded                    | kept and uploaded                   |
| After deleting                        | "Snapfix profile deleted", then sign-in                                                                                                                                | confirmation screen, then signed out | dialog, then sign-in                |
| "Reload"                              | no                                                                                                                                                                     | yes, in Settings and the side menu   | yes, in the side menu               |

## Screens

* [My profile](https://docs.snapfix.com/how-the-apps-work/screens/account/profile.md)
* [Settings](https://docs.snapfix.com/how-the-apps-work/screens/account/app-settings.md) (apps)
* [Snapfix profile deleted](https://docs.snapfix.com/how-the-apps-work/screens/account/profile-deleted.md) (web)
* [Reloading Snapfix](https://docs.snapfix.com/how-the-apps-work/screens/account/download-data.md), for "Reload"

## API and data

* [Account API](https://docs.snapfix.com/engineering-reference/api/account.md): [`GET /v1/app/user`](https://docs.snapfix.com/engineering-reference/api/account.md#get-v1appuser) and [`PUT /v1/app/user`](https://docs.snapfix.com/engineering-reference/api/account.md#put-v1appuser) (name, photo, language), [`DELETE /v1/app/user`](https://docs.snapfix.com/engineering-reference/api/account.md#delete-v1appuser), [`GET /v1/app/user/on-call-status`](https://docs.snapfix.com/engineering-reference/api/account.md#get-v1appuseron-call-status) and [`PUT /v1/app/user/on-call-status`](https://docs.snapfix.com/engineering-reference/api/account.md#put-v1appuseron-call-status), [`GET /v1/app/user/gdpr`](https://docs.snapfix.com/engineering-reference/api/account.md#get-v1appusergdpr) and [`POST /v1/app/user/gdpr`](https://docs.snapfix.com/engineering-reference/api/account.md#post-v1appusergdpr) (no web page calls them). The apps delete through `?action=delete_user_account`, set on-call through `?action=update_on_call_status` and send consent through `?action=save_pri_log_usergdpr`.
* [Auth API](https://docs.snapfix.com/engineering-reference/api/auth.md): `POST /v1/app/user/generate-code` and `POST /v1/app/user/verify-code` (codes); `PUT /v1/app/user/update-password`; the apps' `?action=edit_user_password_v7`, `?action=generate_code_v8` and `?action=verify_code_v8`.
* [Users API](https://docs.snapfix.com/engineering-reference/api/users.md): the apps' `?action=save_pri_user_v7`, which saves the profile and the language.
* Tables: [`tPri_User`](https://docs.snapfix.com/engineering-reference/db/tables/tpri_user.md) (name, email, phone, language, photo, verified and deleted flags), [`tPri_UserParent`](https://docs.snapfix.com/engineering-reference/db/tables/tpri_userparent.md) (on-call per site), [`tPri_Log_UserGdpr`](https://docs.snapfix.com/engineering-reference/db/tables/tpri_log_usergdpr.md) (communication preferences), and [`credential_code`](https://docs.snapfix.com/engineering-reference/db/tables/credential_code.md) (codes).

## Depends on

* [Sign-in](https://docs.snapfix.com/product/features/account/sign-in.md): sessions, the recent-sign-in rule, verification and the provider limits.
* [Password reset](https://docs.snapfix.com/product/features/account/password-reset.md): the password rules and the legacy reset.
* [Switching sites](https://docs.snapfix.com/product/features/groups/site-switching.md) and [Site users](https://docs.snapfix.com/product/features/console/site-users.md): on-call per site, and blocks.
* [In-app purchase](https://docs.snapfix.com/product/features/billing/in-app-purchase.md) and [Subscriptions](https://docs.snapfix.com/product/features/billing/subscriptions.md): the iOS plan block.
* [Push notifications](https://docs.snapfix.com/product/features/notifications/push-notifications.md): the Notifications tab of the profile hub.
* [Help Hub](https://docs.snapfix.com/product/features/help/help-hub.md): the Help Hub tab of the profile hub.
* [App launch](https://docs.snapfix.com/product/features/account/app-launch.md): "Reload".

## Edge cases

* **Offline:** web requests fail and the shared error alert shows. The apps alert and send nothing; the gallery switches and the language still apply on the phone ([My profile](https://docs.snapfix.com/how-the-apps-work/screens/account/profile.md#states)).
* **Provider sign-ins:** no password change, and no email or phone change on the web and iOS.
* **Name with markup:** saved as typed and shown as HTML in the admin dialog.
* **Several sites:** on-call is set for each site on its own. Switching sites is in [Switching sites](https://docs.snapfix.com/product/features/groups/site-switching.md).
* **Time zones:** None.


---

# 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/product/features/account/profile.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.
