CRMJettyBack to crmjetty.comContact us
Menu
Docs / Guides

CRMJetty Portal

Works with
Docs / Dynamics 365

Dynamics 365 Customer Portalv6.3.0

Docs / Salesforce

Salesforce Customer Portalv6.3.0

Docs / Business Central

Business Central Portal

Guides / Login and security

How to Set Up Password Reset for Portal Users

6 min readUpdated
Short answerAdd the Forgot Password widget to a public page in Design → Page Builder and publish it. In the Login widget, turn on Forgot Password and select that page. Portal users then get a reset link by email. Admins can also send reset links with Send Password Link in Portal User Setup.

Portal users who forget their password can request a reset link by email and set a new password themselves. You set this up with the Forgot Password widget and a link from the login page. As an admin, you can also send reset links to portal users from the admin portal.

Before you start

How password reset works

  1. On the login page, the portal user selects the forgot password link.
  2. The portal opens the page that holds the Forgot Password widget.
  3. The portal user enters their registered email address and selects the button, for example Send Reset Password Link.
  4. The portal emails a password reset link to that address.
  5. The portal user opens the link and sets a new password.

The new password must be different from the old one.

Add the Forgot Password widget to a page

Skip this section if you use the default Forgot Password page.

  1. Go to Design → Page Builder.
  2. Select Create to create a page, or edit an existing page.
  3. In Page Access, select Public. Portal users must be able to open this page before they sign in.
  4. Choose a Page Layout and select Next.
  5. In the widget panel, select the Forgot Password widget. It is added to the grid.
  6. Select the Settings icon on the widget.
  7. Fill in the settings in the table below.
  8. Select Save.
  9. Select Publish.
Page Builder with the Forgot Password widget on the grid and its settings panel open, showing Title, Forgot Password Button Text and Enable reCAPTCHA
Page Builder with the Forgot Password widget on the grid and its settings panel open, showing Title, Forgot Password Button Text and Enable reCAPTCHA
Page Builder with the Forgot Password widget on the grid and its settings panel open, showing Title, Forgot Password Button Text and Enable reCAPTCHA
Page Builder with the Forgot Password widget on the grid and its settings panel open, showing Title, Forgot Password Button Text and Enable reCAPTCHA
Setting What to enter
Title The heading of the forgot password section, for example Forgot Password.
Forgot Password Button Text The text of the button that sends the reset link, for example Send Reset Password Link.
Enable reCAPTCHA Protects the form from spam. The reCAPTCHA version (V2 or V3) comes from your site’s reCAPTCHA settings.
HTML Class A custom class for styling or scripting the widget.
HTML ID A unique ID for the widget, usually starting with custom-.
Card View Shows the forgot password section as a card.

For more on page settings, see How to Set Public and Login-Only Portal Pages.

  1. Go to Design → Page Builder and edit the page that holds the Login widget.
  2. Select the Settings icon on the Login widget.
  3. Turn on Forgot Password.
  4. In Select Forgot Password Redirection Page, select the page with the Forgot Password widget.
  5. Select Save.
  6. Select Publish.
Login widget settings with Forgot Password turned on and a page selected in Select Forgot Password Redirection Page
Login widget settings with Forgot Password turned on and a page selected in Select Forgot Password Redirection Page
Login widget settings with Forgot Password turned on and a page selected in Select Forgot Password Redirection Page
Login widget settings with Forgot Password turned on and a page selected in Select Forgot Password Redirection Page

Tip: The Login widget has matching settings for usernames: Forgot Username and Select Forgot Username Redirection Page. Use them with the Forgot Username widget if your portal users sign in with a username.

Customize the reset email

The reset email uses the Forgot Password email action. To change its subject or text, edit the template under Settings → Portal Settings → Template Scripting → Email Templates (Business Central: Settings → Portal Settings → Email Templates). See How to Customize Portal Email Templates.

Use this when a portal user can’t reset their password themselves, or to send links to several portal users at once.

  1. Go to Settings → User Settings → Portal User Setup (Business Central: Portal User Customer or Portal User Vendor).
  2. Select the portal users who need a reset link.
  3. In the Bulk Actions menu, select Send Password Link.
  4. Review the pop-up showing the delivery status of each link.
Portal User Setup with two portal users selected and Send Password Link chosen in the Bulk Actions menu
Portal User Setup with two portal users selected and Send Password Link chosen in the Bulk Actions menu
Portal User Setup with two portal users selected and Send Password Link chosen in the Bulk Actions menu
Portal User Setup with two portal users selected and Send Password Link chosen in the Bulk Actions menu

Password rules that affect resets

These settings are in your site’s Security settings, under Settings → Portal Settings → Site Management.

Setting Effect on passwords
Custom Password Complexity Sets the password length range and the required character types: uppercase, lowercase, digits and special characters.
Password Expiration Makes portal users set a new password after a set period: Never Expire, 1 Day, 2 Days, 1 Month, 3 Months, 6 Months or 1 Year. Resetting a password through Forgot Password restarts the period.
Password Lock Locks a portal user out for a set time after too many wrong passwords.

For password lock and two-factor authentication, see How to Enable Two-Factor Authentication in the Portal.

Troubleshooting

Portal users don’t receive the reset email: Check your SMTP settings and send a test email. See How to Fix Portal Emails That Are Not Sending.

The forgot password link sends portal users to the login page: The reset page is set to Authenticate. Change its Page Access to Public and publish it again.

The forgot password link doesn’t appear on the login page: Turn on Forgot Password in the Login widget, select the redirection page, then save and publish the page.

A portal user can’t save the new password: The new password must be different from the old one and meet your password complexity rules.

Did this solve it?No, contact support