Product selection
Select product from
Choose the source of products that the notification popup will display. Options include orders placed (products from recent orders), recently viewed products, manually selected products, or products from selected categories. This controls whether notifications are generated from real order data, visitor behavior, or admin-defined selections.
Example: Choose “Orders placed” to show products customers actually bought, or “Selected products” to always show a few hand-picked items.
Virtual first name
Enter virtual customer first names to use when generating fake/virtual sales notifications. Provide one name per line; these names will be rotated when the plugin shows virtual sales instead of real customer names.
Example: Enter each name on its own line: John
Smith
Adrianus
Virtual location
Provide a list of virtual locations to display in fake sales notifications. Each location should be on its own line and formatted as “City, State, Country”. If you do not have a city or state, leave that part empty but keep commas to preserve order (e.g., “, State, Country” or “City, , Country”).
Example: New York City, New York, USA
Bernau, Freistaat Bayern, Germany
Select product
Pick specific products to include in the notification popup. This is a multi-select field where you can search and choose any number of products.
Example: Select “Blue T-Shirt” and “Stainless Bottle” so the popup only ever shows those products.
Select category
Choose one or more product categories whose products will be used to generate notifications. This is a multi-select field and accepts product category IDs.
Example: Select “Accessories” and “Summer Collection” to show items from those categories.
Based on the order status orders will be selected
When using orders as the product source, select which WooCommerce order statuses should be considered for creating notification popups. You can pick multiple statuses (for example, only completed orders).
Example: Select “Completed” so only orders marked completed generate notifications.
Sequence of the order shown in the popup
Control the ordering of orders when generating notifications: show the latest orders first, the oldest first, or randomize the order selection.
Example: Choose “Show latest orders first” to prioritize recent purchases in the popup.
Show orders placed in last (time value + unit)
Define the time window used when selecting orders to display. Use two settings together: a numeric value (`pi_sn_time_value`) and a time unit (`pi_sn_time_unit`) — hour, day, week, or life_time. For example, “1 day” will include orders from the last 24 hours; “life_time” will include all orders ever placed.
Example: Set value=2 and unit=hour to show orders placed in the last 2 hours.
How many notification to show (max notifications per page)
Set the maximum number of notifications to display on a single page. For virtual orders the plugin will create up to this many notifications; for real orders, fewer will be shown if there aren’t enough orders available. The value must be at least 1.
Example: Set this to 3 to limit the page to three notifications at a time.
Excluded product
Select products to exclude from being shown in notification popups. This multi-select lets you pick product IDs that will be ignored when generating notifications.
Example: Exclude a discontinued product so it never appears in notifications.
Excluded category
Choose categories whose products should be excluded from notifications. Selected category IDs are saved and those categories’ products will be ignored.
Example: Exclude the “Internal Test” category to prevent test products from appearing.
Use visitor country in the fake sales popup instead of random virtual location
Toggle whether the plugin uses the visitor’s detected country/state for fake sales notifications instead of a random virtual location from the `pi_sn_custom_location` list. If enabled, only the {country} and {state} shortcodes are available for messages; {city} will not be provided.
Example: Enable this to show “Liam from United Kingdom” using the visitor’s country rather than a random city from your list.
Number of product to consider from single order to create popup
When a single order contains multiple different products, this setting limits how many items from that one order will be used to generate popups. Setting 0 means “use all products” (which may create multiple popups with the same customer name); setting 1 prevents multiple popups per order by using only one product.
Example: Set to 1 so each order produces at most one popup even if the order contains 5 products.
Popup Setting
Enable sales notification
Toggle to enable or disable the live sales notification popups sitewide. When turned on, the plugin will show sale notifications; when off, no live sales notifications will appear.
Example: Turn this ON to show notifications for recent purchases, OFF to stop all popups.
Enable sales notification on mobile
Toggle to enable or disable the live sales notification popups on mobile devices. Use this to keep popups off smaller screens if desired.
Example: Leave ON to show popups on phones and tablets; set to OFF to suppress them on mobile visitors.
Mobile breakpoint width
Numeric pixel width that defines what the plugin considers a “mobile” device. If the browser width is equal to or below this number, the mobile setting applies.
Example: Set to 767 to treat screens 767px and narrower as mobile; popups may be hidden or use mobile-specific behavior.
Dismiss notification option
Toggle to show a “dismiss” option on the notification. If enabled, visitors can dismiss notifications; the plugin will then remember that dismissal and not show notifications to that visitor for the configured number of days.
Example: Enable this so visitors can stop seeing notifications for a period after dismissing them.
Dismiss the popup for
Number of days to remember a visitor’s dismissal of the notification. After this many days, notifications can be shown again to the same visitor.
Example: Set to 30 so a visitor who dismissed notifications won’t see them again for 30 days.
Show elapsed time on the popup
Toggle to display human-readable elapsed time on notifications (e.g., “1 min ago”, “1 week ago”). When enabled, each notification shows when the order occurred in relative terms.
Example: Enable to show “2 minutes ago” next to a shown sale to make it feel recent.
Show stock left for the product to create urgency
Toggle to display remaining stock for the product in the notification. Use this to create urgency by showing low stock counts.
Example: Enable to show “Only 3 left” on notifications for products with limited stock.
Fake stock quantity
Number used when a product does not use stock management. The plugin will show this quantity as the stock left for such products to simulate urgency.
Example: Set to 2 and notifications for non-stocked products will show “2 left”.
Fake product quantity
Maximum quantity used when the plugin generates fake order quantities. The plugin picks a random number between 1 and this value to show how many items were “purchased” in a fake sale.
Example: Set to 10 so generated fake sales display a random quantity from 1 to 10.
Loop through
Toggle to repeat the notifications once the loaded set of popups has been shown. When enabled, the plugin will cycle through available notifications continuously; when disabled, it will stop after one pass.
Example: Enable to keep notifications recurring; disable to show them only once per loaded set.
When to start showing popup (milliseconds)
Delay in milliseconds before the first notification appears after a visitor lands on the page. This controls how long the visitor waits before seeing the initial popup.
Example: Set to 6000 to show the first popup roughly 6 seconds after page load.
How long to keep the popup opened (milliseconds)
Duration in milliseconds for how long each notification stays visible before it automatically closes.
Example: Set to 6000 so each popup remains visible for about 6 seconds.
Time gap between showing of 2 popups (milliseconds)
Interval in milliseconds between the closing of one popup and the appearance of the next. Controls the pacing of consecutive notifications.
Example: Set to 6000 so there is a 6-second gap between popups.
Number of times a popup will be shown to customer in single session
Limit for how many notifications are shown to a visitor during a single browser session. Leave empty for unlimited. The session ends when the user closes the browser tab.
Example: Enter 3 to show at most three notifications per session; leave blank to allow unlimited popups.
Make sales popup appear more random instead of appearing after fixed interval
Toggle to add extra randomness to popup timing. When enabled, the plugin adds a random 0–15 seconds to the configured interval between popups, making their appearance less predictable.
Example: Enable to vary intervals so popups don’t always show at fixed, repeated timings.
Dont show out of stock product in popup
Toggle to exclude products that are out of stock from being shown in notifications. When enabled, only in-stock products will appear.
Example: Enable to avoid showing sales for items that customers can’t buy.
Dont show deleted product in popup
Toggle to prevent notifications from including products that have been deleted from the store. When enabled, deleted products are filtered out.
Example: Enable to make sure removed products don’t appear in the live feed.
Give Option to customer to exclude their info from live feed
Toggle to add a checkbox on the checkout page allowing buyers to opt out of having their order shown in the live sales feed. If enabled, the checkout will include an opt-out control that prevents showing that buyer’s info in notifications.
Example: Enable to respect buyer privacy by letting customers choose not to appear in public notifications.
Message shown to customer on checkout page
Customizable text that appears next to the opt-out checkbox on checkout. Use this to explain the exclusion option to customers. This text is translatable and includes a translation link in the admin UI.
Example: Default: “Don’t show my information in live sales feed”. Change it to “Please hide my purchase from live feed” to better match your store wording.
Design
Popup position
Sets where the sales notification popup appears on the page. Options include left-bottom, right-bottom, left-top, and right-top. The selection controls the popup’s fixed position relative to the browser viewport.
Example: Choose “Right Bottom” to show notifications in the lower-right corner of the screen.
Image position
Controls whether the product image in the popup is displayed on the left or right side of the description area. This affects the visual layout of each notification message.
Example: Select “Left” to place the product image to the left of the product name and message.
Background color
Defines the popup’s background color. Accepts a hex color value. This color is applied to the notification container and helps match the popup to your site branding or theme.
Example: Set the color to “#ffffff” for a white background so the popup looks clean on dark sites.
Background image
An optional image that will be used inside the popup as its background. Upload or provide an image URL to visually enhance the notification background.
Example: Upload a subtle diagonal stripe image to add texture behind the popup content.
Product image
Fallback image used when a product has no image, or when you choose to force using a specific image. This ensures the popup always shows an image even if the product lacks one.
Example: Upload a generic product placeholder so notifications always show a meaningful image.
Always use this image in place of product image
Toggle to force the plugin to always use the alternate product image instead of the real product image. When enabled, the popup will ignore the product’s actual image and show the configured fallback image.
Example: Enable this if you want a consistent brand image for every notification regardless of the product.
Popup width
Numeric value (percentage) that sets the width of the popup as a percentage of the browser window width. The value should be between 0 and 100 and determines how wide the notification appears on different screens.
Example: Set it to 30 to make the popup take up 30% of the browser width.
Popup image width
Numeric value (percentage) that sets the product image width relative to the popup width. Controls how large the image appears inside the notification on desktop and larger viewports.
Example: Set it to 20 so the image occupies 20% of the popup width, leaving space for text.
Popup image width for mobile
Numeric value (percentage) that sets the product image width relative to the popup width on mobile devices. Use this to adjust image sizing specifically for smaller screens.
Example: Set it to 25 so images are slightly larger on mobile for better visibility.
Border radius
Numeric value (pixels) that controls the border radius of the popup container, giving rounded corners. A higher value produces more rounded corners; zero results in sharp corners.
Example: Use 60 to create a pill-like rounded popup.
Border radius of Image
Numeric value (pixels) that sets the border radius of the product image inside the popup. Use this to create rounded or circular product images.
Example: Set to 50 to make the product image appear circular if the image is square.
Spacing around image
Numeric value (pixels) that sets padding or space around the product image inside the popup. Increase to give the image breathing room from surrounding text and elements.
Example: Set to 8 to add modest spacing between the image and the text.
Link image to product page
Toggle that determines whether the product image in the popup is clickable and links to the product page. When enabled, visitors can click the image to open the product details.
Example: Enable this so users who click the image are taken directly to the product page.
Open product link in new tab
Toggle that controls whether the product link (from image or other clickable elements) opens in a new browser tab. When enabled, links will use target=”_blank”.
Example: Enable this to keep the store page open while customers view the product in a new tab.
Message opening animation
Select the animation used when a sales notification appears. Multiple animation names are available (e.g., fadeIn, bounceIn, slideInLeft). The chosen effect runs when the popup opens.
Example: Choose “bounceIn” for a bouncy entrance that attracts attention.
Message closing animation
Select the animation used when a sales notification closes. Options include fadeOut, bounceOut, slideOutRight, etc. The selected animation runs when the popup is dismissed or times out.
Example: Choose “fadeOut” for a subtle disappearance effect.
Show close button
Toggle to display a close (dismiss) button on the popup. When enabled, visitors can manually close the notification using this control.
Example: Enable the close button so users can dismiss notifications immediately.
Image used as close button
Optional image to use as the close button icon inside the popup. Upload a small image or icon to replace the default close control for a custom look.
Example: Upload a small “X” icon image to use as the popup’s close button.
Enable audio alert
Toggle to play an audio alert when a sales notification appears. When enabled, the configured MP3 file (or default sound) will play to draw attention to the popup.
Example: Enable this if you want a short chime to play whenever a new sale is shown.
Add audio file url (mp3)
URL of the custom MP3 file to be played as the audio alert. The file should be MP3 format and hosted on your own server; provide a full URL to the file.
Example: Enter “https://example.com/wp-content/uploads/alert.mp3” to use your uploaded audio file for notifications.
Message Text
Sales message format
This textarea sets the message format that appears in the sales popup. Use the provided shortcodes to build the message template. Supported shortcodes include: {product} (product title), {product_link} (product title linked to product or affiliate page), {time} (time of purchase), {date} (date of purchase), {country}, {state}, {city}, {first_name}, {price}, {time_passed}, {stock_left}, {country_state}, {state_country}, {quantity}. HTML line breaks are allowed in the description/help text. The stored value is a string template — the plugin replaces the shortcodes with real order data when showing the popup.
Example: “{product_link} was purchased by {first_name} from {state_country}” — will render like: “Blue T‑shirt was purchased by Alice from California, USA”.
Date format for {date}
Select the PHP date format used when the {date} shortcode is inserted into the message. The setting maps to common PHP date format strings (for example “Y/m/d”, “d-m-Y”, “M j, Y”). The plugin will format the order date using the chosen format before replacing {date} in the message.
Example: If you choose “M j, Y”, {date} for an order on 2025-08-23 displays as “Aug 23, 2025”.
Time format for {time}
Select the PHP time format used when the {time} shortcode is inserted into the message. Options map to PHP time formats (for example “g:i a”, “H:i”). The plugin formats the order time using the selected format when replacing {time} in the message template.
Example: If you choose “g:i a”, a 14:30 time displays as “2:30 pm”.
Open link in new tab {product_link}
This switch controls whether the product link generated by the {product_link} shortcode opens in a new browser tab/window. When enabled the product link will include target=”_blank” behavior (and typically rel=”noopener noreferrer” should be used for security). When disabled the link opens in the same tab.
Example: Enabling this will make the product link open a new tab when a visitor clicks it, e.g., clicking the product in the popup opens the product page in a new browser tab.
Normal text color
Color picker for the default text color used by general text in the popup. Expect a hex color value (e.g., #000000). This controls the color of parts of the message that are not otherwise styled (product, time, date, etc.).
Example: Setting “#333333” will make the message body text appear in a dark grey color.
Product title color {product}
Color picker for the product title’s text color when the {product} shortcode is used. Accepts a hex color value and applies that color specifically to the product name portion of the popup message.
Example: Set “#ff0000” to make product names appear in red.
Product link color {product_link}
Color picker for the product link text (the clickable product name generated by {product_link}). Use a hex color value to style how the linked product name looks in the popup.
Example: Set “#1e90ff” to style the product link in a blue color similar to standard links.
Time text color {time}
Color picker for the time text when the {time} shortcode is displayed. This sets the color of the time portion inside the popup message.
Example: Set “#666666” to render the time in a muted grey color.
Date text color {date}
Color picker for the date text when the {date} shortcode is displayed. This controls the color of the date portion in the sales popup message.
Example: Set “#008000” to display the date in green.
Country text color {country}
Color picker for the country name when the {country} shortcode is shown. Use a hex color to style the country text in the message.
Example: Set “#444444” to keep the country text in a neutral dark grey.
State text color {state}
Color picker for the state name when the {state} shortcode is used. Accepts a hex color and applies it to the state portion of the popup.
Example: Set “#0000ff” to make states appear in blue.
City text color {city}
Color picker for the city name when the {city} shortcode is used. Use a hex color value to change the city text color inside the popup.
Example: Set “#ff8c00” to display city names in orange.
First name text color {first_name}
Color picker for the customer’s first name when the {first_name} shortcode is displayed. This controls the color of the customer’s name in the popup message.
Example: Set “#cc0000” to highlight first names in a dark red color.
Normal text font size
Number input (pixels) for the font size used by general text in the popup. The value is interpreted as pixels (PX). Set to zero or a small number to reduce text size. The default is “16”.
Example: Set “14” to make the general message text 14px high.
Product title font size {product}
Number input (pixels) controlling the font size for the product title displayed by {product}. The setting expects an integer pixel value and changes only the product title size.
Example: Set “18” to make product titles slightly larger than the default.
Product link font size {product_link}
Number input (pixels) for the clickable product link text size generated by {product_link}. Use an integer value (px) to enlarge or shrink the link text.
Example: Set “18” to increase the product link text to 18px.
Time font size {time}
Number input (pixels) controlling the font size used for {time} when shown in the popup. Use integer pixel values to adjust readability of the time text.
Example: Set “12” to make the time text smaller than the message body.
Date font size {date}
Number input (pixels) for the font size of the {date} shortcode in the message. Enter the desired pixel value for the date text.
Example: Set “12” to reduce date text to 12px.
Country font size {country}
Number input (pixels) for the font size of the {country} shortcode. Adjust to match the design of your popup and improve legibility.
Example: Set “14” to slightly reduce country name size from the main text.
State font size {state}
Number input (pixels) defining the font size for the {state} shortcode. Use pixel values to make state names larger or smaller.
Example: Set “14” to maintain consistent size with country text.
City font size {city}
Number input (pixels) controlling the font size for {city}. Use integer pixel values to style the city portion of the message.
Example: Set “13” to make city names slightly smaller.
First name font size {first_name}
Number input (pixels) for the font size of the customer’s first name inserted via {first_name}. Enter an integer value to make names stand out or blend in.
Example: Set “16” to match the default body size.
Normal text font weight
Select input to choose the font weight for general text in the popup. Options include “Normal”, “Bold”, and “Lighter”. This sets the CSS font-weight for non-shortcode text elements.
Example: Choose “Bold” to make general message text thicker and more prominent.
Product title font weight {product}
Select input for the font weight applied to product titles shown via {product}. Options: “Normal”, “Bold”, “Lighter”. Use to emphasize or de-emphasize product names.
Example: Choose “Bold” to make the product title more prominent.
Product link font weight {product_link}
Select input for the font weight of the clickable product link generated by {product_link}. Options: “Normal”, “Bold”, “Lighter”. Adjust to match your theme’s link styling.
Example: Choose “Normal” to match surrounding text weight.
Time font weight {time}
Select input to control the font weight for the {time} shortcode. Use “Normal”, “Bold”, or “Lighter” to change emphasis.
Example: Choose “Lighter” to make the time appear more subtle.
Date font weight {date}
Select input for the font weight of the {date} shortcode. Options are “Normal”, “Bold”, and “Lighter”. This sets how bold the date text appears.
Example: Choose “Normal” for standard weight matching body text.
Country font weight {country}
Select input for the font weight of the {country} shortcode. Options: “Normal”, “Bold”, “Lighter”. Use to emphasize the country in the message.
Example: Choose “Normal” to keep country text consistent with body text.
State font weight {state}
Select input for the font weight of the {state} shortcode. Options include “Normal”, “Bold”, “Lighter”. This changes how prominent the state name appears.
Example: Choose “Lighter” to reduce emphasis on state names.
City font weight {city}
Select input for the font weight applied to the {city} shortcode. Options: “Normal”, “Bold”, “Lighter”. Adjust to fit your popup design.
Example: Choose “Normal” for default appearance.
First name font weight {first_name}
Select input to control the font weight for the customer’s first name inserted with {first_name}. Options: “Normal”, “Bold”, “Lighter”. Use this to make names stand out or blend with text.
Example: Choose “Bold” to make customer first names pop in the message.
Control
Show popup on all pages of website
Enable to show the sales notification popup on every page of the site. When turned on, the plugin will ignore page-specific display rules and display notifications globally across the whole website.
Example: Turn this on if you want every visitor to see sales notifications regardless of which page they land on.
Show popup on selected page
Enable to show the notification popup only on the site’s front page (is_front_page).
Show on front page of the site (is_front_page)
Enable to show the notification popup only on the site’s front page (is_front_page). This setting limits display to the page WordPress considers the front page.
Example: Enable this to show notifications only to visitors who land on the site’s homepage.
Show on single product page (is_product)
Enable to show the notification popup on single product pages (is_product). Use this to display product-related notifications while customers browse individual product pages.
Example: Turn this on to show notifications about recent purchases when a visitor views any product detail page.
Show on cart page (is_cart)
Enable to show the notification popup on the cart page (is_cart). This displays notifications to users while they’re reviewing their cart contents.
Example: Enable this to remind customers of recent sales as they look at their cart before checkout.
Show on checkout page (is_checkout)
Enable to show the notification popup on the checkout page (is_checkout). This will surface notifications during the checkout flow.
Example: Turn this on to show subtle social-proof messages during checkout to increase conversions.
Show on shop page (is_shop)
Enable to show the notification popup on the shop page (is_shop). This applies notifications to the main product listing/shop archive page.
Example: Use this when you want visitors browsing your shop catalog to see recent sales notifications.
Show on product category page (is_product_category)
Enable to show the notification popup on product category archive pages (is_product_category). Notifications will appear when visitors browse category listings.
Example: Turn this on to display notifications to users viewing specific product category pages, e.g., “Shoes”.
Show on product tag page (is_product_tag)
Enable to show the notification popup on product tag archive pages (is_product_tag). This limits notifications to tag-based listing pages.
Example: Enable this to show notifications on pages listing products tagged with “sale” or “summer”.
Enable the notification on page
Comma-separated list of page IDs where the notification should be enabled. When set, notifications will be shown on the specified pages regardless of the other display settings. Enter numeric WordPress page IDs separated by commas.
Example: To enable notifications on pages with IDs 23, 33, and 44, enter: 23, 33,44
Disable the notification on page
Comma-separated list of page IDs where the notification should be disabled. Use this to explicitly prevent notifications from appearing on specific pages even if other rules would allow them. Enter numeric WordPress page IDs separated by commas.
Example: To disable notifications on pages with IDs 23, 33, and 44, enter: 23, 33,44