Skip to Content
Account
Enter the email address on your account.
Forgot Your Username?
Enter your password.
Forgot Your Password?

Or continue with

J2Commerce 6

Email Basket

6 Min Read

Documentation current for Email Basket v6.0.3. Last checked November 12, 2026.

On This Page

The Email Basket app adds a button next to the checkout button on the cart page. The button opens a modal form. After the customer clicks Send, the cart contents are emailed to the store, to the customer, or to both.

Use it for B2B stores that take quote requests, or for any store where customers want a record of their cart before checkout.

Requirements

  • J2Commerce 6.6.4 or later.
  • Joomla 6.0.0 or later.

Info

Email Basket is a separate add-on from the J2Commerce Extensions Store. It is not part of the core J2Commerce 6 component.


Installation

  1. Download the app_emailbasket.zip package.
  2. Go to System -> Install -> Extensions.
  3. Upload the package file.
  4. Go to J2Commerce -> Apps and click Email Basket.
  5. Make sure the plugin is enabled, then click Save.

The button now appears after the checkout button on the cart page. It also appears wherever else J2Commerce shows a checkout button, such as the cart module. The modal is added to the page once, even when several buttons are shown.


Settings

Tip

Click Toggle Inline Help in the toolbar to show a description under each field.

Basic Settings

SettingWhat It DoesDefaultOptions
Button TextThe label on the cart page button.Email This CartFree text
Button IconFont Awesome classes for the icon on the button.fa-solid fa-paper-planeFree text
Disable Checkout ButtonHides the checkout button on the cart page, the cart module and the cart drawer, so emailing the cart is the only way forward. The Email Basket button then becomes the primary button.NoYes, No
Require Terms AcceptanceShows a required Terms & Conditions checkbox on the form.NoYes, No
CaptchaThe Joomla captcha plugin used on the form. Automatic uses the first enabled captcha plugin, if any.AutomaticAutomatic, Disabled, or any enabled captcha plugin
Empty Cart After SendingRemoves every item from the cart after the email is sent.NoYes, No
Redirect After SendingSends the customer to another page after the email is sent.NoYes, No
Redirect URLWhere to send the customer. Shown only when Redirect After Sending is Yes. Leave blank to go to the store home page.EmptyFull URL, root-relative path or Joomla route
Debug LoggingWrites diagnostic messages to logs/j2commerce_app_emailbasket.php. Turn off in production.NoYes, No

The Basic tab also has a Subtemplate selector for choosing the layout set used for the button and form. Bootstrap 5 and UIkit layouts are included.

Email Settings

SettingWhat It DoesDefaultOptions
Additional Admin EmailsExtra addresses to notify, besides the admin emails set in J2Commerce.EmptyComma-separated email addresses
Embed Product ImagesAttaches product thumbnails to the email instead of linking to them. Helps when a mail client blocks remote images, but makes the message larger. Images not stored locally, such as CDN images, are still linked.NoYes, No
Link to Product PagesMakes each item name and thumbnail in the email a link to its product page.NoYes, No
Import Email TemplatesCreates the bundled customer and admin templates as editable rows in the Email Templates manager. Importing again overwrites wording already saved there.NoneButton

Form Fields Settings

SettingWhat It DoesDefaultOptions
Form SectionsRepeatable rows that define named sections to group fields under on the form. Each row has a Section Name and an optional Icon (Font Awesome class). A field not assigned to a section appears above all sections.NoneAny number of rows

Form Builder

The fields on the form come from the J2Commerce Custom Fields manager. Open the Form Builder button on the plugin settings toolbar to manage them.

  • Drag rows, or sort by column, to set the field order.
  • Set Required, Width Class and Section for each field.
  • Click Add Recommended Fields to enable the standard fields that were never configured for this form.
  • Click View Custom Fields to add or remove a field. Each custom field has an Email Basket switch on its Display Settings tab.

First name, last name and email are enabled on first use. Email is always shown and always required, because the cart is sent to that address. Other enabled fields appear in the email automatically.


Email Content

The customer and admin emails are edited in the J2Commerce Email Templates manager, under the Email Basket email type. Until you create a row, a bundled default is used. Use Import Email Templates to get editable copies.

To stop sending one of the two copies, disable its row in the Email Templates manager. There is no separate setting in the plugin.

The admin email goes to the store admin addresses plus Additional Admin Emails. The customer is set as reply-to on it. The customer email replies to the store admin addresses.

TagInserts
[FIRST_NAME], [LAST_NAME]Customer name
[EMAIL], [PHONE_1], [COMPANY]Customer contact details
[ADDRESS_1], [ADDRESS_2], [CITY], [ZIP], [COUNTRY], [STATE]Customer address
[MESSAGE]Customer message
[EXTRA_FIELDS]Any other enabled field
[CART_ITEMS], [CART_TOTALS]Cart item rows and total rows
[CART_URL]Link back to the cart
[ITEM_COUNT]Number of items in the cart
[SITENAME]Site name

Common Setups

Quote-Request-Only Store

  1. Set Disable Checkout Button to Yes.
  2. Set Empty Cart After Sending to Yes.
  3. Set Redirect After Sending to Yes and enter the URL of a thank-you page.
  4. Click Save.

Warning

With the checkout button hidden, customers cannot buy directly from the cart.

Spam Protection

  1. Enable a Joomla captcha plugin under System -> Plugins.
  2. In the Email Basket settings, set Captcha to that plugin, or leave it on Automatic.
  3. Click Save.

Troubleshooting

The button does not appear

  1. Go to J2Commerce -> Apps and check that Email Basket is enabled.
  2. Add an item to the cart and reload the cart page.
  3. If the button shows but does nothing, check that your template loads Bootstrap 5, or use the UIkit subtemplate.

The email is not received

  1. Check the Joomla mail settings under System -> Global Configuration -> Server.
  2. Check that the template row for that copy is enabled in the Email Templates manager.
  3. Check the recipient's spam folder.
  4. Set Debug Logging to Yes, send again, and read logs/j2commerce_app_emailbasket.php.

The captcha fails

The message "The captcha could not be verified. Please try again." means the captcha plugin rejected the answer. Check the keys and the registered domain in that captcha plugin.

The form shows too few fields

Open the Form Builder and click Add Recommended Fields, or enable the Email Basket switch on the field in the Custom Fields manager.


Uninstalling

  1. Go to System -> Manage -> Extensions.
  2. Search for Email Basket.
  3. Select it and click Uninstall.

Related Products

Related Products

Still stuck? Our team can help.

Back to Top