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

# Password Policy

> Configure password change reminders across child sites, track last password changes, and manage per-site overrides from your MainWP Dashboard.

Password Policy in MainWP Dashboard v6 helps you monitor password freshness across connected sites and optionally show reminder notices before passwords become overdue.

## What You'll Learn

* Configure global password policy settings
* Understand how policy settings sync to child sites
* Override policy settings for a single site
* Read Last Password Change and Password Status in Manage Users
* Control which users see Due Soon and Overdue notices

## Prerequisites

* MainWP Dashboard v6 or newer
* MainWP Child v6 or newer on your connected child sites
* Administrator access to your MainWP Dashboard

***

Watch the Password Policy chapter for an overview of the settings, reminder timing, and a notice example.

[MainWP Password Policy Walkthrough](https://www.youtube.com/embed/vfZFneUTtJw?start=212)

## Configure Global Password Policy

**1. Open Password Policy settings**

Go to **MainWP > Users > Password Policy**.

![Password Policy settings page in MainWP Dashboard](https://mintcdn.com/mainwp/qaL8h7bXendg5j-3/images/sites/password-policy-page.png?fit=max\&auto=format\&n=qaL8h7bXendg5j-3\&q=85\&s=8e077d8dd455826e62dd0b5f047ce468)

**2. Set your policy options**

Choose your password policy period, customize reminder messages, and select who should receive notices.

**3. Save settings**

Click **Save Settings** to store global settings and push updates to eligible child sites.

### Global options

| Setting | Details |
| - | - |
| Require password change every | `Never`, `30`, `60`, `90`, `120`, `180`, or `360` days |
| "Due soon" reminder message | Custom message shown in warning state |
| "Overdue" reminder message | Custom message shown after the policy deadline passes |
| Show notices to | `Users with wp-admin access (edit_posts and above)` or `All users (all roles)` |

> [!NOTE]
>
> In the current UI, the Due Soon warning window is 7 days before the due date.

***

## How Settings Sync

When you save global Password Policy settings:

* MainWP pushes settings to connected child sites
* Sites with sync errors or suspended status are skipped
* Sites with **Overwrite global settings for this site** enabled are skipped

Password Policy settings are also included in normal site sync requests. This means newly added sites receive policy settings on their next sync.

***

## Per-Site Override

**1. Open a site-specific Password Policy page**

Go to **MainWP > Sites > Manage Sites**, open a site, then select **Password Policy**.

**2. Enable override**

Enable **Overwrite global settings for this site**.

**3. Save site-specific settings**

Set the same policy options for that site and click **Save Settings**.

If override is enabled, the site uses its own policy settings and is excluded from global Password Policy update pushes.

***

## What MainWP Tracks

MainWP Child tracks password changes in user meta (`mainwp_last_password_change`) whenever WordPress records a password update event.

Supported flows include:

* Lost password reset flow
* Password changes in WordPress profile screens
* Programmatic or front-end password updates that use WordPress user update hooks
* Password updates initiated from MainWP Dashboard user actions

> [!NOTE]
>
> WordPress does not provide a reliable historical "last password change" value by default. Tracking starts after MainWP Child is updated to a version that includes this feature.

***

## Password Status in Manage Users

Go to [MainWP > Users > Manage Users](https://docs.mainwp.com/sites/users/manage-users.md) to see:

* **Last Password Change**
* **Password Status**

Status labels:

* **Fresh**: Password is within policy window
* **Due Soon**: Password is in the warning window
* **Overdue**: Password is past due
* **Disabled**: Policy period is set to Never
* **Unknown**: No password change has been recorded yet

When no password change is recorded, policy timing is measured from when policy was enabled on that child site.

***

## Notice Behavior

Password Policy in MainWP v6 is reminder-based:

* Shows warning/critical notices for Due Soon and Overdue users
* Does not force password reset
* Does not block login
* Does not lock user accounts

Audience behavior:

* `Users with wp-admin access`: notices are shown in wp-admin to users who can `edit_posts`
* `All users`: low-level users can also see notices on the front end when logged in

Front-end notice display can be affected by theme output, caching layers, and custom account/login flows.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.