A Credential is a statement an issuer makes about a World ID holder. In IDKit, the credential you request determines what the user proves to your app.

What you can request with IDKit

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`
Passport	The user holds a verified NFC passport credential.	`passport`
Selfie Check	A low-assurance biometric credential using the device camera for liveness and facial similarity.	`selfieCheckLegacy`
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.

If you have an existing legacy integration, see the World ID 4.0 migration guide.

SDK presets

Preset helpers cover common credential requests: proofOfHuman, passport, selfieCheckLegacy, identityCheck, and the legacy presets. The snippets below assume rp_context was already generated and signed by your backend. See Integrate IDKit for the full RP-signing flow.

Proof of Human

Use proofOfHuman for the current World ID 4.0 Proof of Human credential. The preset also includes legacy Orb fallback for users without a World ID 4.0 proof.

import { IDKit, proofOfHuman } from "@worldcoin/idkit-core";

const preset = proofOfHuman({ signal: "user-123" });

const request = await IDKit.request({
  app_id: "app_xxxxx",
  action: "my-action",
  rp_context,
  allow_legacy_proofs: true,
}).preset(preset);

import { IDKitRequestWidget, proofOfHuman } from "@worldcoin/idkit";

const preset = proofOfHuman({ signal: "user-123" });

<IDKitRequestWidget
  open={open}
  onOpenChange={setOpen}
  app_id="app_xxxxx"
  action="my-action"
  rp_context={rpContext}
  allow_legacy_proofs={true}
  preset={preset}
  handleVerify={handleVerify}
  onSuccess={(result) => { /* ... */ }}
/>;

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.

import { IDKit, passport } from "@worldcoin/idkit-core";

const preset = passport({ signal: "user-123" });

const request = await IDKit.request({
  app_id: "app_xxxxx",
  action: "my-action",
  rp_context,
  allow_legacy_proofs: true,
}).preset(preset);

import { IDKitRequestWidget, passport } from "@worldcoin/idkit";

const preset = passport({ signal: "user-123" });

<IDKitRequestWidget
  open={open}
  onOpenChange={setOpen}
  app_id="app_xxxxx"
  action="my-action"
  rp_context={rpContext}
  allow_legacy_proofs={true}
  preset={preset}
  handleVerify={handleVerify}
  onSuccess={(result) => { /* ... */ }}
/>;

Selfie Check

Use the selfieCheckLegacy preset to request Selfie Check. Anyone with World App can complete the flow: no Orb, passport, document, or other prerequisite credential is required. To test your integration end-to-end, see Testing Selfie Check in Sandbox.

“Legacy” refers to the proof protocol, not the Selfie Check product. This preset returns World ID 3.0 proofs and requires allow_legacy_proofs=true. Selfie Check with World ID 4.0 is not available yet.

IDKit returns identifier: "selfie" for Selfie Check. Legacy integrations may still use face; verification services accept it as a backward-compatible alias. Applications should not translate the identifier or construct a verification_level. Forward the complete IDKit result to the verification endpoint.

import { IDKit, selfieCheckLegacy } from "@worldcoin/idkit-core";

const preset = selfieCheckLegacy({ signal: "user-123" });

const request = await IDKit.request({
  app_id: "app_xxxxx",
  action: "my-action",
  rp_context,
  allow_legacy_proofs: true,
}).preset(preset);

import { IDKitRequestWidget, selfieCheckLegacy } from "@worldcoin/idkit";

const preset = selfieCheckLegacy({ signal: "user-123" });

<IDKitRequestWidget
  open={open}
  onOpenChange={setOpen}
  app_id="app_xxxxx"
  action="my-action"
  rp_context={rpContext}
  allow_legacy_proofs={true}
  preset={preset}
  handleVerify={handleVerify}
  onSuccess={(result) => { /* ... */ }}
/>;

Identity Check (Preview)

Identity Check is currently in preview. To use it or learn more, contact us.

Identity Check lets your app ask the user to attest that document-backed attributes match your policy, without handling the underlying document data. Use it for eligibility checks such as minimum age, document type, issuing country, or nationality. Request attributes such as:

Attribute	Value type
`document_type`	`"passport"`, `"eid"` or `"mnc"`
`document_number`	`string`
`issuing_country`	ISO 3166-1 alpha-3 country code
`full_name`	`string`
`minimum_age`	`number`
`nationality`	ISO 3166-1 alpha-3 country code

import { IDKit, identityCheck } from "@worldcoin/idkit-core";

const preset = identityCheck({
  attributes: [
    { type: "document_type", value: "passport" },
    { type: "minimum_age", value: 18 },
  ],
});

const request = await IDKit.request({
  app_id: "app_xxxxx",
  action: "my-action",
  rp_context,
  allow_legacy_proofs: false,
}).preset(preset);

import { IDKitRequestWidget, identityCheck } from "@worldcoin/idkit";

const preset = identityCheck({
  attributes: [
    { type: "document_type", value: "passport" },
    { type: "minimum_age", value: 18 },
  ],
});

<IDKitRequestWidget
  open={open}
  onOpenChange={setOpen}
  app_id="app_xxxxx"
  action="my-action"
  rp_context={rpContext}
  allow_legacy_proofs={false}
  preset={preset}
  handleVerify={handleVerify}
  onSuccess={(result) => { /* ... */ }}
/>;

Successful Identity Check responses include identity_attested so your backend can tell whether the requested attributes matched.

User presence and liveness

To check for user presence and liveness, add the require_user_presence flag to your request. This is a request-level flag, not a credential; it asks World ID for a fresh liveness check before returning the proof and fails with user_presence_failed if the check does not complete. Depending on the credential requested, World ID matches the user’s live selfie to the credential image, such as the passport photo or the image captured during Orb verification.

import { IDKit, proofOfHuman } from "@worldcoin/idkit-core";

const preset = proofOfHuman({ signal: "user-123" });

const request = await IDKit.request({
  app_id: "app_xxxxx",
  action: "my-action",
  rp_context,
  allow_legacy_proofs: true,
  require_user_presence: true,
}).preset(preset);

import { IDKitRequestWidget, proofOfHuman } from "@worldcoin/idkit";

const preset = proofOfHuman({ signal: "user-123" });

<IDKitRequestWidget
  open={open}
  onOpenChange={setOpen}
  app_id="app_xxxxx"
  action="my-action"
  rp_context={rpContext}
  allow_legacy_proofs={true}
  require_user_presence={true}
  preset={preset}
  handleVerify={handleVerify}
  onSuccess={(result) => { /* ... */ }}
/>;

Other legacy presets

These presets only return World ID 3.0 proofs. Use them for existing integrations or when you need the older verification level.

Preset	What it requests
`orbLegacy`	Orb verification.
`secureDocumentLegacy`	At least a Secure Document verification. Returns the user’s highest legacy credential: Secure Document or Orb.
`documentLegacy`	At least a Document verification. Returns the user’s highest legacy credential: Document, Secure Document, or Orb.
`deviceLegacy`	At least a Device verification. Returns the user’s highest legacy credential: Device, Document, Secure Document, or Orb.

Common parameters

Parameter	Where it is used	Description
`signal`	Presets	Binds app context into the proof, such as a user ID or wallet address. Your backend should enforce the same value.
`allow_legacy_proofs`	Request config and widgets	Required for request flows. Set to `true` while accepting World ID 3.0 fallback proofs; set to `false` for World ID 4.0-only requests.
`require_user_presence`	Request config and widgets	Optional liveness step. Defaults to `false`.

Overview

IDKit

Sandbox

Credentials

Migration

Technical Reference

Configure Credentials

What you can request with IDKit

SDK presets

Proof of Human

Passport

Selfie Check

Identity Check (Preview)

User presence and liveness

Other legacy presets

Common parameters

​What you can request with IDKit

​SDK presets

​Proof of Human

​Passport

​Selfie Check

​Identity Check (Preview)

​User presence and liveness

​Other legacy presets

​Common parameters

What you can request with IDKit

SDK presets

Proof of Human

Passport

Selfie Check

Identity Check (Preview)

User presence and liveness

Other legacy presets

Common parameters