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

# User access to devices

Set different roles for other RACEMAP accounts to access your GPS trackers.

The tracker management supports three different user roles. There is one "owner" for each device. The owner can share access to the same device for multiple users through the "editor" and "borrower" roles.

<table><thead><tr><th width="119">User role</th><th>Use case</th><th>Permissions</th><th>Messages</th></tr></thead><tbody><tr><td><strong>Owner</strong></td><td><strong>Standard device owner:</strong> RACEMAP account that initially added the device to tracker management.</td><td><p>Can add/remove editors and borrowers.<br></p><p>Cannot bulk remove users or manage other owners.</p></td><td>Can use all <a href="/tracker-management/trackersapi.md">message templates</a> assigned to its account.</td></tr><tr><td><strong>Editor</strong></td><td><strong>Shared management access:</strong> Members in the same organization to manage device rentals and borrowers.</td><td><p>Can add/remove borrowers.</p><p>Cannot bulk remove, cannot manage owners or editors.</p></td><td>Can use all <a href="/tracker-management/trackersapi.md">message templates</a> assigned to its account.</td></tr><tr><td><strong>Borrower</strong></td><td><strong>Temporary access:</strong> A user that rented your devices. The access period is set by start and end date.</td><td>Cannot add or remove other users. No access to manage user roles).</td><td>Can use only specific messages.</td></tr></tbody></table>

<figure><img src="https://1672210197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSRNxaH2Ju9Flr7JhJD%2Fuploads%2FHYD6fVSFgZBvXWtvnfSH%2FScreenshot%202026-05-06%20at%2014.57.31.png?alt=media&amp;token=a0d22f84-c014-4ec1-b8e0-c9affc4edca6" alt=""><figcaption><p>Manage user access and permissions in the user tab for each device separately.</p></figcaption></figure>

#### How to find the devices you borrowed

The **My Role** filter in the tracker management sidebar narrows the list to your own role on each device.

* **Owned by me** — devices your account added to tracker management.
* **Shared with me** — devices someone made you an editor of.
* **Borrowed by me** — devices you rented. This is the one to use when you borrowed a batch of devices and want to see only those.

A device can appear under more than one role. If you are both editor and borrower of a device, it shows up under both.

<figure><img src="https://1672210197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSRNxaH2Ju9Flr7JhJD%2Fuploads%2Fgit-blob-c79c16796b9273ccc35dd6bb1110d117512b8502%2Fmy-role-filter.png?alt=media" alt="" width="375"><figcaption><p>Filter the device list by your own role. The count next to each role is the number of devices you hold it on.</p></figcaption></figure>

{% hint style="info" %}
Borrowed devices only appear while the access period is running. Once the end date has passed, the device leaves your tracker management entirely.
{% endhint %}

#### How to find the devices in one rental

The **Rentals** filter groups every borrow period you are part of, one group per period. Both sides of a rental get their own group, and nobody has to set anything up — the groups follow the borrow periods you already entered.

* **Lent out** — the devices you gave to somebody else, one group per account and period.
* **Borrowed** — the devices you rented, one group per account and period.

Each group names the other account and the period it covers, and counts the devices in it. Select a group to narrow the device list to exactly that rental.

<figure><img src="https://1672210197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSRNxaH2Ju9Flr7JhJD%2Fuploads%2Fgit-blob-549e5395e6fb2f0127426b679e36afde1abc4c57%2Frentals-filter.png?alt=media" alt="" width="375"><figcaption><p>Two rentals to the same account, each with its own period and device count.</p></figcaption></figure>

Rent the same devices to the same account twice, for two different periods, and you get two groups. A group appears as soon as the period is entered, so a rental starting next month is already there, and it disappears once the end date has passed.

#### How to add users and change user roles, bulk

* Select multiple GPS trackers.
* Select "Manage User" to open the modal to manage user access.

<figure><img src="https://1672210197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSRNxaH2Ju9Flr7JhJD%2Fuploads%2Fkrq2CkgkOiwvpBlkNGav%2Fscreenshot-racemap.com-2024.01.30-13_01_19.png?alt=media&amp;token=8f8f613f-8945-4b47-8c91-d75e273c321c" alt=""><figcaption></figcaption></figure>

**Add a user role**

* Search field: Type the email address or name of the RACEMAP account you want to add.
* Add the user from the dropdown results.

<figure><img src="https://1672210197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSRNxaH2Ju9Flr7JhJD%2Fuploads%2FhriOqfHLtMtP8aiyALLQ%2Fimage.png?alt=media&amp;token=0ec43435-fe91-42d5-8374-cd87de6903fb" alt=""><figcaption></figcaption></figure>

* Select the role you want to assign.

<figure><img src="https://1672210197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSRNxaH2Ju9Flr7JhJD%2Fuploads%2F8xB4aUpGFGiFywXMSlzm%2FScreenshot%202026-05-07%20at%2011.34.04.png?alt=media&amp;token=39c200dd-27a9-432e-8c9c-91e10e467ef3" alt="" width="375"><figcaption></figcaption></figure>

**Change a user role**

* Click the button showing the user role (eg., "Editor") to open the "Change role" modal.

<figure><img src="https://1672210197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSRNxaH2Ju9Flr7JhJD%2Fuploads%2F3cnNvHKeZcuNq82DlHh1%2Fimage.png?alt=media&amp;token=d4dd27aa-68e6-480c-b01f-8948d2cf9e4d" alt=""><figcaption></figcaption></figure>

* Select the role you want to assign.

<figure><img src="https://1672210197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSRNxaH2Ju9Flr7JhJD%2Fuploads%2F8xB4aUpGFGiFywXMSlzm%2FScreenshot%202026-05-07%20at%2011.34.04.png?alt=media&amp;token=39c200dd-27a9-432e-8c9c-91e10e467ef3" alt="" width="375"><figcaption></figcaption></figure>


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.racemap.com/tracker-management/user-role.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
