> 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/console/site-details.md).

# Site details

{% 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/console/site-details.md).
{% endhint %}

Admins edit the site's name, address, country, currency (web only), image, the "Display contact info" switch and the Snapfix AI suggestion switches; other members can read the same page on the apps.

![Site details](https://3653879137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVVGa79QbcEkJ7n8srxe%2Fuploads%2Fgit-blob-7c67fe07daf6bd63f9594bd97691e7b39e55c4b8%2Fsite-details.png?alt=media)

* **Where:** web `/account/:id/details`, the first tab of the Site Console, which opens from the side menu "Site Console" (shown to site admins and group admins while no multi-site is selected) or from the site switcher's "Site Console" button, which shows on every site. iOS: side menu "Site Administration" > "Site Details", shown to every member; it opens the first page of the site console. Android: side menu "Site Administration" > "Site Details" for site admins, and "Site Details" alone for everyone else; both open the first tab of the site console.
* **Who:** web: the route admits role "Admin" and group admins (`authAdminGuard`), checked on the site stored as current, not the site in the URL; anyone else goes to `/fix`. Only role "Admin" gets an editable form with "Save"; group admins see every field disabled, with no "Save" and no image edit. iOS and Android: every member opens the screen, and only site admins can change it.
* **Feature:** [Site details](https://docs.snapfix.com/product/features/console/site-details.md)

The Site Console's other tabs are separate screens: [Username sites](https://docs.snapfix.com/how-the-apps-work/screens/console/username-sites.md), [Users](https://docs.snapfix.com/how-the-apps-work/screens/console/users.md), [Areas & Rooms](https://docs.snapfix.com/how-the-apps-work/screens/rooms/areas-and-rooms.md), [Tags](https://docs.snapfix.com/how-the-apps-work/screens/console/tags.md), [Checklists](https://docs.snapfix.com/how-the-apps-work/screens/console/checklists.md) and the subscription tab ([Billing](https://docs.snapfix.com/how-the-apps-work/screens/billing.md)). The Multi-Site Console shows the same form for any of its sites: [Site details (multi-site)](https://docs.snapfix.com/how-the-apps-work/screens/console/multi-site-details.md).

## Layout

### Web

1. **Site Console header.** The title "Site Console" and the tabs "Site Details", "Username Sites", "Users", "Areas & Rooms", "Tags", "Checklists" and "Your subscription". The tabs stay disabled until the site loads. "Username Sites" shows only on the sites of a list built into the app ([Username sites](https://docs.snapfix.com/how-the-apps-work/screens/console/username-sites.md)). "Areas & Rooms", "Tags" and "Checklists" show only to role "Admin", though their routes also open for group admins. "Your subscription" shows only when the site has a subscription and the user is role "Admin"; it was not shown on the QA site \[[ASK-135](https://github.com/snapfix/docs/blob/main/ASK.md#ask-135-which-qa-site-can-show-the-your-subscription-tab)].
2. **Card header.** "Site Details", and "Save" at the right for role "Admin". "Save" is disabled until a field changes and while the form is invalid.
3. **Left column.** The site image with an edit pencil (title "Edit", role "Admin" only), "Site name \*", and "Display contact info" with "This will display the user's email addresses or phone number with their name." Where AI suggestions are allowed for the site: "Snapfix Recommended Task Field Suggestions" with "When enabled, Snapfix AI will automatically suggest values for specific fields (Title, Assigned to, Tags, Areas and rooms) during task creation, improving accuracy and reducing manual input.", and, while that switch is on, "Restrict to My Tags" with "When enabled, AI suggestions will only include tags you have created, ensuring recommendations stay aligned with your personalised taxonomy."
4. **Right column.** "Address line 1" and "Address line 2", each on its own row; "Postal code" and "City" side by side; "County" and "Country \*" side by side; "Currency" on its own row.

AI suggestions are allowed on every site outside production. In production they are allowed when the Firebase Remote Config value `ai_suggestions_access_all_accounts` is on, or the site is listed in `ai_suggestions_included_accounts` (web\_app\_v2 @ 0989b8e685, `account-settings-account-details.component.ts:108-117`).

### iOS

1. **Title.** "Site Console" for site admins and "Site Details" for everyone else, with two tabs, "Site Details" and "Users" ([Users](https://docs.snapfix.com/how-the-apps-work/screens/console/users.md)).
2. **Body.** The round site image with a change button (site admins only), "Site Name", "Display contact info" with "This will display the user's email address or phone number with their name.", the AI switches "Snapfix Recommended Task Field Suggestions" and "Restrict to My Tags" (when the site's AI suggestions are allowed by the same Remote Config values; the storyboard's texts "Snapflix Recommends" and "Use my tags" are replaced from the string file when the screen loads), "Address line 1", "Address line 2", "Postal code", "City", "County" and "Country". A "Currency" row exists in the code but is hidden in the storyboard. Below the form, a table of the site's admins.

### Android

1. **Toolbar.** "Site Console" for site admins and "Site Details" for everyone else, with the tabs "Site Details" and "Users".
2. **Body.** The site image with an edit button (site admins only), "Site name", "Display contact info" with its description, the AI block "Snapfix Recommended Task Field Suggestions" with "Restrict to My Tags" (by the same Remote Config values, in every environment), then "Address line 1", "Address line 2", "Postal code", "City", "County" and "Country" (a country picker). Below, the list "Account Admin" with the site's admins. There is no currency field.

## Inputs

Web (the form in web\_app\_v2 @ 0989b8e685, `account-settings-account-details.component.ts:260-296`):

| Field                                      | Type   | Required | Default                     | Rules and messages                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ------------------------------------------ | ------ | -------- | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Site name                                  | Text   | Yes      | Current name                | Up to 60 characters; typing stops at 60. Blank or spaces only: "Please enter the site name" under the field once it loses focus, and "Save" stays disabled. A longer value (only by paste or script) shows "Your input exceeds the maximum allowed length of 60 characters". The web's save checks no duplicate names; the apps' save refuses a name another live site uses \[[ASK-125](https://github.com/snapfix/docs/blob/main/ASK.md#ask-125-must-site-names-be-unique)]. |
| Display contact info                       | Switch | No       | Current value               | On shows members' email address or phone number next to their name in the site's lists.                                                                                                                                                                                                                                                                                                                                                                                       |
| Snapfix Recommended Task Field Suggestions | Switch | No       | Current value               | Shown only where AI suggestions are allowed (see [Layout](#web)). Turning it off also turns off "Restrict to My Tags".                                                                                                                                                                                                                                                                                                                                                        |
| Restrict to My Tags                        | Switch | No       | Current value               | Shown only while the suggestions switch is on.                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Address line 1, Address line 2             | Text   | No       | Current value               | Up to 100 characters each. A longer value turns "Save" off with no message.                                                                                                                                                                                                                                                                                                                                                                                                   |
| Postal code                                | Text   | No       | Current value               | Up to 10 characters.                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| City                                       | Text   | No       | Current value               | Up to 60 characters.                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| County                                     | Text   | No       | Current value               | Up to 60 characters. Saved as the address's state.                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Country                                    | Select | Yes      | Current value               | The countries from the [Reference API](https://docs.snapfix.com/engineering-reference/api/reference.md), sorted by name. The list has no empty choice and the field has no message, so "Please choose a country" is never shown. "Congo" and "Korea" each appear twice, and accented names sort last.                                                                                                                                                                         |
| Currency                                   | Select | No       | The site's default currency | Only the currencies marked as Snapfix-supported (six in the live list).                                                                                                                                                                                                                                                                                                                                                                                                       |
| Site image                                 | Image  | No       | Current image               | Chosen in "Upload image", with a crop; sent with "Save".                                                                                                                                                                                                                                                                                                                                                                                                                      |

The apps check only the site name: iOS shows the alert "Please enter account name" and stays on the screen; Android shows "Please enter account name" under the field (which stops at 60 characters) and stays on the screen. iOS sets no length limit.

## Actions

### Web

| Action        | Who                        | What happens                                                                                                                                                                                                                              | API                                                                                                                                                                                                               |
| ------------- | -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Open the page | Role "Admin", group admins | The Site Console loads the site and fills the form; the country and currency lists load with it. A failed load, or an answer for another site, goes to `/fix`.                                                                            | [`GET /v1/app/parents/{uuid}`](https://docs.snapfix.com/engineering-reference/api/console.md#get-v1appparentsuuid); lists in the [Reference API](https://docs.snapfix.com/engineering-reference/api/reference.md) |
| Edit image    | Role "Admin"               | Opens "Upload image"; the picked and cropped file is sent with the next save. "Cancel" sends nothing.                                                                                                                                     | None until "Save"                                                                                                                                                                                                 |
| Save          | Role "Admin"               | Sends the whole form in one request, with trimmed text and the new image if one was picked. The button shows success for 1.5 seconds, then the answer becomes the stored current site. A failed save shows the API's message in an alert. | [`PUT /v1/app/parents/{uuid}`](https://docs.snapfix.com/engineering-reference/api/console.md#put-v1appparentsuuid)                                                                                                |
| Switch site   | Anyone on the page         | Loads the new site's Site Details. A site where the user is neither role "Admin" nor a group admin goes to `/fix`.                                                                                                                        | As "Open the page"                                                                                                                                                                                                |

### iOS and Android

The apps have no "Save" button: leaving the screen saves what changed.

| Action          | Who          | What happens                                                                                                                                                                                                                                                        | API                                                                                                                                                                                                                                                                                                                                                                                                                   |
| --------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Open the screen | Every member | Shows the site from the device's database and loads the admins list.                                                                                                                                                                                                | [`?action=webcust_parent_detail`](https://docs.snapfix.com/engineering-reference/api/console.md#post-actionwebcust_parent_detail)                                                                                                                                                                                                                                                                                     |
| Change image    | Site admins  | iOS: the photo picker, then a square crop resized to 600 by 600. Android: camera or gallery, then a crop. The picture is uploaded when the user leaves.                                                                                                             | File upload, then [`?action=update_parent_image`](https://docs.snapfix.com/engineering-reference/api/console.md#post-actionupdate_parent_image)                                                                                                                                                                                                                                                                       |
| Leave (iOS)     | Site admins  | Checks the name, then saves in turn: a new image, then the name, contact display and AI switches, then the address. Each step runs only if its data changed; with no change the screen just closes. The contact switch is written to the device's database at once. | [`?action=update_parent_image`](https://docs.snapfix.com/engineering-reference/api/console.md#post-actionupdate_parent_image), [`?action=webcust_update_parent_v2`](https://docs.snapfix.com/engineering-reference/api/console.md#post-actionwebcust_update_parent_v2), [`?action=update_parent_address_basic`](https://docs.snapfix.com/engineering-reference/api/console.md#post-actionupdate_parent_address_basic) |
| Leave (Android) | Site admins  | Checks the name. With no change the screen closes. Otherwise a new image is uploaded and saved first, then the name, contact display, address, country and AI switches go in one call, and the screen closes with "Data updated successfully!".                     | [`?action=update_parent_image`](https://docs.snapfix.com/engineering-reference/api/console.md#post-actionupdate_parent_image), [`?action=webcust_update_parent_v2`](https://docs.snapfix.com/engineering-reference/api/console.md#post-actionwebcust_update_parent_v2)                                                                                                                                                |
| Admins list     | Every member | Lists the site's admins that are not deleted, with photo and name, and the email or phone only when "Display contact info" is on.                                                                                                                                   | [`?action=webcust_parent_detail`](https://docs.snapfix.com/engineering-reference/api/console.md#post-actionwebcust_parent_detail)                                                                                                                                                                                                                                                                                     |

The address goes through different actions on iOS and Android, so the two can store it differently ([Console API](https://docs.snapfix.com/engineering-reference/api/console.md#post-actionwebcust_update_parent_v2)).

## States

* **Loading:** web shows a spinner in the Site Console until the site arrives. iOS and Android show the device's copy at once; while saving, iOS shows "Updating..." and Android an "Updating..." dialog.
* **Empty:** none; a site always has a name.
* **Error:** web: a failed load goes to `/fix`; a failed save shows the API's message. iOS: a failed image or name save shows a generic error; a failed address save leaves "Updating..." on screen. Android: a failed save shows "Something went wrong. Please try again."; a failed image upload leaves the "Updating..." dialog open.
* **No permission:** web: group admins see the form disabled, with no "Save" and no pencil. iOS and Android: non-admins see every field and switch disabled and no image button.
* **Offline (mobile):** iOS keeps the changes in the device's copy and calls the server when the user leaves, with no connection check. Android checks first and shows "No Internet!" / "Please check your internet connection" with "Retry" and "Cancel"; "Cancel" closes the screen and drops the changes without a warning.

## Dialogs and sheets

* **Upload image (web):** "Upload image", "Click or drag files to upload", "Drag and drop an image here", "OR", "Choose an image", "Cancel" and "Save", then a crop step after a file is chosen.
* **Image picker (iOS):** the system photo picker, then the square crop.
* **Image menu (Android):** a sheet with camera and gallery, then a crop.
* **"Delete account" (iOS, unreachable):** the code has a "⋯" button whose menu offers "Delete account" and opens the sheet "Delete Snapfix Account". The button is hidden in the storyboard and nothing shows it, and the sheet's delete button calls an empty function.

## Platform differences

| Topic                          | Web                                                                                         | iOS                                    | Android                         |
| ------------------------------ | ------------------------------------------------------------------------------------------- | -------------------------------------- | ------------------------------- |
| Saving                         | "Save" button, one request                                                                  | On leaving, up to three requests       | On leaving, one or two requests |
| Default currency               | Editable and saved                                                                          | Row hidden; the save sends no currency | No field                        |
| Country required               | Yes                                                                                         | No check                               | No check                        |
| Site name limit                | 60                                                                                          | None                                   | 60                              |
| AI switches outside production | Always shown                                                                                | Remote Config                          | Remote Config                   |
| Admins list                    | Not here (see [Users](https://docs.snapfix.com/how-the-apps-work/screens/console/users.md)) | Below the form                         | "Account Admin" below the form  |
| Image                          | Upload dialog with crop                                                                     | Picker, square crop, 600 by 600        | Camera or gallery, crop         |

Only the web can set the default currency.


---

# 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/console/site-details.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.
