> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jitra.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Adding an Object with Jitra Tracker App

> Use an Android phone as a location source: create an Object, activate Jitra Tracker, allow location access, and start tracking.

Use **Jitra Tracker** to send an Android phone's location to an Object in Jitra. This guide covers Object creation, app activation on the phone, and checking the first location.

**Jitra Web and Jitra Mobile** manage and monitor Objects. **Jitra Tracker** is a different app that sends the phone's location. On the Object creation form, this source is called **Jitra Tracker App**.

For a physical GPS device, follow [Adding an Object with a GPS Device](https://docs.jitra.app/en/getting-started/adding-your-first-object.md).

## Before you begin

Prepare:

* A Jitra account with Organization setup completed, permission to create Objects, and an available Object slot.
* An **Android** phone with Jitra Tracker installed, location services enabled, and an internet connection.
* Access to the phone to grant location permissions and complete activation.

Jitra Tracker is currently available for Android. The phone user does not need to sign in with an Organization account; activation connects the app to the Object.

If you do not have Jitra Tracker yet, [contact Jitra support](https://docs.jitra.app/en/troubleshooting/contacting-jitra-support.md) for installation guidance. The **Jitra Mobile** monitoring app does not replace Jitra Tracker.

## 1. Create the Object and open activation

Choose the platform you use to manage Objects. The Android phone steps that follow are the same for both options.

> [tab] Web
>
> 1. Open **Settings → Objects → New**.
> 2. Select **Jitra Tracker App** under **Tracking Method**.
> 3. Enter a recognizable **Object Name** of up to 100 characters.
>
> ![Jitra Tracker App form in Jitra Web only requires the Object name](https://mintcdn.com/jitra/SCVxTf2iaOVFHisN/images/knowledge-base/getting-started/register-object-web-tracker.jpg?fit=max\&auto=format\&n=SCVxTf2iaOVFHisN\&q=85\&s=749b41f61b3d9b836bd93a85a19c60d2)
>
> 4. Click **Save**. Jitra creates the Object and opens **Tracker activation**.
>
> This page shows the Object name, **Waiting** status, QR code, **Activation code**, **Deep link**, and **Expires at**. Use the activation on your own page to connect the phone.
>
> ![Tracker activation page in Jitra Web](https://mintcdn.com/jitra/SCVxTf2iaOVFHisN/images/knowledge-base/getting-started/tracker-web-activation.jpg?fit=max\&auto=format\&n=SCVxTf2iaOVFHisN\&q=85\&s=cd376186854b170d442a9dd069e934a3)

> [tab] Mobile
>
> 1. Open the Jitra Mobile menu, then **Settings → Objects**, and tap **+**.
> 2. Select **Jitra Tracker App**.
> 3. Enter a recognizable **Object Name** of up to 100 characters.
>
> ![Jitra Tracker App form in Jitra Mobile](https://mintcdn.com/jitra/SCVxTf2iaOVFHisN/images/knowledge-base/getting-started/tracker-mobile-form.jpg?fit=max\&auto=format\&n=SCVxTf2iaOVFHisN\&q=85\&s=45779aeaaa60d85237e759edb551245c)
>
> 4. Tap **Save** at the bottom. Jitra creates the Object and opens **Tracker Activation**.
>
> This page shows the Object name, **Waiting** status, QR code, **Activation code**, **Deep link**, and **Expires**. Use **Copy code** or **Copy link** to copy the details you need.
>
> ![Tracker Activation page in Jitra Mobile](https://mintcdn.com/jitra/SCVxTf2iaOVFHisN/images/knowledge-base/getting-started/tracker-mobile-activation.jpg?fit=max\&auto=format\&n=SCVxTf2iaOVFHisN\&q=85\&s=61074f0c2f80137bf411456e0d381bce)

> [!NOTE]
>
> This method does not require a GPS Device Model, Device ID, server address, or port. The codes and QR images in the screenshots are examples and are no longer valid.

## 2. Activate Jitra Tracker on the phone

Open **Jitra Tracker** on the Android phone that will send locations. Choose one of these methods:

| Method | Steps |
| - | - |
| Manual code | Enter the **Activation code** from Jitra, then tap **Continue**. |
| QR code | Select **Scan QR code**, grant camera access when prompted, and scan the QR displayed on another screen. |
| Activation link | Open the **Deep link** on the phone with Jitra Tracker installed. If it does not open the app, enter the code manually instead. |

If Jitra Mobile and Jitra Tracker are on the same phone, copy the code and enter it in Jitra Tracker. You do not need to scan a QR displayed on that same phone.

Check the **Object name** and **Organization** on the confirmation screen. Tap **Confirm activation** only if both are correct. After activation succeeds, the app continues to tracking setup for that Object.

> [!WARNING]
>
> Share the activation code, QR, or link only with the person whose phone should become the Object's location source. Activation connects one app installation and cannot be reused after a successful activation.

## 3. Allow location access and start tracking

Activation connects the app to the Object; **it does not mean a location has already been sent**.

1. Complete the location permissions requested by Jitra Tracker. If **Permission Problem** appears, select **Allow location access**.
2. Make sure device location and background location access are available. If no permission prompt appears, open Android settings for Jitra Tracker and check its location permissions.
3. When the app is ready, tap **Start Tracking**.
4. Check the tracking status and **Last sent**. **No locations sent yet.** means no location has been sent successfully.

To continue tracking in the background, keep the required permissions enabled and follow the device's battery settings guidance. Background operation also depends on Android and the phone's condition.

Use **Stop Tracking** to stop collecting new locations. Previously queued locations can still synchronize when a connection is available.

## 4. Check the location in Jitra

Open **Tracking** in Jitra Web or Jitra Mobile, select the Object you created, and check its location and last update time.

If activation succeeded but no location appears, check Jitra Tracker on the phone: tracking has started, location services and permissions are enabled, a connection is available, and location synchronization succeeds. The activation page's **Waiting** status and the Object's location status describe different conditions.

## If setup is not working

| Condition | What to do |
| - | - |
| The code is incorrect, expired, or revoked | Check the code and expiry time. On the activation page, use **Regenerate code** or **New activation**, depending on its status, then use the latest code. The previous code no longer works. |
| QR scanning does not work | Check camera permission or enter the code manually. |
| The app shows **Permission Problem** | Complete location permissions in Jitra Tracker and Android settings. |
| Tracking is active but the phone is offline | Check connectivity. Queued locations will be retried when connectivity returns; check the sync status. |
| The phone was replaced, the app reinstalled, or the Object is already bound | Ask the person managing the Object to check the old connection and arrange reactivation. One Object uses one active Tracker installation. |

If the problem continues, open **Diagnostics** in Jitra Tracker and [contact Jitra support](https://docs.jitra.app/en/troubleshooting/contacting-jitra-support.md). Do not include an active activation code in publicly shared material.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.