--- title: "Change Password" description: "The Change Password app adds a dedicated tab to the J2Commerce My Profile page on the frontend." url: "https://docs.j2commerce.com/v6/apps-and-extensions/apps/app_changepasswords" markdown_url: "https://docs.j2commerce.com/v6/apps-and-extensions/apps/app_changepasswords.md" last_updated: "2026-11-11T21:27:29+00:00" version: "J2Commerce 6" breadcrumbs: - title: "Home" url: "https://docs.j2commerce.com/" - title: "J2Commerce 6" url: "https://docs.j2commerce.com/v6" - title: "Apps and Extensions" url: "https://docs.j2commerce.com/v6/apps-and-extensions" - title: "Apps" url: "https://docs.j2commerce.com/v6/apps-and-extensions/apps" - title: "Change Password" url: "https://docs.j2commerce.com/v6/apps-and-extensions/apps/app_changepasswords" --- # Change Password The Change Password app adds a dedicated tab to the J2Commerce My Profile page on the frontend. Logged-in customers can update their Joomla account password without leaving the store. The form validates both fields client-side and server-side, shows inline error messages for empty or mismatched passwords, and displays a confirmation message on success. The app also provides an email tag that adds a link to the Change Password tab in your email templates. ## Requirements - PHP 8.3 or later - Joomla 6.0.0 or later - J2Commerce 6.6.6 or later --- ## Purchase and Download The **Change Password** app is a separate add-on available from the [Change Password](https://www.j2commerce.com/extensions/apps/change-password). It is not included with the core J2Commerce 6 component. **Step 1:** Go to the [J2Commerce website](https://www.j2commerce.com/extensions) -> **Apps**. **Step 2:** Locate the **Change Password** app -> click **View Details** -> **Add to cart** -> **Checkout**. **Step 3:** Go to **My Downloads** under your profile menu at the top right corner and search for the app. Click **Available Versions** -> **View Files** -> **Download**. --- ## Install the App Install the app with the Joomla installer. 1. In the Joomla admin, go to **System** -> **Install** -> **Extensions**. 2. Upload the plugin ZIP file or use the Install from URL option. ![Install extensions](https://docs.j2commerce.com/images/docs/v4/assets/app%20install1%20%281%29%20%281%29.webp) --- ## Enable the App After installing, enable the app. You can open the Apps list in two ways. **Option A:** Click the **J2Commerce** icon at the top right corner -> **Apps**. **Option B:** Go to **Components** in the left sidebar -> **J2Commerce** -> **Apps**. ![shipping method](https://docs.j2commerce.com/images/docs/shared/accordions-app.webp) Find **Change Password** and click the **X**. It turns into a green checkmark when the app is enabled. ![Joomla Apps list searched for change, with the Change Password status icon highlighted as a green checkmark and Apps highlighted in the sidebar](https://docs.j2commerce.com/images/docs/shared/password-enable.webp) --- ## Configure the App Click the **Change Password** title to open the plugin configuration screen. ![Change Password app settings with the Display Quick Icon switch highlighted as Yes and the Quick Icon Title field below it](https://docs.j2commerce.com/images/docs/shared/password-settings.webp) ### Basic Tab | Setting | What It Does | Default | Options | | --- | --- | --- | --- | | Display Quick Icon | Shows a quick icon for this app on the J2Commerce dashboard. Needs the J2Commerce Quick Icon plugin installed and enabled. | No | Yes, No | | Quick Icon Title | The label on the quick icon. Shown only when **Display Quick Icon** is Yes. | J2Commerce Change Password | Text | | Layout | The frontend framework used for the Change Password tab. Default follows the layout selected in the J2Commerce configuration. | Default | Layouts offered by your J2Commerce installation | ### Email Instructions Tab These settings control the `[CHANGE_PASSWORD_INSTRUCTIONS]` tag. Place the tag in an email template to add a block with a button that links to the My Profile page. | Setting | What It Does | Default | Options | | --- | --- | --- | --- | | Add Instructions to Emails | Shows the change-password instructions wherever the tag is placed. When set to No, the tag stays blank. | Yes | Yes, No | | My Profile Page | The My Profile menu item the email button links to. Only published J2Commerce My Profile menu items are listed. | None selected | Published My Profile menu items | | Instructions Text | Optional. Replaces the default sentence above the button: "To choose your own password, sign in and open the Change Password tab in My Profile." | Empty | Editor text | **My Profile Page** and **Instructions Text** appear only when **Add Instructions to Emails** is Yes. The email button reads "Open My Profile to Change Your Password". > **Warning:** If no My Profile page is selected, or the selected menu item is unpublished or deleted, emails do not include the instructions. The tab shows a warning in that case. Create a published My Profile menu item and select it. After adjusting settings, click **Save** or **Save & Close**. --- ## How It Works When a logged-in customer visits their **My Account** page on the frontend, a **Change Password** tab appears in the profile navigation alongside any other profile tabs. Clicking the tab shows a form with two fields: - **New Password**: the customer's desired new password - **Confirm Password**: must match the New Password field exactly ![Frontend My Account page with the Change Password tab highlighted, showing New Password and Confirm Password fields and a Change Password button](https://docs.j2commerce.com/images/docs/shared/password-reset.webp) When the customer clicks **Change Password**: 1. The button shows a loading spinner while the request processes. 2. If both fields pass validation, the password is updated immediately. 3. A green success message appears: "Password Updated Successfully." 4. The form clears so the fields are ready for another change. Inline error messages appear directly below the relevant field. --- ## Validation and Error Messages | Situation | Message Shown | | --- | --- | | New Password field left empty | "New Password Required" | | Confirm Password field left empty | "Confirm Password Required" | | Passwords do not match | "Password Field Mismatch" | | Server-side save error | "New Password Save Problem" | | Success | "Password Updated Successfully" | --- ## Tips - The tab only appears for logged-in users. Guest visitors do not see it. - The app uses your Joomla site's password strength and minimum length requirements. - With **Display Quick Icon** on, the icon links to the plugin configuration page from the J2Commerce dashboard. - Child templates pick up layout overrides for this app from their parent template. --- ## Troubleshooting ### The Change Password Tab Does Not Appear on the My Profile Page **Cause:** The plugin is not enabled, or the customer is not logged in. **Solution:** - Go to **J2Commerce** -> **Apps** and verify **Change Password** has a green checkmark. - Confirm the customer is logged into a Joomla user account on the frontend. - Go to **System** -> **Manage** -> **Extensions**, search for **Change Password**, and verify the plugin status is **Enabled**. ![Joomla Extensions: Manage searched for change, with the Change Password site plugin status icon highlighted as enabled and System in the sidebar highlighted](https://docs.j2commerce.com/images/docs/shared/password-manage.webp) ### Password Change Fails with a Generic Error **Cause:** A server-side error occurred during the save, such as a session timeout or a Joomla security token mismatch. **Solution:** - Ask the customer to refresh the My Profile page to get a fresh session token. - Try the password change again. - If the error persists, check **System** -> **System Information** -> **PHP Error Log** for details. ![Joomla System Dashboard with System in the sidebar and the System Information link highlighted under Information](https://docs.j2commerce.com/images/docs/shared/password-php.webp) ### Quick Icon Does Not Appear on the Dashboard **Cause:** The J2Commerce Quick Icon plugin is not installed or not enabled, or **Display Quick Icon** is set to **No**. **Solution:** - Go to **J2Commerce** -> **Apps** and confirm the **Change Password** plugin is enabled. - Click **Change Password** to open its configuration. - Set **Display Quick Icon** to **Yes**. - Verify a label is entered in the **Quick Icon Title** field. - Go to **System** -> **Manage** -> **Extensions**, search for **J2Commerce Quick Icons**, and confirm it is enabled. ![Joomla Extensions: Manage searched for J2Commerce Quick Icons, with System in the sidebar and the module status icon highlighted as enabled](https://docs.j2commerce.com/images/docs/shared/password-extension.webp) - Click **Save** in the Change Password configuration and reload the J2Commerce dashboard. ### Email Does Not Show the Change Password Instructions **Cause:** The tag is missing from the template, **Add Instructions to Emails** is No, or no published My Profile page is selected. **Solution:** - Add `[CHANGE_PASSWORD_INSTRUCTIONS]` to the email template. - Open the **Email Instructions** tab and set **Add Instructions to Emails** to **Yes**. - Select a published J2Commerce My Profile menu item in **My Profile Page**.