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

# Site details (multi-site)

{% 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. [Source on GitHub](https://github.com/snapfix/docs/blob/main/spec/screens/console/multi-site-details.md).
{% endhint %}

A multi-site user picks one of the multi-site's sites and sees its details in the [Site details](https://docs.snapfix.com/how-the-apps-work/screens/console/site-details.md) form; the form is editable only where the user is a site admin, and anyone else can make themselves one.

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

* **Where:** web `/multi-site/site_details` (Multi-Site Console, tab "Site Details"). Opened from the tab, the page loads; opened directly or reloaded, it stays blank, because the site list is not fetched on that path.
* **Who:** anyone with a multi-site selected in the site switcher. Editing needs the site admin role on the picked site; the popup that grants it is open to every multi-site user \[[ASK-123](https://github.com/snapfix/docs/blob/main/ASK.md#ask-123-who-may-manage-a-multi-site-and-change-its-members-site-roles)].
* **Feature:** [Multi-Site Console](https://docs.snapfix.com/product/features/console/multi-site-console.md)

## Layout

1. **Console header.** The Multi-Site Console header and tabs ([My sites](https://docs.snapfix.com/how-the-apps-work/screens/console/my-sites.md#layout)).
2. **Site card.** The card of [Site details](https://docs.snapfix.com/how-the-apps-work/screens/console/site-details.md#web), with a site picker in its title row that lists the multi-site's sites; the first site is picked when the tab opens. "Save" always shows here, and stays disabled while the form is read-only or unchanged.
3. **Site image.** The edit pencil shows when the user's role on the picked site is "Admin", or after the user has clicked the card as a site admin or accepted the popup in this visit.

## Inputs

| Field        | Type                                                                                                  | Required  | Default                  | Rules and messages                                                                        |
| ------------ | ----------------------------------------------------------------------------------------------------- | --------- | ------------------------ | ----------------------------------------------------------------------------------------- |
| Site picker  | Select                                                                                                | Yes       | The first site           | The multi-site's sites. Disabled while saving.                                            |
| Details form | See [Site details](https://docs.snapfix.com/how-the-apps-work/screens/console/site-details.md#inputs) | See there | The picked site's values | The same fields and rules. Disabled unless the user's role on the picked site is "Admin". |

## Actions

| Action             | Who                                                         | What happens                                                                                                                                                                            | API                                                                                                                                                                                                                                                                                           |
| ------------------ | ----------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Open the tab       | Multi-site users                                            | Loads the multi-site's sites and the user's role on each site.                                                                                                                          | [`GET /v1/app/multiSites/{uuid}`](https://docs.snapfix.com/engineering-reference/api/console.md#get-v1appmultisitesuuid), [`GET /multisite/{multisiteUUID}/user/{userUUID}/sites`](https://docs.snapfix.com/engineering-reference/api/console.md#get-multisitemultisiteuuiduseruseruuidsites) |
| Pick a site        | Multi-site users                                            | Loads the picked site into the form.                                                                                                                                                    | [`GET /v1/app/parents/{uuid}`](https://docs.snapfix.com/engineering-reference/api/console.md#get-v1appparentsuuid)                                                                                                                                                                            |
| Click the card     | Multi-site users who are not site admins of the picked site | Any click on the card, including on the disabled fields, opens "Site Admin Permission".                                                                                                 | None until "Yes"                                                                                                                                                                                                                                                                              |
| "Yes" in the popup | Multi-site users                                            | Makes the user a site admin of the picked site, reloads the roles and the site, and enables the form and the pencil.                                                                    | [`POST /multisite/{multisiteUUID}/user/{userUUID}`](https://docs.snapfix.com/engineering-reference/api/console.md#post-multisitemultisiteuuiduseruseruuid) with `site-admin`                                                                                                                  |
| Save               | Site admins of the picked site                              | Saves the form as on [Site details](https://docs.snapfix.com/how-the-apps-work/screens/console/site-details.md#actions), then reloads the multi-site's sites and keeps the picked site. | [`PUT /v1/app/parents/{uuid}`](https://docs.snapfix.com/engineering-reference/api/console.md#put-v1appparentsuuid), then [`GET /v1/app/multiSites/{uuid}`](https://docs.snapfix.com/engineering-reference/api/console.md#get-v1appmultisitesuuid)                                             |

The user's roles are kept by site name, so two sites with the same name share one role entry.

## States

* **Loading:** a spinner while the sites load, and in the card while the picked site loads.
* **Empty:** when the multi-site has no sites, nothing shows under the tabs, with no message.
* **Error:** a failed site load shows "Failed to fetch site data. Please try again later."; a failed save or a failed "Yes" shows the API's message; a failed role load goes to the browser console only.
* **No permission:** a user who is not a site admin of the picked site sees the form disabled, with no pencil; a click on the card opens the popup.

## Dialogs and sheets

* **Site Admin Permission:** "You currently have view-only access to this Site.", "Before you can make updates, you need to be added as a Site Admin." and "Do you want to add yourself as Site Admin to this Site?", with "Cancel", "Yes" and a close icon. "Yes" adds only the user themselves.
* **Upload image:** as on [Site details](https://docs.snapfix.com/how-the-apps-work/screens/console/site-details.md#dialogs-and-sheets), once the user is a site admin.

## Platform differences

Web only. The apps have no multi-site console; they open one site at a time.


---

# 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/multi-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.
