Concept guide

What is a Trackable?

A trackable is a movable item identity that can accumulate note-based location history over time. Trackables connect physical objects or externally identified items to public pages, possession-based code flows, comments, and journey maps.

Identifiers: format reference and examples

Trackables use several identifiers that look similar at first but serve different jobs. The short public code stays globally unique, the short secret code stays globally unique, and the system keeps those two spaces collision-free against each other so a short public code can never also be someone else's short secret code.

Format Example Purpose Uniqueness rule
Public code token LN-7K4V9T Public-safe token used in public links and public lookup. Globally unique across all trackables and also unique against short secret codes.
Public entry route https://locationnotes.com/trackable/LN-7K4V9T Short public entry URL that can redirect to the canonical public page. The route stays unique because the short public token itself is globally unique.
Short secret route https://locationnotes.com/trackable/LN4C8R2Z Possession-based entry URL for someone who physically has the item. The prefix matches the site family, but there is no dash so it is visibly different from the public code.
System short secret code LN4C8R2Z Short possession credential for manual entry and active-session activation. Globally unique across all trackables and also unique against public codes.
Alternate system prefix GT8M2Q7V Same short-secret pattern on sister deployments that use the GT prefix. Unique across all trackables on that deployment.
Bring-your-own secret code ITEM42X Advanced external code for a physical item that already came with its own identifier. Unique across all trackables. It must not start with LN or GT.
Private scan route https://locationnotes.com/trackable/AB4D5QW2...<100 chars total>... Long QR entry URL so scanning can activate the possession flow without a form field. Unique across all trackables.
Private scan token AB4D5QW2...<100 chars total>... Opaque QR token using only A-Z and 1-5. Unique across all trackables.

When someone types a generated short secret code or a generated public-code token by hand, lookup is forgiving about the most common smudges. Generated code lookup treats O like 0, I or L like 1, S like 5, and U like V. For system short secret codes, that replacement logic applies to the generated body, not to the literal prefix like LN or GT. Public codes use the same configured prefix plus a dash, so they are visually different from short secret codes at a glance.

The most important practical rule is that the public route is safe to share, while the short secret code and the private scan route are not. Secret codes and private scan URLs are shown only once during creation. After that one reveal, normal pages and normal API reads do not show them again. The one special exception is departure-oriented personal export, where strictly personal user-owned secrets can be included so the departing owner can recover them.

Because the short public code is globally unique, homepage lookup can safely accept a public token like LN-7K4V9T by itself and route to the correct public page without guessing between multiple trackables.

Activation and ownership

A newly created trackable may start activated or unactivated. Activation always happens at the individual item level. The activating user chooses the final title and description for items that require explicit activation-time identity.

Groups and fallback metadata

Trackables can be created one at a time or in groups of up to 100. A group can supply fallback item title and description values so a batch of items shares a common theme. A trackable can belong to only one group at a time.

Trackables and notes

The note relationship is what makes a trackable interesting. Trackables are not just item labels; they become movement history when they are associated with notes. Each note can reference many trackables, and each trackable can reference many notes.

Note attachment is intentionally deliberate. The website asks for one trackable code at a time, that field expects an existing short secret code, and a public code is meant for the public trackable page instead. If a third-party item is not registered yet, create it from the trackables page first. Reserved site prefixes such as LN and GT stay off-limits for bring-your-own codes.

Trackables and browser sessions

Entering a secret code or scanning a valid private QR can create an active trackable session on the current browser. That remembered state lets the person continue learning the flow, sign in later, and attach the trackable from note pages without re-entering the secret every time.

This active browser session is not the same thing as permanent ownership and is not the same thing as authentication. It is simply remembered possession context on the current device until the person deactivates it or the session expires.

Comments and public pages

Trackable-page comments belong to the trackable itself and are separate from note-page comments. Public trackable pages are canonical journey views. Private profile pages, private team pages, and private trackable pages are route-level restrictions, not global secrecy for every label related to the item.

Exports, recovery, and deletion

Trackables survive deletion differently from simple personal records because they can carry shared history from many people over time. The system tries to remove the deleted user’s removable personal activity without corrupting the remaining history for other users or teams.

Related guides