View Product Page

Getting started

YITH WooCommerce Cart Messages allows the creation of custom messages to show in the product, “Shop”, “Cart” and “Checkout” pages.
The messages can be shown always or only when specific products have been added to the cart.

To enable/disable the messages on your site pages, go to YITH > Cart Messages > Settings.

General settings

To create a new message go to YITH > Cart Messages and click on Add new message.

Add new message
Configure new message

Based on the message type, you can find some of the following settings:

  • required quantity: is required for the correct view of the message and it informs users about the difference between the quantity of the specified product currently in the cart, and the requested quantity for the fulfillment of the offer that you can offer.
  • threshold amount: the minimum quantity of the product that users have to add to their cart to view the message you have written
  • choose a custom layout: layout to associate to the message, choosing from the 6 that you can customize in the “Layouts” section of the plugin settings dashboard.
  • button text/button URL: these fields are optional. Add text in the Button text field if you want to show a button to the users to catch their attention for action. If the field is empty, no button will be shown. In the Button URL field, you can add the link to which you want users to be redirected after the click
  • Exclude coupons amount: (from “Minimum Amount” messages type) if enabled, the control is applied to the total cart amount, except for the value of the coupons
  • show to: users to which show the created message
    • logged users
    • unlogged users
    • all the users
  • start date: first day to show the message
  • expiration date: last day to show the message
  • show in: pages on which show the message

“Products in cart” message type

This type of message is shown only when the user added to the cart at least one of the products you selected in the “Select Products” entry.

Products in cart message type

Suppose you provide a discount for a specific product quantity selected, you can take advantage of the available placeholders to notify the user through the message you have created.

  • {remaining_amount}: it indicates the remaining amount to reach the minimum order amount;
  • {products}: it specifies which of the listed products is in the cart;
  • {required_quantity}: it states the exact number of products to purchase;
  • {user_name}:

In the example, we want to notify our customers about the free shipping option we offer for the purchase of 10 Slim fit T-Shirts. We want to show the message from the first T-shirt added to the cart.

To do it, we need to select the Slim fit T-Shirts product for the message and set the values as follows:
required quantity: 10
threshold amount: 1

Product quantity

Products in cart message on frontend

“Categories in cart” message type

The “Categories in cart” message type is shown only when at least one of the products in the cart belongs to one of the selected categories (in the example the category is “Shoes & Bags”).

Categories in cart messageCategories in cart message - Frontend

You can edit the message using the following placeholders {categories} to state the list of categories.

  • {categories}: list of categories
  • {user_name}:

“Simple” message type

The “Simple message” message type is always shown in the Cart and/or Checkout pages.

You can insert an optional button and set an expiration for the message.

Simple message

Simple message example

“Minimum amount” message type

This message type is shown only when the cart reached the threshold amount you inserted in the “Threshold amount” entry.

Minimum amount message

Supposing you provided an offer when reaching the threshold amount, you can consider encouraging the users by showing them the amount required to take advantage of that offer.
The amount can be shown by inserting the {remaining_amount} placeholder in the message body.

By using the placeholder {user_name} you can enter in a message the username user. It can only be shown in the case in which the user is logged.

Minimum amount example

Based on our example, the amount of €10 is given by the difference between the value specified in the “Minimum order amount” entry (€100) and the cart total amount (€50)

The message isn’t shown if at least one of the products in “Hide the message if these products are in cart” (if specified) is added to the cart.

“Deadline” message type

The “Deadline” message type can be used to notify the user of the time remaining before an active offer on your site expires.
Follow these essential steps to configure this message type in the correct way.

  1. insert the message text by taking advantage of the “{time_remain}” placeholder that allows showing the time remaining before the expiration
  2. specify the daily deadline of the message through the “Deadline hour” entry, considering the message will start to be shown from midnight until the specified time.
  3. specify the days on which you want to show the message

Let’s make an example. We want to show the message on Monday, Tuesday, Wednesday, Thursday, and Friday until 22:00. The values have to be set as follows:

  • Deadline hour: 22
  • Deadline days: Monday, Tuesday,Wednesday, Thursday, Friday

Deadline message

Supposing to view the message on Friday at 10:46, it will show as follows.

Deadline message example

“Referrer” message type

The “Referrer” message type is shown only when the users reach the site through the link you have specified in “Referrer URL”.

Referrer URL

Message layouts

There are 6 available message layouts that can be customized in YITH > Cart Messages > Layouts.


You can choose what layout to use for each message.

Choose message layuot

These are the 6 available layouts.