← Back to User Guide

Teams

Create or join a team to start sharing your location with colleagues, family or friends. The Teams tab shows every device of your teams, its status and its distance from you.

How Teams Work

Xopoz treats each device as an independent tracking entity. If a person has two phones, both appear as separate entries in your team roster — each with its own position, status and distance.

By default, your location is kept entirely on your device and never shared. You must explicitly create or join a team to enable sharing. You can leave a team at any time to stop sharing.

Teams tab without any team: privacy information, No teams yet, Create New Team and Join Existing Team buttons
Teams tab before joining a team

As long as you are not in a team, the Privacy Information panel confirms that your position is not sent to anyone. Two buttons get you started:

  • Create New Team — start your own team and invite others
  • Join Existing Team — enter or scan a team key you received
End-to-end encrypted. Location data is encrypted on your device before it is sent to the server. The server stores only encrypted data and cannot read your coordinates.
Full-trust model. Xopoz operates on a full-trust principle within each team. Every member can see the real-time and historical location of every other member — there is no way to hide your position from specific team members or to exclude individual members from viewing others. If someone should not see another person's location, they must not be in the same team.

Creating a Team

Create Team dialog with team name field and privacy agreement checkbox
  1. In the Teams tab, tap Create New Team.
  2. Enter a team name.
  3. Tick I accept to share my position with team members — this records your consent.
  4. Tap Create. Your device is automatically added to the team.
  5. The app generates an encryption key for the team and stores it securely on your device. A challenge is sent to the server to prove key ownership — the server never receives the key itself.

The Team Card

Teams tab with three team cards; the Family card is expanded and lists the devices of Birgit (BI) and Max with battery, distance and last seen

Each team is shown as a card:

  • Checkbox — show or hide all devices of this team on the map
  • Team name and the number of other devices (local only means you are still alone in the team)
  • Pencil — rename the team or change its colour
  • Red cross — delete the team
  • Colour bar — the team colour
  • Leave — leave the team and stop sharing with it
  • Add Device — create the ticket that lets another device join

Below the card, one row per team device shows its marker, display name and ticker, last position time, online / offline state, role and its distance from you in metres or kilometres. Tap a row to jump to that device on the map. Pull down to refresh the list.

Editing a Team

Edit Team dialog with team name and colour selector set to orange

Tap the pencil to change the Team Name and the Team Color — Blue, Green, Yellow, Red, Purple, Orange, Pink, Teal, Gray, White or Dark. The colour is used for the team's bar and helps you recognise the team at a glance.

Member Roles

Role Capabilities
Creator Full admin rights. Cannot be removed from the team. Generates invite tickets.
Admin Can manage members and team settings. Can generate invite tickets.
Member Standard participation — shares location and sees other members.

Inviting Another Device

To add a new device to your team, you share a team key (also called a ticket).

Step 1 — Share the Team Key (existing member)

Share Team Key dialog with the ticket text (blurred), warning and Code and Share buttons
The team key as text (blurred here)
Share Team Key dialog showing a QR code (blurred) above the ticket text
The same key as a QR code (blurred here)
  1. Open the Teams tab and tap Add Device on the team card.
  2. The Share Team Key dialog shows the ticket in the format [XPZ#teamId#key].
  3. Tap Code to display it as a QR code that the other phone can scan, or
  4. tap Share to send the text through SMS, email or a messaging app.

Step 2 — Join with the Team Key (new device)

Join Existing Team dialog with privacy agreement checkbox, team key field, Scan and Join buttons
  1. Open Xopoz on the new device and go to the Teams tab.
  2. Tap Join Existing Team.
  3. Tick I accept to share my position with team members.
  4. Paste the key into the Team Key field, or tap Scan to read the QR code shown on the other phone.
  5. Tap Join. The app validates the key, stores it securely and completes team membership.
Secure by design. The ticket contains the team encryption key. The joining device proves it has the key via a cryptographic challenge — the server verifies access without ever seeing the key itself.
Keep your team key secret. The team encryption key is static for the lifetime of the team and is embedded in the ticket. Anyone with a valid ticket can join the team and access all members' locations. As the dialog warns: share it only with trusted people.

Controlling What You See on the Map

Each team and each device has an independent visibility checkbox in the Teams tab.

Live Updates

Team member data refreshes automatically; pull down on the list to refresh immediately. Connection status for each member is shown in real time, so you always know who is actively sharing their location.

Push position warning. If you have disabled Save my position on server in Settings, a red banner appears at the top of the Teams tab reminding you that your team will not receive your position.