Skip to content

docs: edit sandbox instructions for android installation #149

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
kchaw2005 merged 1 commit into from
Jul 27, 2026
+23 −25
Merged

docs: edit sandbox instructions for android installation #149

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 14 additions & 17 deletions world-id/sandbox/sandbox-access.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,8 @@ New here? Start with [What is Sandbox?](/world-id/sandbox/what-is-sandbox) for c

## 1. Install the sandbox World ID app

The sandbox builds are not published to the App Store or Google Play. You install them
directly using the links below.
The sandbox apps are not publicly listed in the App Store or on Google Play. You
install them through the testing links below.

### iOS — TestFlight

Expand All @@ -29,18 +29,16 @@ directly using the links below.
No App Store Connect account or per-email invite is required — the public link admits
you to the external tester group directly.

### Android
### Android — Google Play

The sandbox build is distributed via **Firebase App Distribution**.
The sandbox build is distributed through a **private testing track on Google Play**.

1. Open the invite/download link we provide.
2. Follow the link to install the **World ID (Sandbox)** build.

You may be prompted to install the App Tester helper the first time.

<Note>
Contact your World point of contact to get the current Android links.
</Note>
1. In the Developer Portal, select **World ID Sandbox** from the sidebar.
2. Enter the email address associated with your Google Play account to request tester
access.
3. Once access is granted, scan the QR code or open the Google Play link on the same
page.
4. Sign in with the same Google Account and install the **World ID (Sandbox)** build.

## 2. Point your integration at Sandbox

Expand All @@ -52,11 +50,10 @@ proof to your session over the bridge.

## Things to know

- **Sandbox apps aren't in the app stores.** Because the builds are distributed
directly to testers, install/store deep links won't route to a store listing the way
they do in production. Testers install via TestFlight (iOS) or the Android link
instead — so any journey that depends on a real store install can't be exercised
exactly as it will be in production.
- **Sandbox apps aren't publicly listed in the app stores.** Testers install via
TestFlight (iOS) or a private Google Play testing link (Android). Because access is
gated to testers, install links and store acquisition can behave differently from a
public production listing.
- **Proofs are non-production.** Identities and proofs issued in Sandbox are for
integration validation only.
- **Accounts are resettable.** You can delete and recreate accounts freely while
Expand Down
10 changes: 5 additions & 5 deletions world-id/sandbox/testing-selfie-check.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -49,11 +49,11 @@ Semi-cold states](/world-id/idkit/verification-flows) as the rest of World ID:

## Known limitations

- **Sandbox apps aren't published to the app stores.** As with other Sandbox testing,
install deep links won't route to a store listing the way they do in production —
see [How to get access](/world-id/sandbox/sandbox-access#things-to-know). This means
the Cold and Semi-cold journeys above can't be exercised exactly as they will be once
the app is on the App Store or Play Store.
- **Sandbox apps aren't publicly listed in the app stores.** Testers install through
TestFlight on iOS or a private Google Play testing link on Android. Because those
testing programs gate access, app-store acquisition can differ from a public
production listing — see
[How to get access](/world-id/sandbox/sandbox-access#things-to-know).
- **iOS Semi-cold is currently limited.** The reinstall/login journey reliably works on
Android today. On iOS, if the user taps "Sign in" instead of "Sign up" mid-flow,
there's no path to add the invite code — they have to restart from a fresh QR or deep
Expand Down
7 changes: 4 additions & 3 deletions world-id/sandbox/what-is-sandbox.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -46,9 +46,10 @@ and Android sandbox builds.
validation only — not load testing, security certification, or production sign-off.
- **Not a source of real uniqueness.** Sandbox does not represent real-world identity
or uniqueness at scale.
- **Not published to the app stores.** The sandbox World ID builds are distributed
directly to testers rather than through the App Store or Google Play. See
[How to get access](/world-id/sandbox/sandbox-access) for how to install them.
- **Not publicly listed in the app stores.** The iOS sandbox app is available through
TestFlight, while Android is distributed through a private Google Play testing
track. See [How to get access](/world-id/sandbox/sandbox-access) for how to install
them.

## Next step

Expand Down
Loading