User manual

How TerraLoop works

A complete guide to the app: every feature, where to find it, and the rules and limits behind it.

1 Getting started

TerraLoop turns real movement into a territory game. Walk, run, bike, or drive a closed loop and the ground inside it becomes your team's land. Enclose a rival's zone to take it whole, cut across one to carve off a slice, or touch your own land to grow it.

1.1 Install and create an account

  1. Download TerraLoop from the App Store (iPhone) or Google Play (Android).
  2. Create an account in the app, or ahead of time at terraloop.app/signup. It's the same account either way. If a friend sent you an invite link, their referral code is filled in for you.
  3. Open the verification email and tap the link. You can't sign in until your email is verified. If it didn't arrive, tap Resend verification email on the sign-in screen. Links expire after 24 hours.
  4. Sign in. New accounts get a short guided setup: pick your main mode (walk, bike, drive, or mixed), set a weekly goal, choose reminders, then swipe through how loops, capturing, teams, and fair play work. The same rules are always at You → How to play.
Account rules. Usernames are 3–30 characters (letters, numbers, _, ., -), and you can change yours once (fixing capital letters doesn't count). If a moderator resets an offensive name, you get to choose again. Passwords are 8–128 characters. Names that fail the offensive-language filter are refused.

1.2 Permissions

  • Precise location is required. Approximate location isn't accurate enough to draw loops.
  • Screen-off recording needs nothing extra. Once you start a recording it keeps going with the screen locked or another app open, using the same "While using the app" permission. Android shows a "TerraLoop is recording your route" notification (iPhone shows a blue location indicator) until you finish. TerraLoop never asks for "Allow all the time".
  • Notifications are optional, but they're how you hear that your land was attacked, an event went live, or a teammate called a raid.

TerraLoop only collects location while you're actively recording.

1.3 Pick a side

You need a team to claim territory. The Team tab gives three choices:

  • Join a team. Search the list and tap Join. Depending on the team's policy you're in right away, or your request waits for a leader's approval.
  • Found a new team. Choose a name, color, fill pattern, and emblem. You become its leader.
  • Fly solo. Claim land under your own banner as a "team of one." You still appear on the player leaderboard.

You can record tracks (stats-only activities) without a team. Your first team join is free; after that, switching teams has consequences (see Switching teams).

3 Recording an activity

3.1 Choose a mode

Every recording is Walk (covers running too), Bike, or Drive. Each mode has its own territory pool, speed limits, and area cap. Land claimed on foot never interacts with land claimed by bike or car, so the same street can belong to three different owners at once.

3.1.1 Driving

Never use TerraLoop while you're driving. Record a drive as a passenger, or start it before you set off and leave it hands-free. Before your first drive, TerraLoop asks you to confirm that.

  • While a drive records the screen shows only the time, the distance and a large Stop drive button. Banners, side buttons and territory cards stay hidden, and route directions are spoken even if you've turned voice off.
  • When you stop, your results wait behind an I'm parked card, so nothing pops up while the car may still be moving.
  • Drive is its own game. From the season starting January 1, 2027, drive points count on the Drive leaderboard only. They don't count toward your team's season total, and drive land doesn't count in leagues or live events. Seasons that started earlier keep the old rules until they end.
  • A drive isn't exercise. A drive loop earns a flat 10 XP, with nothing for distance, and drives don't earn training XP, advance distance or workout quests, or keep your day streak going. Your fitness totals on the Stats screen leave drives out and show drive distance on its own line.
  • Drives scout. A drive turns up wild zones in the empty areas along its route, up to about 10 map cells per drive, and tells your team when it finds new ones. Drives can't tame wild zones; that's for walkers and riders.
  • Drive land fades faster. It's safe for 5 days after it was last claimed (10 for walk and bike land), then decays as usual.

3.2 Choose a recording type

TypeWhat it does
Loop · claim landDetects when you close a loop and claims the area inside it. Needs a team (or solo).
Track · stats onlyA point-to-point or free-form route kept for your stats. It never claims or touches territory, even if it happens to close. No team needed. Still earns XP, quest progress, and streak credit.

3.3 Record

  1. On the Map, tap Start recording and pick your mode and type.
  2. Move. The live panel shows time, distance, pace, and elevation climbed. Pro members also see grade, top speed, and calories.
  3. To close a loop, return to within 30 m of any earlier point on your route. It doesn't have to be your start point. Stuck? The controls rail offers a route back to your start.
  4. Tap Finish and claim (or Finish track).
  5. Name it. A suggested name like "Morning Walk" is filled in; accept it, edit it, or discard the whole recording. A loop's name also names the territory it claims.

The result sheet then shows what happened: area secured, enemy land captured or carved, season points (including landmark and role bonuses), XP, and an animated replay of the capture. New personal records are celebrated here too.

3.4 What counts as a valid recording

  • At least 60 seconds long and at least 20 GPS points.
  • Within your mode's speed limits (see Fair play).
  • A loop must enclose at least 2,000 m² to claim land (about half an acre, or a large city block).
  • To earn training XP and streak credit, an activity needs at least 300 m and 60 s.

3.5 When a loop doesn't claim

  • It never closed. It's saved as a track automatically, so your distance, pace, and XP still count. The result sheet says "Loop saved as a track."
  • It closed but was too small, or bigger than the mode's cap. It's recorded as a completed loop that didn't claim.
  • You picked the wrong mode (for example, drove while set to Walk). If your speed clearly fits a faster mode, the app offers a one-tap resubmit under that mode. You don't need to re-record, and it doesn't hurt your trust score.
  • There was a GPS gap of more than 3 minutes where you also moved more than 50 m. The land claim is withheld (the gap is a stretch nobody actually covered), and the run is saved as a track.
  • You recently switched teams. Claims are locked for 48 hours; the run still records for stats.

3.6 Offline and crash-safe

  • No signal? A finished activity is saved on your phone and submitted automatically when you're back online. The Map shows an Activity queue with each item's status (queued, syncing, accepted, rejected). A retry never double-claims.
  • App closed or phone died mid-recording? Every GPS fix is saved as it's recorded. Next time you open the app, a sheet shows the unfinished route's distance, duration, and how long ago it stopped, with Resume, Save it, or Discard. Routes interrupted more than 6 hours ago can only be saved or discarded.
  • Battery saver (You → Preferences) records at a lower GPS rate for long walks and rides. Leave it off for tight loops.

3.7 Importing from a watch (Strava coming soon)

Go to You → Connected apps (or the web portal's Profile & account).

  • Upload a GPX or TCX file exported from any watch app (Garmin Connect, Coros, Wahoo, Suunto, Apple Health and others). Pick Walk/Run, Ride or Drive first.
  • Strava (coming soon): once it's switched on, you'll connect Strava here and every run or ride you record there will count automatically, including runs from a Garmin, Coros, Wahoo, Suunto or Apple Watch that syncs to Strava. Anything you finished in the last two days will be imported the moment you connect. Until then the Strava row shows Coming soon.
  • Time limits: an imported run claims territory only if it finished within the last 48 hours. Up to 7 days old it still counts for distance, streaks and XP. Older runs aren't imported.
  • Up to 5 imported claims a day. Runs recorded in TerraLoop don't count toward that limit.
  • Imports get the same anti-cheat checks as live recordings, but never the Verified badge. E-bike, virtual and indoor-trainer activities don't count.
  • Recorded it twice? If you record a run in TerraLoop and on your watch, it counts once, whichever arrives first. That never counts against you.
  • Routes imported from Strava are only ever shown to you. Disconnecting Strava removes their route maps; their stats and any land they claimed stay.

4 Territory rules

All rules are applied by the TerraLoop server when you submit, never on your phone, so everyone plays by the same rules.

SituationResult
Closed loop of 2,000 m² or moreThe area inside becomes your team's territory.
A rival zone (same mode) is completely inside your loopCaptured whole, unless it's larger than 20,000 m². Then it starts a siege.
Your loop partially overlaps a rival zoneThe overlap is carved off their zone and added to yours.
Your loop touches your own zone (same mode)Merged into one larger territory.
Your loop touches a teammate's zone (same mode)Left with your teammate. You claim only the ground around it. A loop entirely on teammates' land claims nothing, but still counts as training.
A zone owned by an allied teamLeft untouched. Your claim flows around it.
A zone claimed in a different modeUnaffected. Walk, bike, and drive pools never interact.
Loop bigger than the mode's capRejected. Caps: walk 150 km², bike 500 km², drive 2,000 km².
  • Figure-eights and wiggles: if your route crosses itself, the largest clean loop wins, so a lap plus a detour still claims the full lap.
  • Landmark bonus: enclosing a notable place (a park, a landmark) pays extra season points. Bonus landmarks show as pins on the map, and the Route Builder previews the bonus before you go.
  • Verified badge: a claim with zero anti-cheat flags shows a checkmark on its territory card.
  • Season points are earned from claims and captures and add to your team's season score. Losing land later doesn't take points back.

5 Sieges, decay & shields

5.1 Sieges: taking big zones

A territory larger than 20,000 m² can't be taken in one loop.

  • Fully encircling it starts a siege and deals damage equal to the area of the loop you ran.
  • Repeated encirclements, by you or teammates, add up. When total damage reaches the zone's area, it's captured whole.
  • A siege lasts 72 hours. If attackers don't finish in time, the siege is repelled and the defender keeps the land.
  • Carving off slices still works during a siege, and a zone shrunk below 20,000 m² can then be captured in one loop.
  • Both sides are notified when a siege starts, succeeds, or is repelled.

5.2 Decay: use it or lose it

  • Land is safe for 10 days after anyone last claimed, captured, merged, or shrank it (5 days for land claimed by drive).
  • After that it shrinks by about 8% a day. Below about 1,000 m², it disappears entirely.
  • Decaying land keeps its color but gets a dashed outline on the map. Tap it for a warning.
  • To stop decay, loop through it again. Any claim over that ground resets the clock. There's no separate "defend" action.
  • You're notified when decay starts and if a zone is lost to it.

5.3 Streak shields

  • Everyone gets one free shield per week (it refreshes each Monday, ISO week).
  • Tap any of your team's territories on the map and apply the shield. That zone won't decay for 14 days (21 days if your role is Defender).
  • Shields pause decay only. They don't stop captures or sieges.
  • Your shield status is also shown on the Game tab.

6 The Map screen

6.1 Header

  • Streak flame: your current day streak. If you haven't been active today, it turns to a warning color and shows the hours left before midnight.
  • Bell: opens the notification center; the badge counts unread items.

6.2 Controls rail

A column of buttons on the side of the map:

  • Events (flag): live and upcoming team events.
  • Leagues: your regional division.
  • Quests: daily, weekly, and team quests. Some count any walk, run or ride; some only walks (On foot) or only rides (Saddle time); and Four days out counts the days you get out at all, so a short walk keeps it going.
  • Discover routes: trails and popular loops near you.
  • Ghost route: suggests a loop from where you stand, biased toward the edge of your team's land. Use Try another shape to re-roll it, and Start loop along this route to record it.
  • Route back to start: while recording a loop, shows the way back to close it.
  • Air quality & pollen (Pro): conditions near you before you head out.
  • Recenter: jumps back to your location.

6.3 Layers sheet

  • Territory overlay: All, My team, Alliance (your team plus allies), or Off.
  • Mode filter: Auto or a single mode (Walk, Bike, Drive), to see each territory pool on its own.
  • Landmarks: bonus-landmark pins.
  • Boss zones: shared neighborhood goals, shown in red with a flame marker.
  • Events: outlines of active event regions.
  • Wild zones: unclaimed land with an XP bounty (see 6.7). On by default.
  • Contest heat: shades the areas where land has changed hands most in the last 24 hours, 7 days or 30 days. Busier areas are darker. An area needs at least two changes to show, and the shading covers blocks of about 500 m, so it shows where the fighting is without pointing at anyone. On a team, switch to Front lines to see only your team's own fights: land a rival took from you, and land you took from a rival. Red blocks are ground you're losing, the others ground you're winning. Claims of open ground and land lost to decay don't count.

6.4 Reading the map

  • Each team's land is drawn in its color and pattern (solid, stripes, or dots).
  • Dashed outline: decaying or under siege.
  • Pale fill with a road-like edge (a wide band in the team's color with a dashed center line): land claimed by car. It's its own pool, so walkers and riders can't take it and it never takes theirs.
  • Soft halo: allied land, which you can't capture.
  • Moving colored dots: nearby players recording right now (only players who've turned on live presence).
  • Emblems and special borders on a zone are Pro cosmetics. They're only visual.

6.5 Tapping a territory

The territory card shows its name, owner, team, area, mode ("Claimed via"), verified badge, and any siege or decay status. On land you own you can rename it, apply your shield, or share it as a public card. On someone else's land you can report an offensive name.

6.6 Live route sharing

While recording, tap Share live route to create a link that anyone can open in a browser to follow you live (a walking partner, a parent, a run club). The link shows no username, positions are slightly coarsened, it expires after 4 hours by default (12 hours at most), and it ends automatically when you stop recording. Tap the stop button to end it early.

6.7 Wild zones

Where nobody has claimed anything yet, the map offers wild zones: gold, dashed shapes with a leaf marker, drawn around parks, stadiums, campuses, zoos and popular local loops. They give you somewhere to go on a quiet map.

  • Tame one by closing a Walk/Run or Bike loop that covers at least 60% of it. The first player to do it earns its one-time bounty: 40 to 200 XP, more for bigger zones. The result screen lists every zone you tamed.
  • Your loop claims territory as usual. The wild zone itself isn't territory: it doesn't count toward area, leaderboards or decay, and it disappears once it's tamed.
  • You can earn up to 5 bounties a day. Drive loops don't tame wild zones.
  • Wild zones never overlap anyone's land. An untamed zone expires after 30 days, and new ones appear as the map fills in.
  • Tap a zone to see its size, bounty and when it expires. Hide them in the Layers sheet.

7 Planning routes

Every route tool is free for everyone, because routes affect what land you can claim.

7.1 Route of the Day

Each day you get one personalized loop (around 2.5 km, adjusted to your usual distance) that passes a nearby landmark. Find it on the Game tab or load it from the Map banner. Complete it by recording a loop or track that follows its path and covers at least 60% of its distance. You earn 100–300 bonus XP (×1.5 for Cartographers).

7.2 Route Builder

  • Tap the map to drop waypoints (use Undo or Clear), add objectives (nearby landmarks), or Generate loop for a target distance.
  • The preview shows distance, elevation, enclosed area, and landmark bonus points. It warns you if the loop is too small (under about 2,000 m²) or over the mode's cap.
  • Save route (optionally Share with my team), or Start recording this loop right away.

7.3 My Routes

Your saved routes plus any your teammates shared. Start recording one, delete it, or switch it between Private and Public. Public routes appear in other players' Discover feeds. Routes are private by default.

7.4 Discover routes

One feed of routes you can start near you, each badged by source:

  • Trails: real named trails from OpenStreetMap.
  • Popular: loops many different players have completed nearby. No individual player's route is shown.
  • Community: routes other players chose to make public.
  • Mine / Team: your own and your team's saved routes.

Filter by source, mode, and search radius (2–25 km). Tap a card to start recording along it.

8 Teams

8.1 Team roles

RoleCan do
LeaderEverything below, plus: set who can join, promote or demote officers, transfer leadership, manage alliances, disband the team.
OfficerApprove or decline join requests, send invites, set challenges and raids, schedule sessions.
MemberClaim land for the team, contribute to quests, challenges, and raids, RSVP to sessions, shield team land.

To manage someone, tap them on the roster: Make officer, Make leader, Remove from team, Block, or Report.

8.2 Who can join

SettingWhat happens when someone taps Join
By request (default)A request goes to the leader and officers, who approve or decline it on the Team tab.
AnyoneThey join immediately.
Invite onlyJoining is refused. The only way in is an invite (Recruit → enter a username).
  • Requests and invites expire after 14 days. You can have up to 5 open requests at once.
  • If you've been invited and also ask to join, or vice versa, you're in immediately.
  • Joining a team cancels your other outstanding requests and invites.

To bring a whole run club, class or office in at once, a leader or officer can create a join link on the Team tab (Club join links). Anyone who opens it can see the team and join in one tap, without waiting for approval, whatever the team's join setting.

  • A link works for 50 joins over 14 days by default, and can be set up to 500 joins or 90 days. A team can have 5 working links at once.
  • Give a link a label (say, "Saturday 8am group") to tell them apart. Turn off stops a link right away. People who already joined stay on the team.
  • The usual rules still apply. A player who has blocked the team's leader, or been blocked by them, can't join with a link. A player switching from another team pays the normal switching penalty, and the link warns them first.
  • A link opens the app if it's installed. If not, the web page shows the team and how to get TerraLoop.
  • Posted in a Facebook group, a group chat or Discord, a link previews with the team's name, size and logo.

If your club already talks somewhere else, the team leader can link it on the Team tab (Team community). Paste the link to your Facebook group, Discord server, WhatsApp or Telegram group, Meetup group, Strava club, GroupMe, Instagram or subreddit. Everyone on the team gets a button to it, and so does anyone who opens one of your join links. Links to other sites aren't accepted. TerraLoop only links to the group: it doesn't read or post anything there. Change or Remove it at any time.

8.3 Team look

Leaders choose a territory color (8 colors), a fill pattern (solid, stripes, or dots), and an emblem (one of 8, or an uploaded logo). All of the team's land is drawn in that look. Team names can be up to 28 characters.

8.4 Switching teams ("Scorched Earth")

Joining a team for the first time is free. Moving from one team (or solo) to another is a defection:

  • Territory you alone own under your old team turns neutral gray and then decays away. It isn't transferred.
  • Every season point you earned for your old team is subtracted from its score.
  • You can't claim territory for 48 hours. You can still record, and your distance, streak, and XP still count.
  • A leader must transfer leadership to a teammate before leaving, unless they're the only member.

9 Challenges, raids & sessions

These are on the Team tab. Challenges and sessions give your team a target or a time to meet. They don't hand out extra rewards: what you earn is whatever the runs themselves earn.

9.1 Goals

Leaders and officers use Set a goal for a shared target with a deadline, for example "cover 50 km combined by Sunday" or "log 25 workouts this week." Distance, time, climb, and workout goals count any activity. Loop-count and area goals only count loops that claim land; the form tells you which is which.

9.2 Raids

Call a raid on a rival zone near you. Progress is the square meters your team takes off it (captures, carved slices, and siege damage). Capturing the zone completes the raid. The board shows who contributed; recording in the raid counts you in automatically, even if you didn't tap Accept.

  • Deadlines: presets from Today to 2 weeks (anywhere from 1 hour to 30 days).
  • Up to 10 active challenges per team.
  • If another team takes the target zone first, the raid ends as expired.

9.3 Team sessions

  • Schedule a session (leaders/officers): a name, start time (5 minutes to 60 days ahead), length (15 minutes to 6 hours), optional mode, meeting point, route, Every week repeat, and Allow guests.
  • RSVP: Going, Maybe, or Can't make it. Reminders arrive the day before and within the hour.
  • Check-in is automatic: record your run as usual. If it overlaps the session time (±30 minutes) and passes within 300 m of the meeting point, you're checked in. Didn't record? Tap I'm here — check in at the meeting point.
  • About 90 minutes after it ends, attendees get a recap of who showed up.
  • Guests: an invite link lets up to 25 people from other teams (or no team) RSVP to that one session. It doesn't change their team or touch territory.
  • The session screen shows a "recording now" dot for attendees who have live presence on. It never shows their location.

9.4 Team Radio

Your team's channel, the Team Radio tile on the Team tab. Chat with teammates, plus dispatches the game posts when something happens: a teammate captures rival land, a flare goes up or is answered, a war starts or ends, someone joins. Tap a dispatch to jump to it. Dispatches appear in your language, with players' and teams' current names. Messages are kept 30 days. Long-press your own message to remove it (leaders and officers can remove any). There's no push for chat; the tile shows how many messages are new.

9.5 Flares: calling for backup

When your team's land is under siege, decaying, or fading (untouched for a week), fire a flare from the territory's sheet on the map or from the Flares tile. Your teammates get a push. For the next 24 hours, any teammate whose run crosses that land answers it:

  • the land's decay clock resets;
  • 40% of any siege damage is repaired, so several teammates can fight a siege off;
  • the runner earns 25 XP (up to 3 answers a day) and shows up as backup on the Flares screen.

Your own runs don't answer your own flare. You can have 3 flares up at once.

9.6 Turf Wars

  • Opt-in: a leader or officer marks the team war-ready. Only war-ready teams can declare war or have war declared on them.
  • Neighbours only: the rival has to hold land within 25 km of yours. You can't fight an ally, and each team can only be in one war at a time.
  • 12-hour muster, then a 48-hour battle. During the battle, every square meter either team takes off the other scores: captures, carved slices and siege damage.
  • Flags: taking 5%, 15% or 30% of the rival's land (as it was when war was declared) earns 1, 2 or 3 flags. Most flags wins; ties go to whoever took more. Because flags are a share of the rival's land, a small team can beat a big one.
  • The team page keeps your war record (wins, losses, streak) and each war's top raiders. Either side can call a war off before the battle starts. The same two teams can't fight again for 7 days.

9.7 Running Mates

Follow friends and rivals from You → Running Mates, the add-person button at the top of the Feed, or Follow on someone's territory. Running Mates shows every claim they make: size, mode and territory name, never a route or a location. Find suggests players holding land near yours. Blocking someone ends any follow between you.

9.8 The Feed

The Feed tab shows what's happening on the map. It is read-only and never sends a notification.

  • What appears: a player's first land; claims that took or cut into rival land, or covered at least 5 ha; players joining a team (not going solo); Turf Wars declared and won. Several claims by one player within an hour show as one line.
  • Views: Nearby (about 11 km around your team's land, or your phone's location if you don't hold any yet and have allowed location), Following (players you follow), Team (anything involving your team) and Highlights (wars, and claims of 10 ha or 3+ rival zones from everywhere).
  • Privacy: claims appear about 20 minutes after they happen, with the time rounded to 15 minutes, and never with a route or an exact place. A claim touching one of your privacy zones never appears for anyone else. Players whose land was taken are never named. Events are kept for 30 days.
  • Leaving the feed: turn off You → Notifications & privacy → Show me in the public feed (or the same switch in the web portal). Your past events disappear too. War results are about teams, so they still show.
  • Cheers: long-press a line and pick 🔥, 👏 or 💪 to cheer it. Only the cheers a line has received show under it, and you can tap one of those to add yours. You get one cheer per line: pick another to switch, or the same one to take it back. Counts are anonymous, nobody is notified, and you can't cheer your own.
  • Safety: long-press a player's line and tap Report player to report or block them. Blocking hides each of you from the other's feed.
  • On the web: terraloop.app shows the latest Turf Wars and the biggest captures and claims by team only: the team name and the number of zones or the area, never a player, a place or a route. Only teams of three or more players are named there, and the same rules as the app apply: claims near a privacy zone, and players who turned the Feed off, are left out.

10 Alliances

An alliance is a non-aggression pact between teams. Allies can't capture or carve each other's land. Territory and season points stay separate.

  • Only leaders can found, invite to, accept, or leave an alliance, from the Team tab.
  • A team can be in one alliance at a time. Solo players can't join alliances.
  • If fewer than two teams remain, the alliance disbands automatically.
  • Allied land has an ally badge and a soft halo on the map. The Alliance overlay shows your whole bloc at once.

11 Compete: ranks, events, leagues

11.1 Ranks (leaderboards)

  • Global: season standings for Players or Teams.
  • Nearby: who holds the most land around you right now, within 1, 5, 10, or 25 km.
  • Your local rank and its recent trend are also shown on the You tab ("Rank near you").

11.2 Seasons

Each season runs for three months, starting January 1, April 1, July 1 and October 1 (UTC). Season points build up over the season. When it ends, the final standings are saved and everyone's season points, the season leaderboard and the Season Pass start fresh.

Your territory carries over into the next season. Holding land doesn't earn season points, though: points only come from claiming and capturing, so every team starts the new season level. Land nobody revisits still shrinks and fades away (see Decay). Teams, leadership, XP, badges, and your lifetime stats carry over too.

Halftime and the Final Stretch. Halfway through each season (mid-February, mid-May, mid-August and mid-November) every team gets a halftime report on where it stands. Then the Final Stretch begins: a second race, on its own tab of the leaderboard, counting only the points each team scores from halftime on. A team far behind on the season board can still win it.

Champions. When a season ends, its winners keep something for good:

  • Everyone on the #1 team at the moment the season ends gets the Season Champion title and the Victor's Standard claim flag. You need to be on the team when the season ends; players who left before then don't share the win.
  • The top 3 players by season points get the Season Ace title and the Champion Wreath profile frame.
  • Everyone on the team that scored the most in the Final Stretch gets the Strong Finisher title.

Ties go to whoever holds more land, as on the leaderboard. Past winners are listed in the Hall of Champions under the season leaderboard, and your own honors appear on your profile.

Holiday events. For a few weeks around a holiday (the winter holidays, Valentine's Day, Easter, the Fourth of July, football's opening weeks, Halloween and Thanksgiving) a short holiday track runs beside the Season Pass. The same XP moves both. It has 8 tiers with a free lane and a gold lane of themed rewards: animated claim flags, full-color emblems, a capture effect, a profile frame, a share-card theme and titles. Holiday rewards can only be earned while the event runs and are yours to keep. You have 7 days after it ends to claim anything you reached. The gold lane comes with Pro, or with that season's one-time Gold Pass. Find it on the Play tab or the Season Pass screen. A fresh holiday claim flag also gives off a little snow, leaves, hearts or bats on the map for everyone to see.

11.2.1 The Season Map

Open Season Map from the Play tab or the Team tab to see your team's season as a picture: every territory it holds now, drawn in the team color. Tap Play to watch the season back day by day. Ground gained lights up and ground lost flashes red, ending on what you hold today. Below the map are the season's totals: area held, gained and lost, captures, and season points.

Share turns it into a card with your team's outlines and stats. The card shows shapes only, with no street map, and leaves out any land that touches a player's privacy zone, so it doesn't show where anyone lives. Your weekly recap card shows the outlines of the week's claims the same way, and leads with your longest loop and MVP teammate.

11.3 Live events

Timed contests over a map region: the team holding the most combined area inside it when time runs out wins. Events are listed as Live, Upcoming, or Ended, and standings update live. You're notified when an event starts and about 5 minutes before it ends. Teams that took part get a result when it's over.

11.4 Regional leagues

  • Your team is enrolled automatically, in the lowest division covering the area, the first time it holds land inside a league's region.
  • Standings rank every team in the division by land held inside the region.
  • At the end of each period (usually weekly), the top teams are promoted and the bottom teams relegated (usually two each).
  • Some leagues count only certain modes. For example, a walk-only league ignores bike and drive land. Look for the activity tag on the league card.
  • Solo players aren't enrolled in leagues.

Drive leagues. Land claimed by car has its own ladder. Every region with a team league also has a drive league (and crews elsewhere play World Drive Open). It ranks only drive land, and your crew plays both at once: switch between Team league and Drive league at the top of the Leagues screen. Your crew joins the drive league with its first drive claim in the region and climbs it the same way, by promotion each period. From the season starting January 1, 2027, the team league counts only walk and bike land (see Driving).

12 The Play hub

Open it from You → Play hub. (Before 1.13.0 it was the Game tab.)

12.1 Role identity

Pick one role. Each gives a small, balanced perk, and you can change it later.

RolePerkMastery grows from
Scout+15% season points for claiming fresh, unclaimed groundNew ground explored
Striker+15% season points on land captured from rivalsEnemy captures
DefenderShields last 21 days instead of 14Shields deployed
Cartographer+50% XP for the Route of the DayDaily routes completed

Role mastery (for example "Lv12 Striker · 47 captures") shows your experience in a role. It's a title only: the perk is the same at every mastery level.

12.2 Everything else in the Play hub

  • Streak shields: this week's shield status (see shields).
  • Route of the Day: today's loop and Walk this route.
  • Neighborhood boss zones: shared goals where every player's claims inside the zone add up. When the total area target is reached and enough different players have taken part, every contributor earns the reward XP.
  • Territory heatmap: where land has changed hands over the last 30 days.
  • Weekly story recap: last week's land gained and lost, longest loop, MVP teammate, and XP. Tap share to get a public card link. The link always shows the same snapshot, and you can revoke it.
  • Invite friends: your personal invite code and link, or email an invite directly. When a friend signs up with it and verifies their email, you both get 200 XP.
  • Shortcuts to Quests, Stats, Events, Leagues, Discover routes, the Route Builder, and My saved routes.

13 XP, quests, streaks & badges

Land comes from loops. Progression comes from any movement. XP and levels are separate from territory: losing land never costs you XP.

13.1 Quests

  • Daily (for example: close 1 or 3 loops, cover 3 km, claim 5,000 m², capture a rival zone, plus workout quests).
  • Weekly (for example: 10 loops, 25 km, 50,000 m², 5 captures, plus workout quests).
  • Team weekly (for example: 200,000 m² or 40 loops combined). Every member earns 100 XP when it's done.
  • Player quests are worth 20–180 XP. The Quests screen shows live progress, your completed history, and your badges.
  • Claim-type quests (loops, area, captures) only move with loops that claim land. Workout-type quests (distance, time, climb, workouts) move with any accepted activity.

13.2 Training XP

Every accepted activity of at least 300 m and 60 s earns training XP based on distance and climb: up to 40 XP per activity and 120 XP per day. XP from claims doesn't count toward that daily cap. For the same distance, closing a loop always earns more than not closing one. Training XP never grants territory or season points. Drives earn no training XP (see Driving).

13.3 Levels

There's no level cap. Reaching level n takes 50 × (n − 1)² total XP: level 2 at 50 XP, level 5 at 800, level 10 at 4,050.

13.4 Day streak

Any day with a qualifying walk, run or ride (a loop or a track) extends your streak. Drives don't count. The flame on the Map warns you when today's activity is still missing.

13.5 Badges

  • Streak: 7, 30, and 100 days.
  • Level: 5, 10, and 25.
  • Quest: your first completed quest, plus certain weekly quests.

14 Stats, replays & records

14.1 The Stats screen

Open it from You → Stats & analytics.

  • Filter by mode (All, Walk, Bike, Drive).
  • This week vs. last: distance, moving time, elevation, calories, and activity count, with percentage changes.
  • Weekly goal: set a weekly distance target and track it with a progress ring (Clear goal removes it).
  • Trend chart (14, 30, or 90 days; longer with Pro) for distance, area, loops, and more.
  • Loops vs. tracks breakdown, Consistency, Calories burned, Steps, trust score, and accept rate.
  • Personal records: fastest 1K, 1 mile, 5K, 10K, half marathon, and marathon on foot; fastest 5K, 10K, 20K, and 40K on a bike; longest activity; biggest climb.
  • Activity history: every loop and track, filterable, and renameable (up to 60 characters).

14.2 Replays

Tap any activity to replay it as an animated "ghost trail" with its stats: per-km or per-mile splits (the fastest highlighted), moving time vs. elapsed time, elevation gain and loss, average and top speed, and calories.

  • Share a replay: the share button creates a public link. Creating a new link turns off the old one, and you can revoke it at any time. Parts of the route inside your privacy zones are hidden from viewers.
  • Takeover replays: when someone captures or carves your land, the notification links to a replay of exactly how it happened. These are available for 15 days.
  • GPX export (free): download any activity as a .gpx file for other fitness apps, from the web portal.

14.3 Athlete profile

Optionally add your weight, height, birth year, and sex under You → Account → Athlete profile. Weight makes calorie estimates more accurate (otherwise 70 kg is assumed), and height makes step counts more accurate. Every field is optional.

15 Notifications

The bell on the Map opens your notification center: tap an item to jump to it, delete it, or Mark all read. With push enabled, the same alerts reach your lock screen, and tapping one takes you straight to the right screen.

Under You → Push notifications you can mute any category:

  • Territory captured or raided
  • Sieges
  • Territory decay
  • Neighborhood activity
  • Global leaderboard
  • Team activity
  • Team challenges
  • Alliances
  • Quests and badges
  • Streak reminders
  • Live events
  • Regional leagues
  • Boss zones
  • Route of the Day
  • Weekly recap
  • Referrals
  • Goals & progress
  • Tips & personalization
  • Team sessions
  • Safety reports

Muting a category only stops the push. Everything still shows up in the in-app notification center.

16 Your profile & settings

The You tab shows your photo, level, and stat tiles (area held, territories, loops closed, captures, distance, day streak, badges), your local rank, and your role mastery. Tap your photo to change it. Below that:

SectionContains
Stats & analyticsOpens the full Stats screen
PreferencesTheme, Units (Metric or Imperial), Language, Battery saver
Notifications & privacyPush notification categories, Live presence, Show me in the public feed, Privacy zones, Signed-in devices, Blocked players, Location access, Locked-screen loop reminder
AccountUsername, email (with verification resend), Change password, Athlete profile
Membership & rewardsYour plan (Free or Pro), the Pro feature list, purchase and restore, Territory look, Badges
Help & supportHow to play, Send feedback or a bug report, Rate TerraLoop, app version
Bottom of the pageSign out, Delete account
  • Forgot your password? Tap Forgot password? on the sign-in screen. The reset link expires after 1 hour.
  • Changing your password signs you out on every other device. Signed-in devices lets you sign individual devices out.
  • Changing your email keeps you signed in but requires verifying the new address.
  • Language: TerraLoop speaks English, Español, Português (Brasil), Français and Deutsch. It follows your phone's language unless you pick one in Preferences → Language. On Android 13+ and iPhone you can also set it in your phone's settings for TerraLoop. Captures, raids, decay warnings, team requests and invites, leaderboard changes, streak reminders and weekly recaps arrive in your language too, in the bell and as push notifications. Other notifications and some error messages from our servers are still in English for now.

17 Privacy & safety

  • Privacy zones: add up to 10 circles (250 m, 500 m, or 1 km in the app) around places like home or work. Route points inside them are hidden from anything you share publicly, including links you shared earlier. Territory that touches a zone still shows on the map, but other players see it held by "a private player", with the claim date but not the time, and it isn't credited to you by name on the nearby leaderboard. Your own stats and claims still use the full route, and nobody else can see where your zones are.
  • Live presence (off by default): when on, nearby players (within about 1.5 km) see a moving dot in your team color while you record. It disappears within a few minutes after you stop.
  • Public feed (on by default): your first land, big captures and team joins appear in the Feed about 20 minutes later, never with a route or an exact place, and never for claims touching a privacy zone. Turn it off in You → Notifications & privacy; that hides your past events too.
  • Public links (replays, recap and territory cards, live routes) use long random links that can't be guessed or searched for, and you can revoke each one.
  • Blocking a player hides you from each other on the live map and in the Feed, and prevents team invites and joins between you. It doesn't protect land: blocked players can still capture from each other.
  • Reporting: report a player, team, or territory name from its card or the roster, and optionally block them at the same time. Moderators review reports and can reset names or photos or suspend accounts. You'll be told when your report has been reviewed.
  • Deleting your account: You → Account → Delete account, in the web portal, or see terraloop.app/delete-account. Deletion is permanent and removes your territory, history, and everything else tied to your account.

Full details are in the Privacy Policy.

18 Fair play & anti-cheat

Every activity is checked by the server. The app also warns you in real time about poor GPS signal (accuracy worse than 50 m), mock locations, and speed spikes.

ModeMax sustained speedMax short burst
Walk / Run≈ 21.6 km/h (13.4 mph)≈ 34 km/h
Bike≈ 47 km/h (29 mph)≈ 72 km/h
Drive≈ 137 km/h (85 mph)≈ 198 km/h
  • Always rejected: teleport-like jumps (faster than 90 m/s between points), repeated over-limit bursts, mock-location apps, and recordings with bad timestamps or under 60 s / 20 points.
  • Suspicious but not rejected (for example, perfectly constant GPS accuracy or unnaturally even speed) lowers your trust score and goes to moderators for review.
  • Rejected activities are kept for review. The result sheet tells you why an activity was rejected.
  • Timeline checks: two of your recordings can't overlap in time, and you can't start a recording somewhere you couldn't have reached since your last one ended. Recordings dated in the future (check that your phone sets its clock automatically) or months in the past are rejected.
  • Late uploads: a loop recorded more than a week ago (say, queued offline on a trip) is saved as a track. The distance and pace still count, but it no longer claims territory.
  • Daily limit: you can claim territory up to 30 times in 24 hours. Runs past that still count toward your stats and training.
  • A claim with zero flags earns the Verified badge.

19 Free vs. Pro

Anything that affects who wins land or points is free for everyone. Pro adds comfort, deeper stats, and a personal look.

FeatureFreePro
All modes, loops, tracks, capturing, sieges, shields✓✓
Teams, alliances, challenges, sessions, events, leagues, seasons✓✓
Route Builder, ghost routes, Route of the Day, Discover, landmark bonuses✓✓
Quests, XP, badges, streaks, boss zones, recaps✓✓
Elevation, replays, splits, personal records, GPX export✓✓
Stats trend window30 days365 days
Activity history list50 activities250 activities
Live grade, top speed & calories while recording—✓
Air quality & pollen—✓
Real place names added to your claims—✓
Territory look: personal fill color and patterns (incl. crosshatch, grid, gradient, camo), premium and animated borders, and a personal emblem on your land—✓
Season Pass and holiday event gold lanes (cosmetic rewards)Free lanes (or a one-time Gold Pass per season)✓
  • Territory look is edited under You → Membership & rewards → Territory look, with Reset to team look to undo. On a real team, your team's color always wins on the shared map; your personal pattern, border, and emblem still show. Solo players get the full custom look.
  • If Pro lapses, your saved look is kept but not shown until you renew. You're notified 3 days before a time-limited Pro plan ends, and again when it ends.
  • See Pricing for plans. Buy Pro in the app (billed through the App Store or Google Play; use Restore purchases after reinstalling) or on the web portal by card through Stripe (Manage subscription there to change or cancel it). Season Pass and Crew Supporter are in-app only.

20 The web portal

At portal.terraloop.app, sign in with the same account to use TerraLoop on a big screen:

  • Dashboard: totals per mode, this week vs. last, your weekly goal, and personal records.
  • History & replays: filter, rename, replay on a full map, and download any activity as GPX.
  • Route builder: draw waypoints or auto-generate a loop, add landmark objectives, preview it, and save it to record later on your phone.
  • Notifications and badges.
  • Profile & account: username (one change per account), email, password, photo, notification preferences, athlete profile, membership, and account deletion.
  • A metric/imperial toggle in the header.

21 Limits at a glance

ItemLimit
Minimum loop area to claim2,000 m²
Maximum loop areaWalk 150 km² · Bike 500 km² · Drive 2,000 km²
Loop closing distanceWithin 30 m of an earlier point
Minimum recording60 s and 20 GPS points
Minimum for XP / streak credit300 m and 60 s
Training XP cap40 per activity · 120 per day
Siege threshold / durationZones over 20,000 m² · 72 hours
DecayAfter 10 idle days (5 for drive land), about 8% a day; removed below about 1,000 m²
Drive loop XPFlat 10 XP · no training XP or streak credit
Streak shields1 per week · 14 days (21 for Defenders)
Team switch cooldown48 hours with no claims
Join requests5 open at once · expire after 14 days
Club join links5 working per team · 50 joins / 14 days by default · up to 500 joins / 90 days
Wild zone bounties60% coverage to tame · 40–200 XP · 5 a day · zones expire after 30 days
Imported activitiesClaims within 48 hours · stats within 7 days · 5 imported claims a day
Team challenges10 active · 1 hour to 30 days
Team sessionsUp to 60 days ahead · 15 minutes to 6 hours · 25 guests
Alliances1 per team
Privacy zones10 per account
Live route share4 hours by default · 12 hours maximum
Crash-recovery resume window6 hours
Takeover replay links15 days
Stats history (Free / Pro)30 days, 50 activities / 365 days, 250 activities
NamesUsername 3–30 · Team 28 · Activity 60 characters
Username changesOne per account (capital-letter fixes are free)
Password8–128 characters
Email linksVerification 24 hours · Password reset 1 hour
Referral reward200 XP each, once your friend verifies their email

22 Troubleshooting

My loop didn't claim any land.

Check the result sheet. The usual causes: the route never came back within 30 m of itself (saved as a track), the enclosed area was under 2,000 m², a GPS gap withheld the claim, or you're in the 48-hour cooldown after switching teams. You also need to be on a team or flying solo.

My activity was rejected for speed.

If you picked the wrong mode, accept the one-tap resubmit under the suggested mode. If you were in a vehicle while set to Walk or Bike, the activity can't count in that mode.

The recording stopped when my screen locked.

Allow background ("Always") location for TerraLoop in your phone's settings (You → Location access takes you there). Also check that battery-optimization settings aren't closing the app.

I lost signal / the app crashed during a run.

Nothing is lost. Finished activities wait in the activity queue until you're back online. An interrupted recording is offered for Resume or Save the next time you open the app.

My territory is shrinking.

It's decaying because nobody has looped through it in 10 days. Record a loop through it, or apply your weekly streak shield, to stop it.

I can't capture a big zone.

Zones over 20,000 m² need a siege: keep encircling it (ideally with teammates, as a raid) until total damage matches its area, within 72 hours. Or carve slices off it until it's small enough to capture in one loop. Allied zones can't be captured at all.

I can't leave or switch teams.

Leaders must transfer leadership to a teammate first. Remember that switching wipes your old-team land to neutral, removes your points from that team's score, and blocks claims for 48 hours.

I didn't get my verification email.

Check spam, then use Resend verification email on the sign-in screen. Links expire after 24 hours.

How do I report a bug or get help?

Use You → Send feedback or a bug report, or email [email protected].

This manual describes TerraLoop v1.6. Some numbers may be tuned between releases; see the changelog for what's new.