# Add GPS trackers

{% hint style="success" %}
Use the URL <https://racemap.com/admin/trackers/add> or the "Add Tracker" button to upload your GPS trackers into the tracker management.
{% endhint %}

### Add one GPS tracker

<figure><img src="https://1672210197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSRNxaH2Ju9Flr7JhJD%2Fuploads%2F0bomTxLGnli5oeVcsPeE%2Fscreenshot-racemap.com-2023.11.14-21_05_12.png?alt=media&#x26;token=f43dfcf7-4bd3-47ab-b496-be3ec5231a05" alt=""><figcaption><p>Add one GPS tracker to the Tracker Management manually.</p></figcaption></figure>

Use the form fields to select the tracker type, provide an optional device name, and paste the IMEI of your device. This allows you to add GPS trackers manually, one by one.

### Add multiple GPS trackers

<figure><img src="https://1672210197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSRNxaH2Ju9Flr7JhJD%2Fuploads%2FFhCFc2ECOhqcH1HPMC37%2Fscreenshot-racemap.com-2023.11.14-21_30_17.png?alt=media&#x26;token=64f8aed0-a4b7-41b2-97a2-2f4df4a501d0" alt=""><figcaption><p>Drop csv file with your trackers' information.</p></figcaption></figure>

Add multiple devices to your Tracker Management at once by uploading a CSV file.

{% tabs %}
{% tab title="minimal sample" %}
**Syntax:** use the IMEI in the tracker\_id column

{% code lineNumbers="true" %}

```
tracker_id,tracker_name,device_type
860297002626525,Tr0047,GL320LTE-MG
```

{% endcode %}

{% file src="<https://1672210197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSRNxaH2Ju9Flr7JhJD%2Fuploads%2Ffnh4QVsrVOQe4gIHuTXz%2Ftracker-management-upload-minimal.csv?alt=media&token=1199fba6-1062-4ac0-9aa3-5ad6c5fba4b2>" %}
**Download csv file, minimal sample file**
{% endfile %}
{% endtab %}

{% tab title="iccid of inserted SIM card" %}
**Syntax:** use the IMEI in the tracker\_id column

{% code lineNumbers="true" %}

```
tracker_id,tracker_name,device_type,iccid
860297002626525,Tr0047,GL320LTE-MG,9845435823031369005,47454525920082
```

{% endcode %}

{% file src="<https://1672210197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSRNxaH2Ju9Flr7JhJD%2Fuploads%2Fgit-blob-b6fbf911ee2da1de7c2f3aed959b30a7d63e453d%2Ftracker-management-upload.csv?alt=media>" %}
**Download sample file including iccid of inserted SIM card**
{% endfile %}
{% endtab %}
{% endtabs %}

{% hint style="info" %}
**IMEI requirements:** To add a GPS device, the IMEI must meet the requirements:&#x20;

* Unique: The IMEI must not already exist in the tracker management.&#x20;
* 15 digits long: IMEIs must be exactly 15 characters.&#x20;
* Digits only: Only numbers 0–9, no spaces, hyphens, or letters.
* [Luhn check digit](https://en.m.wikipedia.org/wiki/Luhn_algorithm)

You can validate IMEIs using an IMEI checker such as <https://imeicheck.net/>
{% endhint %}

### Rename devices in Tracker Management

When customizing your GPS trackers, you may need to change the names of your devices in the Tracker Management.

{% hint style="warning" %}
RACEMAP does not save previous tracker names. To retain a record of the original names, we recommend exporting and saving a CSV file of the current tracker information before making any changes.
{% endhint %}

1. **Export tracker data** \
   Select the devices you want to rename and download the CSV file containing their details.&#x20;

<figure><img src="https://1672210197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSRNxaH2Ju9Flr7JhJD%2Fuploads%2Fqb925aCwLnx4x2qcTii2%2Fimage.png?alt=media&#x26;token=beb2b18d-d25d-4e2e-8628-0d99a1102e99" alt=""><figcaption></figcaption></figure>

{% code lineNumbers="true" %}

```
id;tracker_id;tracker_name;device_type;iccid;tracker_link
5ae88c82208b1df57805ab91;352887073845640;test(rename);TK102;;https://tr.racemap.com/5ae88c82208b1df57805ab91
5ae88c82208b1df57805acdb;352887073766457;Racemaptracker-11;TK102;;https://tr.racemap.com/5ae88c82208b1df57805acdb
```

{% endcode %}

{% file src="<https://1672210197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSRNxaH2Ju9Flr7JhJD%2Fuploads%2FMjnRGBqzJMd1q0dMC4EU%2FSample%20file%20from%20TM.csv?alt=media&token=e160f448-67c2-427d-85e1-c99011e2d5a9>" %}

2. **Edit CSV file**\
   Open the CSV file in a text editor and delete all columns except the essential ones: `id`, `tracker_id`, `device_type` and `tracker_name`.
3. **Rename devices**\
   Update the `tracker_name` column with the new names you want to assign.

{% code lineNumbers="true" %}

```
id;tracker_id;tracker_name;device_type
5ae88c82208b1df57805ab91;352887073845640;Lead Tracker;TK102
5ae88c82208b1df57805acdb;352887073766457;Sweap Device;TK102
```

{% endcode %}

{% file src="<https://1672210197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSRNxaH2Ju9Flr7JhJD%2Fuploads%2FJL9vkzoPRpF2Wsrji6DE%2FSample%20file%20upload%20to%20TM.csv?alt=media&token=fff919e1-7cdb-443d-a095-ad0b1a167b74>" %}

4. **Upload the Updated CSV** \
   Click the Add Tracker button and upload the modified CSV file. The device names will be updated immediately.

<figure><img src="https://1672210197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LSRNxaH2Ju9Flr7JhJD%2Fuploads%2FWYefcX4rB3aZU95RAZxq%2Fc79b5207-5bf3-4e9c-b562-5310118af134.png?alt=media&#x26;token=ae668627-2043-4131-84d4-6a45f1ac716c" alt=""><figcaption></figcaption></figure>