Skip to content

docs: document WebAuthn conditional create#44643

Open
StealthEyeLLC wants to merge 1 commit into
mdn:mainfrom
StealthEyeLLC:docs-webauthn-conditional-create
Open

docs: document WebAuthn conditional create#44643
StealthEyeLLC wants to merge 1 commit into
mdn:mainfrom
StealthEyeLLC:docs-webauthn-conditional-create

Conversation

@StealthEyeLLC

Copy link
Copy Markdown

Description

Adds documentation for WebAuthn conditional create / automatic passkey creation.

Changes:

  • Documents the mediation option on CredentialsContainer.create() and explains mediation: "conditional" for public key credential creation.
  • Adds a create() example showing feature detection with PublicKeyCredential.getClientCapabilities() and a conditional passkey creation request.
  • Adds an Automatic passkey creation section to the Web Authentication API overview.
  • Clarifies that the conditionalCreate client capability refers to automatic passkey creation, not just creating discoverable credentials.

Motivation

Conditional create lets sites request passkey creation after a successful password sign-in, helping users adopt passkeys without needing to explicitly find and click a separate “create passkey” control.

Fixes #42516.

Additional details

Validated with:

  • git diff --check
  • markdownlint-cli2 on the changed files using Node 22.23.1
  • prettier -c on the changed files using Node 22.23.1

@StealthEyeLLC StealthEyeLLC requested a review from a team as a code owner July 4, 2026 22:23
@StealthEyeLLC StealthEyeLLC requested review from pepelsbey and removed request for a team July 4, 2026 22:23
@github-actions github-actions Bot added Content:WebAPI Web API docs size/m [PR only] 51-500 LoC changed labels Jul 4, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Content:WebAPI Web API docs size/m [PR only] 51-500 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

WebAuthn conditional create is not documented

2 participants