Skip to content

docs(world-id): preserve sdk offering names #209

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

Open
Takaros999 wants to merge 2 commits into
base: main
Choose a base branch
from
Open

docs(world-id): preserve sdk offering names #209

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
e11bd00
docs(world-id): align marketing names across guides
Takaros999 Oct 5, 2026
edb7bdd
docs(world-id): preserve sdk offering names
Takaros999 Oct 5, 2026
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
16 changes: 9 additions & 7 deletions world-id/credentials/11.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,9 @@ import { CredentialHero } from "/snippets/credential-hero.jsx";

## Introduction

Proof of Presence (previously Selfie Check) uses the user's mobile device camera for liveness and facial
Proof of Presence is the credential used by Selfie Check in IDKit.

Selfie Check uses the user's mobile device camera for liveness and facial
similarity checks. It adds friction against automated and repeated account
creation without requiring a Proof of Human. Unlike high-assurance Orb verification,
Proof of Presence does not provide a strict one-person-one-account guarantee and is
Expand All @@ -62,7 +64,7 @@ other prerequisite credential is required.

## Uniqueness Risk Signal

Each Proof of Presence response includes a versioned `sybil_score` that
Each Selfie Check response includes a versioned `sybil_score` that
can help an app assess the risk of repeated enrollment. It is a risk signal, not
a uniqueness verdict, and should be considered alongside other evidence. The
response also includes an `integrity_bundle` that lets the Developer Portal
Expand Down Expand Up @@ -108,7 +110,7 @@ These standard-deviation bands should not be read as normal-distribution confide

## Choose your integration

Use **session proofs** if users need to complete Proof of Presence more than once—for
Use **session proofs** if users need to complete Selfie Check more than once—for
example, when returning to your app or confirming a sensitive action. Create a
session on their first successful verification, then prove that same session on
subsequent checks.
Expand All @@ -124,15 +126,15 @@ guarantee.

## How it works

Use the `selfieCheck` preset in IDKit to integrate Proof of Presence into your application.
Use the Selfie Check (`selfieCheck`) preset in IDKit to request this credential. See [Configure Credentials](/world-id/idkit/credentials#selfie-check) for the SDK integration.

* **On mobile (iOS/Android):** Use IDKit to generate a deep link and attach it to a "Verify" CTA. When the user taps it, they are redirected to World ID App to complete Proof of Presence.
* **On desktop:** Use IDKit to generate a QR code and display it to the user. When the user scans it with their mobile device camera, World ID App launches and guides them through Proof of Presence.
* **On mobile (iOS/Android):** Use IDKit to generate a deep link and attach it to a "Verify" CTA. When the user taps it, they are redirected to World ID App to complete Selfie Check.
* **On desktop:** Use IDKit to generate a QR code and display it to the user. When the user scans it with their mobile device camera, World ID App launches and guides them through Selfie Check.

## User Experience Flow

1. **Challenge:** The user initiates the flow on your app (Relying Party).
2. **Hand-off:** The user is redirected to World ID App. If they don't have World ID App installed, they are guided to download it and go straight into the Proof of Presence experience.
2. **Hand-off:** The user is redirected to World ID App. If they don't have World ID App installed, they are guided to download it and go straight into the Selfie Check experience.
3. **Enrollment/Auth:**
* **New User:** Enrolls with a selfie and liveness check.
* **Returning User:** Completes a short camera check to verify continuity.
Expand Down
2 changes: 1 addition & 1 deletion world-id/credentials/9303.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ import { CredentialHero } from "/snippets/credential-hero.jsx";

## Introduction

Proof of Attributes is a document-backed credential, also called the NFC Credential in technical references. It represents a unique government-issued document. It supports passports and eIDs. Availability varies by country and continues to expand over time. An NFC Credential is **guaranteed to be issued to a single World ID per unique document**. In addition to ICAO-9303 compliant documents (such as passports or eIDs), the Japanese [My Number Card](https://en.wikipedia.org/wiki/My_Number_Card) (MNC) is also supported. The MNC flow uses different enrollment handling internally, but it issues the same credential.
This NFC Credential is displayed as Proof of Attributes. It represents a unique government-issued document. It supports passports and eIDs. Availability varies by country and continues to expand over time. An NFC Credential is **guaranteed to be issued to a single World ID per unique document**. In addition to ICAO-9303 compliant documents (such as passports or eIDs), the Japanese [My Number Card](https://en.wikipedia.org/wiki/My_Number_Card) (MNC) is also supported. The MNC flow uses different enrollment handling internally, but it issues the same credential.

The World ID authenticator supports one NFC credential per user at a time.

Expand Down
21 changes: 12 additions & 9 deletions world-id/idkit/credentials.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,12 +13,14 @@ A [Credential](https://docs.rs/world-id-primitives/latest/world_id_primitives/cr
| Offering | What it proves | Common SDK path |
| --- | --- | --- |
| Proof of Human | The user is a unique human, backed by anonymous biometric verification by the Orb. | `proofOfHuman` |
| Proof of Attributes (Passport) | The user holds a verified NFC passport credential. | `passport` |
| Proof of Presence (Selfie Check) | A medium-assurance biometric credential using the device camera for liveness and facial similarity. | `selfieCheck` |
| Proof of Attributes (Identity Check) | An attestation that a document-backed property about the user matches your requested attributes. | `identityCheck` with attributes like `minimum_age`, `nationality`, or `document_type`. |
| Passport | The user holds a verified NFC passport credential. | `passport` |
| Selfie Check | A medium-assurance biometric credential using the device camera for liveness and facial similarity. | `selfieCheck` |
| Identity Check | An attestation that a document-backed property about the user matches your requested attributes. | `identityCheck` with attributes like `minimum_age`, `nationality`, or `document_type`. |

You can also add a liveness check to any preset with `require_user_presence`.

Credential cards use marketing labels such as Proof of Attributes and Proof of Presence. SDK presets retain their own names and behaviors; choose the preset that matches your integration.

<Note>
If you have an existing legacy integration, see the [World ID 4.0 migration guide](/world-id/4-0-migration).
</Note>
Expand Down Expand Up @@ -66,9 +68,9 @@ const preset = proofOfHuman({ signal: "user-123" });
```
</CodeGroup>

<span id="passport" />
<span id="proof-of-attributes-passport" />

## Proof of Attributes (Passport)
## Passport

Use `passport` for the current World ID 4.0 Passport credential. The preset also includes legacy Document fallback for users without a World ID 4.0 proof.

Expand Down Expand Up @@ -105,9 +107,10 @@ const preset = passport({ signal: "user-123" });
```
</CodeGroup>

<span id="selfie-check" />
<span id="proof-of-presence-selfie-check" />
<span id="proof-of-presence" />

## Proof of Presence (Selfie Check)
## Selfie Check

Use `selfieCheck()` with [session proofs](/world-id/idkit/session-proofs) to verify
users when they first arrive and when they return. Create a session once, save its
Expand Down Expand Up @@ -136,9 +139,9 @@ see the [integration guide](/world-id/idkit/integrate).

If you use `selfieCheckLegacy`, migrate to `selfieCheck` for World ID 4.0.

<span id="identity-check-preview" />
<span id="proof-of-attributes-identity-check-preview" />

## Proof of Attributes (Identity Check, Preview)
## Identity Check (Preview)

<Note>
Identity Check is currently in preview. To use it or learn more, contact us.
Expand Down
Loading