> ## Documentation Index
> Fetch the complete documentation index at: https://auth0.generaltranslation.app/llms.txt
> Use this file to discover all available pages before exploring further.

# usePasswordValidation

<ParamField body="usePasswordValidation(password, options?)" type={<span><a href="/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/PasswordValidationResult">PasswordValidationResult</a></span>}>
  This React hook validates a password against the current Auth0 password policy
  and returns a structured result describing whether the password satisfies each rule.

  Optionally, it can send the validation results to the global error manager so that
  form error components can update automatically.

  ## Parameters

  <ParamField body="password" type="string">
    The password to validate.
  </ParamField>

  <ParamField body="options?" />

  <ParamField body="includeInErrors?" type="boolean">
    If `true`, validation errors are stored in the global error manager under the `password` field. Defaults to `false`.
  </ParamField>

  ## Returns

  [`PasswordValidationResult`](/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/PasswordValidationResult)

  A [PasswordValidationResult](/docs/libraries/acul/react-sdk/API-Reference/Types/interfaces/PasswordValidationResult) object containing:

  * `isValid` — `true` if the password satisfies all configured rules.
  * `results` — an array of per-rule results with `code`, `label`, `status`, and `isValid`.

  ## Supported Screens

  * `signup`
  * `signup-password`
  * `reset-password`

  ```tsx Example theme={null}
     import { usePasswordValidation } from '@auth0/auth0-acul-react/signup';
     const { isValid, results} = usePasswordValidation(password, { includeInErrors: true });

     if (!isValid) {
       console.log(results);
     }
  ```
</ParamField>