Skip to main content

General settings

Overview​

General settings control page assignments, form text, email templates, and redirect behavior. These settings determine where users are sent during the password reset flow and what text they see at each stage.

Access general settings at Settings > Frontend Reset Password > General tab.

Page assignments​

Reset Password Page (required)​

Setting: Reset Password Page

Purpose: The page containing the [reset_password] shortcode where users complete password resets.

Configuration:

  1. Create a page with the [reset_password] shortcode
  2. Select that page from the dropdown
  3. Save changes

Default: None (must be configured)

warning

This setting is required. Without it, WordPress will continue using wp-login.php for password resets instead of your custom page.

Login Page​

Setting: Custom Login Page

Purpose: The page where users log in after successfully resetting their password.

Configuration: Select your custom login page from the dropdown

Default: WordPress default login page (wp-login.php)

Use cases:

  • Membership sites with custom login pages
  • E-commerce sites using WooCommerce My Account
  • Sites using custom authentication plugins

Request Success Page​

Setting: Reset Email Sent Page

Purpose: Optional redirect after user requests a password reset (Stage 1 completion).

Configuration: Select a page to redirect to after email is sent

Default: None (stays on reset password page with success message)

Use case: Redirect to a custom "Check Your Email" page with additional instructions

Reset Success Page​

Setting: New Password Saved Page

Purpose: Optional redirect after user successfully changes their password (Stage 3).

Configuration: Select a page to redirect to after password is changed

Default: None (displays success message on reset password page)

Use case: Redirect to account dashboard or welcome page after password change

Form text customization​

Form Title​

Setting: Form Title

Purpose: Heading displayed at the top of password reset forms.

Default: "Reset Password"

Example: "Forgot Your Password?" or "Password Recovery"

Appears on: Both Stage 1 (request) and Stage 2 (reset) forms

Lost Password Message​

Setting: Lost Password Form Text

Purpose: Instruction text shown on the initial password reset request form (Stage 1).

Default: "Please enter your username or email address. You will receive a link to create a new password via email."

Example: "Enter your email address and we'll send you a link to reset your password."

Appears on: Stage 1 (request form) only

Reset Password Message​

Setting: New Password Form Text

Purpose: Instruction text shown on the new password entry form (Stage 2).

Default: "Enter your new password below."

Example: "Choose a strong password for your account."

Appears on: Stage 2 (reset form) only

Button Text​

Setting: Button Text

Purpose: Label for the submit button on password reset forms.

Default: "Reset Password"

Example: "Send Reset Link" (Stage 1) or "Update Password" (Stage 2)

Appears on: Both Stage 1 and Stage 2 forms

note

The same button text is used on both forms. If you want different text for each stage, you'll need to create template overrides.

Email customization​

Email Subject​

Setting: Email Subject

Purpose: Subject line for password reset emails.

Default: "Account Password Reset"

Example: "[Your Site Name] Password Reset Request"

Filter available: somfrp_retrieve_password_title for programmatic customization

Email Message​

Setting: Email Message

Purpose: Body content for password reset emails.

Default: WordPress default reset email template

Template variables:

  • {username} - User's login name
  • {reset_link} - Password reset URL
  • {email} - User's email address

Example:

Hello {username},

Someone requested a password reset for your account at Our Site.

If this was you, click the link below to reset your password:
{reset_link}

If you didn't request this, you can safely ignore this email.

Thanks,
The Our Site Team

Filter available: somfrp_retrieve_password_message for programmatic customization

tip

Use HTML in the email message for better formatting. The plugin sends HTML emails by default.

From Name​

Setting: Email Sender Name

Purpose: Sender name displayed in password reset emails.

Default: WordPress site name

Example: "Support Team" or "Your Site Name"

Email header: From: [From Name] <[From Email]>

From Email Address​

Setting: Email Sender Address

Purpose: Sender email address for password reset emails.

Default: WordPress admin email

Example: "[email protected]" or "[email protected]"

Email header: From: [From Name] <[From Email]>

warning

Ensure the from email address is authorized to send from your domain to avoid emails being marked as spam. Configure SPF and DKIM records for your domain.

Reset Link Text​

Setting: Reset Link Text

Purpose: Custom text for the reset link in emails instead of showing the full URL.

Default: Empty (shows full URL)

Example: "Click here to reset your password" or "Reset My Password"

Behavior:

  • If empty: Email shows full reset URL
  • If set: Email shows custom text as clickable link

Notice Background Color​

Setting: Notice Background Color

Purpose: Background color for success and error messages.

Default: Empty (uses plugin default styling)

Format: Hex color code (e.g., #0073aa)

Use case: Match message styling to your theme's color scheme

Settings validation​

The plugin validates general settings before saving:

Page selections: Verifies selected pages exist and are published

Email addresses: Checks from email address is properly formatted

Required fields: Ensures Reset Password Page is selected

If validation fails, settings are not saved and an error message is displayed.

Common configurations​

Membership site​

Reset Password Page: /reset-password/
Login Page: /login/
Form Title: "Recover Your Account"
Email Subject: "[Site Name] Password Recovery"
From Name: "Support Team"

E-commerce site (WooCommerce)​

Reset Password Page: /my-account/lost-password/
Login Page: /my-account/
Reset Success Page: /my-account/
Email Subject: "Reset Your [Store Name] Password"
From Name: "[Store Name] Support"

Simple blog​

Reset Password Page: /forgot-password/
Login Page: (default wp-login.php)
Form Title: "Reset Password"
Email customization: (use defaults)

Troubleshooting​

Problem: Email link redirects to WordPress default login instead of custom page.

Solution: Verify Reset Password Page is selected and saved. Clear all caches.

Emails not arriving​

Problem: Users don't receive password reset emails.

Solution: See Email not sending troubleshooting for detailed solutions.

Custom email text not appearing​

Problem: Email still shows default WordPress text despite custom settings.

Solution: Ensure you clicked Save Changes. Check if another plugin is filtering the email content.

Page dropdown is empty​

Problem: Can't select pages in dropdown menus.

Solution: Create and publish pages first. Ensure you have admin permissions.

What's next​