WooCommerce Cross-Seller Documentation

How to configure and use the WooCommerce Cross-Seller plugin

WooCommerce Cross-Seller monitors new purchases and sends out automated suggestions to your customers.

The suggestions are based on the previous purchases your customer made and are automatically filtered so the products they have already purchased do not repeat in the email.

Install and activate plugin

To install the plugin either upload via your WordPress administration:

Plugins -> Add New -> Upload

Chose the .zip file you have downloaded and click “Install Now”.

Once uploaded click the Activate Plugin link.

Configure the plugin

Once activated you can configure the plugin by going to the settings page.

The settings page is located under

WooCommerce -> Settings -> Emails tab -> Cross-Seller

Screenshot of settings page for WooCommerce Cross-Seller
WooCommerce Cross-Seller Settings page

License Key

License Key is your license key you were sent when you purchased the plugin. This key enables you to get updates from the plugin via the WordPress Updates system.

You will see a notification if your license is valid.


The email notifications are disabled per default so you have a chance to review the settings before any email is sent.

Day(s) after order

You can choose to send any amount of days after a purchase has been completed. A completed purchase is when you mark a purchase as completed in the WooCommerce administration (if you have physical products that need to be packed and shipped) or immediately if the purchase only contains virtual products. This is to ensure no emails are sent before the customer actually have a chance to receive their purchase.

If you want to send just a single email after 14 days, simply enter “14”.

If you want to send several emails, separate each day with a comma, ie. “14,30,60” meaning an automated email will be sent 14 days, 30 days and 60 days after purchase.

Email subject

You can customize the subject field of the email being sent. It is also possible to use macros, for example:

“{customer_name}, suggestions for you” will be replaced with the customers name, i.e.: “John Doe, suggestions for you”.

Email Content

The content of the email can be edited and personalized with a range of macros.

{customer_name}Replaced with the customers name.
{customer_firstname}Replaced with the customers name.
{customer_lastname}Replaced with the customers name.
{customer_email}Replaced with the customer email.
{site_url}Replaced with url for your website.
{site_title}Replaced with the site title.
{order_id}Replaced with the order id.
{order_date}Replaced with the date and time of the order.
{order_date_completed}Replaced with the date the order was marked completed.
{stop_emails_link}Replaced with a link to stop recieving email review reminders.
{days_ago}Replaced with the number of days ago the order was made.
{products_suggestions}Replaced with a list of products on offer.
{products_onsale}Replaced with a list of the latest products on sale.
{products_suggestions} and {products_onsale} are filtered to not show any products previously made by the customer.

Each of these macros will be replaced with their respective values during the email sending.

The two most important macros are




Each of these will be replaced with a list of 4 products. {products_suggestions} will be replaced with a nice list of products based on the built in recommendation engine that finds suggestions for each customer based on their previous purchases.

{products_onsale} is replaced by a list of the 4 latest (newest) products on sale right now.

Both lists are filtered so any duplicates are removed and only unique products are shown. Also, both lists only show products currently in stock, no reason to suggest products that are not in stock.

Note: These products suggested are generated at the time the email is sent, meaning if you choose to send several emails, i.e. 30 and 60 days after purchase, the lists are up to date with what is in your shop right now.

Stop Receiving Emails Text

The macro {stop_emails_link} is replaced in your email with a text link that allows your customer to remove themselves from any further emails. We highly suggest you use the {stop_emails_link} macro in your email template to allow people to opt out of further suggestion emails.

Email blocklist

Any customer that chooses to opt out of any further suggestion emails will be added to this list. The list is comma-seperated and you can manually add or remove emails from this list.

Any scheduled email is first checked against this list, and if the user has removed themselves no further emails will be sent.

Send Test Email

Email Recipient
You can test to see how the emails being sent out will look like by sending an email to any email address you wish. The macros you use will be replaced with dummy data during testing.


The latest events are logged so you can keep track of what is going on and when emails are being sent.

Buy a license

Do you already own a license? Go to the product page and read more or buy now.

[purchase_link id=”92010″ style=”button” color=”green” text=”Purchase” direct=”true”]