# React Password Strength Component API

> Explore the API reference for the React Password Strength component and discover how to effectively utilize its props for customization.

## CPasswordStrength

```jsx
import { CPasswordStrength } from '@coreui/react-pro'
```

### Props

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `busyLabel` | `string` | `Checking…` | Text announced while an asynchronous scorer is pending. |
| `className` | `string` | - | A string of all className you want applied to the component. |
| `debounce` | `number` | `200` | Milliseconds to wait after the last change before evaluating. |
| `levels` | `string[]` | `['Very weak', 'Weak', 'Fair', 'Good', 'Strong']` | Labels for the strength levels, weakest first. The meter renders one segment fewer than there are levels, and a score above the last label is clamped to it. |
| `minLength` | `number` | `8` | Minimum length the built-in scorer awards points for. |
| `onStrengthChange` | `((score: number \| null, level: string \| null) => void)` | - | Callback fired when the computed score changes. The password is masked. |
| `scorer` | `((password: string, userInputs: string[]) => StrengthResult \| Promise<StrengthResult>)` | - | Custom scorer - return a score (or `{ score, warning, suggestions }`), or a promise resolving to one. |
| `thresholds` | `number[]` | `[2, 4, 6]` | Point thresholds between the built-in scorer's levels. A threshold left out keeps its default. |
| `userInputs` | `string[] \| (() => string[])` | `[]` | Words the password must not contain - the user's name, e-mail, the site name. Pass a function to read them lazily. |
| `value` | `string` | - | The password to evaluate. |
| `weights` | `Record<string, number>` | `{ minLength: 1, extraLength: 1, longPassword: 1, lowercase: 1, uppercase: 1, numbers: 1, special: 1, multipleSpecial: 1, }` | Points the built-in scorer awards per fulfilled rule. A rule left out keeps its default, so the object is a set of overrides rather than a replacement. |