> For the complete documentation index, see [llms.txt](https://docs.mapsindoors.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mapsindoors.com/cms/interface/settings-interface.md).

# Settings Interface

Manage users, audit logs, and account-level settings for your MapsIndoors solution.

***

## Settings

The **Settings** section of the MapsIndoors CMS provides account and solution-level configuration that sits outside of day-to-day map editing. Here you can manage who has access to the CMS and review a full history of changes made to your data.

To access Settings, click the **Settings** icon in the left navigation bar of the CMS.

***

### Users

The Users page lists everyone who can sign in to the CMS, their role, and the Solutions they can open. Administrators use it to add users, change their access, and remove them.

{% hint style="info" %}
**Admin only:** Only users with the Administrator role can open the Users page and create, edit, or delete users.
{% endhint %}

To open it, go to **Settings → Users**.

#### User Roles

| Role              | Capabilities                                                                                                     |
| ----------------- | ---------------------------------------------------------------------------------------------------------------- |
| **Editor**        | Can add and edit location data, display rules, and map content. Cannot manage users or access solution settings. |
| **Administrator** | Full access to all CMS features, including user management and solution settings.                                |

A role applies to every Solution the user is assigned to. See [User Roles](https://docs.mapsindoors.com/cms/core-concepts/editor.md) for a full comparison.

#### Viewing Users

<figure><img src="https://393726209-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr7ggkwTwz3UJfNWm5Mwk%2Fuploads%2Fgit-blob-0531fd75ce60a6934dbfe5f11d4a9cd134997539%2FCMS%20Users%20List.png?alt=media" alt="The Users page with search, role and customer filters, and the list of users"><figcaption></figcaption></figure>

1. Search by email address or customer name.
2. Filter by role.
3. Filter by customer.
4. Click a column header to sort the list.
5. Add new users.

The list shows every user across the Solutions you manage. Each row shows:

* **User** – the user's email address
* **Role** – Editor or Administrator
* **Customer** – the customer the user's Solutions belong to
* **Solutions** – how many Solutions the user can open, split by Solution type (Production, Development, POC, Sandbox)

The count above the list shows how many users match your current filters.

#### Adding Users

You can add one or more users at once. Everyone you add in one go gets the same role and Solutions.

<figure><img src="https://393726209-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr7ggkwTwz3UJfNWm5Mwk%2Fuploads%2Fgit-blob-e05416f95fefef9a1437a9613a3016faa98d64fc%2FCMS%20New%20User.png?alt=media" alt="The New user page with email addresses, role, and Solutions"><figcaption></figcaption></figure>

1. Go to **Settings → Users** and click **New user**.
2. Under **Email addresses**, type or paste one or more email addresses. Each address becomes a tag.
3. Under **Role**, select **Editor** or **Administrator**.
4. Under **Solutions**, choose which Solutions the new users can open:
   * Search for a company or Solution and select it from the list. Use the type filters above the list to show only Production, Development, POC, or Sandbox Solutions. Once one company has been added, click **Add new** to add another. Use the checkboxes to select individual Solutions, or the checkbox next to a company to select all of its Solutions.
   * Or click **Copy access from…** and select an existing user to give the new users the same Solutions. To undo it, remove that user from **Solution access copied from**.
5. Click **Create user**, or **Create&#x20;*****n*****&#x20;users** when you add more than one.

Each new user receives an invitation email to access the CMS.

{% hint style="info" %}
If an email address already belongs to a CMS user, the page tells you, and you can open that user's page to change their access instead.
{% endhint %}

#### Editing a User

<figure><img src="https://393726209-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr7ggkwTwz3UJfNWm5Mwk%2Fuploads%2Fgit-blob-0b66abaf745da18c9f26f22a8016b9667f5fd46e%2FCMS%20Edit%20User.png?alt=media" alt="A user&#x27;s page with unsaved role and Solution changes"><figcaption></figcaption></figure>

1. Click a user in the list to open their page.
2. Change their **Role**, or select or clear **Solutions**. Solutions you add or remove are marked until you save.
3. The page lists your unsaved changes next to the **Save** button.
4. Click **Discard** to undo the changes, or **Save** to apply them, then review the summary and confirm.

#### Removing a User

1. Open the user's page.
2. Under **Danger zone**, click **Delete user** and confirm.

The user can no longer sign in to the CMS. Changes they made to the map are kept.

If the user also has access to Solutions at another customer, the button reads **Remove access** instead. This removes them from the Solutions you manage only. Their access elsewhere stays as it is.

{% hint style="info" %}
You cannot delete your own user.
{% endhint %}

***

### Logs

The Logs page gives you a full audit trail of changes made to your MapsIndoors data. This is useful for tracking who changed what and when — whether for compliance, debugging, or general oversight.

{% hint style="info" %}
**Note:** The Audit Log is a configurable feature and is not enabled for every Solution. Contact MapsPeople support to have it enabled.
{% endhint %}

#### Accessing the Logs

Navigate to **Settings → Logs** in the CMS sidebar.

#### Filtering the Log

You can filter the audit log by the following criteria:

* **Date range** — narrow results to a specific time window
* **User** — filter by the email address of the user who made the change
* **Object ID** — find changes to a specific location, building, or other data object
* **Data object type** — filter by the type of object modified (e.g. `location`, `building`, `category`)

#### Understanding Log Entries

Each entry represents a single modification to your MapsIndoors data. The log is structured as a CSV file with the following columns:

| Column         | Description                                                                 |
| -------------- | --------------------------------------------------------------------------- |
| **Time**       | When the change occurred                                                    |
| **User**       | The email address of the user who made the change                           |
| **Action**     | What happened: `Created`, `Changed`, or `Deleted`                           |
| **ObjectType** | The type of data object modified (e.g. `location`, `building`, `graphdata`) |
| **ObjectId**   | The unique ID of the modified object                                        |
| **ObjectData** | A JSON snapshot of the object's data at the time of the change              |

To identify exactly what changed, compare the **ObjectData** field across two entries for the same **ObjectId**.

#### Downloading the Log

Click **Download** **Log** to export the currently filtered log as a `.csv` file, which can be opened in a spreadsheet application such as Microsoft Excel or Google Sheets.

#### Common Use Cases

<details>

<summary><strong>How do I see who edited the route network?</strong></summary>

Filter **ObjectType** to `Graphdata`. To narrow it further, also filter by the **User** email.

</details>

<details>

<summary><strong>How do I see login activity for a specific user?</strong></summary>

Each login updates the user's last login field. Filter **ObjectType** to `user` and **User** to the relevant email address to see their login history.

</details>

<details>

<summary><strong>How do I review changes to Categories?</strong></summary>

Filter **ObjectType** to `category`.

</details>


---

# 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.mapsindoors.com/cms/interface/settings-interface.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.
