Back In Stock

Back In Stock notifications allow customers to subscribe for email alerts when out-of-stock products become available again. This feature helps you capture potential sales, understand product demand, and automatically notify interested customers when inventory is restocked.

Getting Started

1. Navigate to Swift Commerce → Back In Stock in your WordPress admin
2. Enable the feature using the master toggle
3. Configure display and subscription settings in the General tab
4. Customize the notification form appearance in the Customization tab
5. Set up email templates in the Notifications tab

When a product is out of stock, a subscription form will automatically appear on the product page, allowing customers to enter their email address to receive notifications.

---

General Tab #

Display Settings

Control when and where the Back In Stock subscription form appears on your store.

Setting	Description	Default
Show on out of stock products	Display the subscription form when products are out of stock	Enabled
Show on backorder products	Display the form for products currently on backorder	Disabled
Allow guest subscriptions	Let non-logged-in users subscribe for notifications	Enabled
Auto-remove on purchase	Automatically remove subscription when customer purchases the product	Enabled

Subscription Limits

Setting	Description	Default
Subscription limit per user	Maximum number of products a user can subscribe to (0 for unlimited)	0
Minimum stock to notify	Only send notifications when stock reaches this level	1

Use Case Examples:

• Set “Subscription limit per user” to prevent abuse from a single email subscribing to hundreds of products
• Set “Minimum stock to notify” higher (e.g., 5) if you want to ensure adequate stock before notifying customers

---

Customization Tab #

Templates

Choose a pre-designed style for the subscription form or create your own:

Template	Description
Modern Minimal	Clean and simple design with no icon
Classic Card	Traditional layout with bell icon
Bold Gradient	Eye-catching gradient colors
Custom	Create your own style (Pro)

Selecting a template automatically applies its preset colors, layout, and styling options.

Form Content (Pro)

Customize all text displayed in the subscription form:

Setting	Description	Default
Form title	Heading displayed above the form	“Get Notified When Available”
Email placeholder	Placeholder text in the email input	“Enter your email address”
Button text	Text on the subscribe button	“Notify Me”
Success message	Shown after successful subscription	“You’ll be notified when this product is back in stock!”
Already subscribed message	Shown if user already subscribed	“You’re already subscribed for this product.”
Error message	Shown when subscription fails	“Something went wrong. Please try again.”

Form Layout

Configure how the subscription form is displayed on product pages:

Setting	Description	Options
Form position	Where the form appears relative to add-to-cart	After add to cart / Replace add to cart / Custom (shortcode)
Form layout	Arrangement of input and button	Inline (horizontal) / Stacked (vertical)
Button style	Style of the subscribe button	Filled / Outlined
Show bell icon	Display notification bell icon	Enabled/Disabled

Colors & Styling (Pro)

Setting	Description	Default
Primary color	Button and accent color	#2563eb
Text color	Form text color	#1f2937
Background color	Form container background	#f3f4f6
Border radius	Roundness of corners	6px
Show “Powered by”	Display Swift Commerce branding	Disabled

Container Styling (Pro)

Fine-tune the form container appearance:

Setting	Description	Default
Padding	Inner spacing	20px
Margin	Outer spacing	16px
Border width	Container border thickness	1px
Border color	Container border color	#e5e7eb
Border radius	Container corner roundness	6px

Icon Styling (Pro)

Customize the notification bell icon:

Setting	Description	Default
Icon background color	Background circle color	#2563eb
Icon color	Bell icon color	#ffffff
Icon size	Size of the icon	20px
Icon border radius	Roundness (0 = square, 50 = circle)	50%

Button Styling (Pro)

Customize the subscribe button:

Setting	Description	Default
Button background color	Button fill color	#2563eb
Button text color	Text on button	#ffffff
Button border radius	Button corner roundness	6px
Button padding	Inner button spacing	12px

Input Styling (Pro)

Customize the email input field:

Setting	Description	Default
Input border color	Input field border	#d1d5db
Input background color	Input field background	#ffffff
Input text color	Text entered by user	#1f2937
Input border radius	Input corner roundness	6px

---

Notifications Tab #

The Notifications tab contains three sub-tabs: Email Settings, Subscriptions, and Sent Emails.

Email Settings

Configure the emails sent to customers.

Notification Email

The main email sent when a product is back in stock:

Setting	Description	Default
From name	Sender name displayed in email	Site name
From email	Sender email address	Admin email
Subject line	Email subject	“Good news! {product_name} is back in stock!”
Email heading	Main heading in email body	“It’s Back!”
Body text	Message content	Default notification text
Button text	Call-to-action button	“Shop Now”
Button color	Button color in email	#2563eb
Include price	Show product price in email	Enabled
Include image	Show product image in email	Enabled

Available Placeholders:

Placeholder	Description
{product_name}	Name of the product
{product_price}	Current product price
{product_url}	Link to product page
{site_name}	Your website name

Confirmation Email (Double Opt-In)

Email sent when double opt-in is enabled (Pro):

Setting	Description	Default
Subject line	Confirmation email subject	“Confirm your stock notification subscription”
Email heading	Confirmation heading	“Confirm Your Subscription”
Body text	Confirmation message	Default confirmation text
Button text	Confirm button	“Confirm Subscription”

Note: Confirmation emails are only sent when “Require double opt-in” is enabled in General settings.

Subscriptions

View and manage all customer subscriptions:

Column	Description
Email	Subscriber’s email address
Product	Product they subscribed to
Status	Active / Notified / Unsubscribed
Date	When they subscribed
Actions	Delete subscription

*Bulk Actions (Pro):*

• Delete selected subscriptions
• Mark as notified
• Export to CSV

Sent Emails

View the log of all sent notifications:

Column	Description
Email	Recipient email address
Product	Product that was restocked
Sent	Date/time notification was sent
Opened	Whether email was opened
Clicked	Whether they clicked the link
Purchased	Whether they made a purchase

---

Analytics Tab (Pro) #

Track the performance of your Back In Stock notifications.

Stats Overview

Metric	Description
Total Subscriptions	Total number of subscription requests
Active Subscriptions	Currently waiting for stock
Emails Sent	Total notifications sent
Conversion Rate	Percentage of notifications that led to purchases

Period Selector

Filter analytics by time period:

• Last 7 days
• Last 30 days
• Last 90 days

Top Products by Subscriptions

See which products have the most subscription requests, helping you understand demand and prioritize restocking.

Recent Conversions

View customers who purchased after receiving a notification, including:

• Product purchased
• Customer email (masked for privacy)
• Time since purchase

---

How It Works #

Customer Flow

1. Product Out of Stock – Customer visits an out-of-stock product page
2. Subscription Form Appears – Form displays below/instead of the add-to-cart button
3. Customer Subscribes – Customer enters their email and clicks “Notify Me”
4. Confirmation (Optional) – If double opt-in is enabled, customer receives confirmation email
5. Product Restocked – Store owner restocks the product
6. Automatic Notification – System detects stock change and queues notification
7. Email Sent – Customer receives “Back In Stock” email
8. Purchase – Customer clicks link and purchases the product

Automatic Stock Detection

The plugin automatically monitors stock status changes via WooCommerce hooks:

• woocommerce_product_set_stock_status
• woocommerce_variation_set_stock_status

When a product changes from “out of stock” to “in stock”, the system:

1. Finds all active subscriptions for that product
2. Queues notification emails
3. Processes queue hourly via WordPress cron
4. Marks subscriptions as “notified”

---

Shortcode Usage #

If you set “Form position” to “Custom”, you can place the subscription form anywhere using the shortcode:

[swift_commerce_stock_notify]

Attributes:

Attribute	Description	Default
product_id	Specific product ID to show form for	Current product

Example:

[swift_commerce_stock_notify product_id="123"]

---

Email Tracking #

The plugin tracks email engagement for analytics:

Tracking Type	How It Works
Opens	1×1 pixel tracking image
Clicks	Redirect links through tracking endpoint
Purchases	Order completion hooks checking subscriber email

All tracking is done via REST API endpoints that record timestamps in the notification log.

---

Pro Features #

Test Email (Pro)

Send a test notification email to preview how it looks:

1. Go to Notifications tab → Email Settings
2. Click “Send Test Email”
3. Enter recipient email address
4. Receive sample notification with dummy product data

Export Subscriptions (Pro)

Export all subscriptions to CSV:

1. Go to Notifications tab → Subscriptions
2. Click “Export to CSV”
3. Download file with columns: ID, Email, Product ID, Product Name, Variation ID, Status, Subscribed At, Notified At

Revenue Tracking (Pro)

Track estimated revenue from Back In Stock notifications:

• Conversions count
• Estimated revenue (based on product prices)
• Recent purchases from notifications

---

Troubleshooting #

Form Not Appearing

1. Verify “Show on out of stock products” is enabled
2. Confirm product stock status is “Out of stock” in WooCommerce
3. Check if theme overrides woocommerce_single_product_summary hook
4. Try “Custom” position and use shortcode

Emails Not Sending

1. Check WordPress cron is running (notifications process hourly)
2. Verify email settings (from name, from email)
3. Test WordPress email sending with another plugin
4. Check spam/junk folders

Duplicate Subscriptions Prevented

The database enforces unique subscriptions per product/email combination. The same email cannot subscribe twice for the same product.

Double Opt-In Not Working

1. Confirm “Require double opt-in” is enabled in General settings
2. Note: Double opt-in is a Pro feature
3. Check that confirmation emails are being sent

---

Feature Comparison #

Feature	Free	Pro
Subscription form on out-of-stock products	✓	✓
Guest subscriptions	✓	✓
Automatic stock change detection	✓	✓
Back in stock email notifications	✓	✓
Basic form styling	✓	✓
Pre-designed templates	✓	✓
Email customization (from, subject, content)	✓	✓
Subscription management	✓	✓
Custom form text (title, messages)	✗	✓
Advanced color customization	✗	✓
Container styling (padding, margins)	✗	✓
Icon styling	✗	✓
Button styling	✗	✓
Input field styling	✗	✓
Double opt-in confirmation	✗	✓
Analytics dashboard	✗	✓
Conversion tracking	✗	✓
Revenue tracking	✗	✓
Export subscriptions to CSV	✗	✓
Test email functionality	✗	✓
Bulk actions	✗	✓
Remove branding	✗	✓