Forgot Password Form

The form

Here’s a basic forgot password form. A user will enter their username, and an email will be sent to the corresponding email address. Since we don’t set a redirect parameter, the user will come right back here after submitting, where the email_sent condition will kick in and they will be shown a success message.

{{ user:forgot_password_form reset_url="/reset-password" }}

    {{ if email_sent }}

        <p>Email sent!</p>

    {{ else }}

        {{ if errors }}
            <div class="alert alert-danger">
                {{ errors }}
                    {{ value }}<br>
                {{ /errors }}
            </div>
        {{ /if }}

        <label>Username</label>
        <input type="text" name="username" />

        <button>Send email</button>

    {{ /if }}

{{ /user:forgot_password_form }}

The email that they receive will contain a link to the URL specified in the reset_url parameter along with some extra query parameters. On that page, you should add a user:reset_password_form tag, so they can reset their password.

The email

Once the form is submitted, an email will be sent containing the URL for resetting the password.

This email is bundled with Statamic and will work for most people out of the box. However, if you’d like to customize it, you can. Find out how to write custom emails. The template used is user-reset and should contain a {{ reset_url }} variable, which is the generated reset URL.

Parameters

Variables