---
title: Configure Password Reset Instructions
slug: configure-password-reset-instructions
createdAt: 2026-03-09T20:46:22.741Z
---



When a user resets their password, Activate displays guidance explaining the password requirements that must be met before the new password will be accepted. These instructions are intended to reflect the password policy configured for the organisation.&#x20;

### Default instruction text

By default, the password reset screen shows the following guidance:

- Your password must be at least **X** characters long.&#x20;
- Your password should not be easy to guess.&#x20;
- Use characters from at least **3** of the following categories:&#x20;
  - Uppercase letters, for example **A–Z**&#x20;
  - Lowercase letters, for example **a–z**&#x20;
  - Numbers, for example **0–9**&#x20;
  - Symbols, for example **! @ # $**&#x20;

In this text, **X** is derived from the Active Directory environment.

### How Activate determines which instruction text to show

Activate resolves the password instruction text in the following order:

1. **User rules override**
   &#x20;Activate first checks for instructions defined in the user rules, using the **PasswordResetQuestions** parameter under **Tasks > Passwords**.&#x20;
2. **Localised resource string**
   &#x20;If no user rule instructions are defined, Activate then checks the **passwords/instructions** string in the **en** language resource.&#x20;
3. **Hard-coded fallback**
   &#x20;If neither of the above is available, Activate falls back to the built-in default instruction text.&#x20;

This means administrators can override the text without changing code, but if no configured value exists, users will still see the default guidance.

### Where the minimum length comes from

The minimum password length shown to the user is based on the password reset information read from Active Directory. In practice, Activate reads the minimum password length from the domain password settings and uses that value when building the default instruction text. Based on the controller behaviour you provided, this is sourced from the password reset information available for the current user context.

### Suggested note for admins

If a customer reports that the password reset instructions are incorrect, first confirm whether:

- the instruction text has been overridden in **Tasks > Passwords**&#x20;
- a localised **passwords/instructions** value is present&#x20;
- the environment uses fine-grained password policies that differ from the default domain policy

