Milo Stock Management

Auto-pause subscriptions when a product’s stock hits zero and auto-resume them when stock is replenished, with the customer notified by email.

Installation

1. Install and activate the free Milo Subscriptions plugin.
2. Make sure WooCommerce is installed and active (this add-on requires it).
3. Upload and activate Milo Stock Management (Plugins → Add New → Upload).
4. Enter your license key under Subscriptions → Licenses to enable updates.

Configuration

Under Subscriptions → Settings → General → Stock Management:

Setting	Description
Enable stock-based subscription pausing	On/off switch. Enabled by default.

That is the only setting. Everything else happens automatically based on your WooCommerce stock levels.

How pause on stock works

The add-on listens to WooCommerce stock changes on products and variations. When a product with stock management enabled reaches zero (or below):

1. Every active subscription containing that product (as a line item or a variation) is set to on-hold.
2. The subscription is tagged internally with the product that caused the pause.
3. A note is added to the subscription: paused automatically because the product is out of stock.
4. The customer receives the Subscription Paused (Out of Stock) email.

Products that do not manage stock (no stock quantity) are ignored, so simple “in stock / out of stock” toggles without a quantity never trigger a pause.

How resume works

When the same product’s stock goes back above zero:

1. Only the on-hold subscriptions that were paused by this add-on for that specific product are resumed. Subscriptions you paused manually, or that were paused for another product, are left alone.
2. Each one is set back to active, the internal tag is removed, and a note is added: resumed automatically because the product is back in stock.

No email is sent on resume; the pause email already tells the customer the subscription will resume automatically once the product is back in stock.

The email

Subscription Paused (Out of Stock) is a standard WooCommerce customer email, so you can edit its subject, heading, and additional content under WooCommerce → Settings → Emails, or disable it entirely. It also appears in the Milo Subscriptions email settings panel. The default additional content reassures the customer that no action is needed and the subscription will resume automatically.

The HTML and plain-text templates can be overridden in your theme like any WooCommerce email template (templates/emails/customer-stock-pause.php).

Troubleshooting

• Nothing gets paused. Check that the toggle is on under Settings → General → Stock Management, and that the product actually manages stock with a quantity (Product → Inventory → Track stock quantity). Without a stock quantity the add-on does nothing.
• A subscription did not resume. Only subscriptions this add-on paused are auto-resumed. If you (or another plugin) put a subscription on hold, restocking will not reactivate it; resume it manually.
• No email arrived. The email respects the standard WooCommerce email enable/disable switch; check it under WooCommerce → Settings → Emails.

Developer reference

• milo_stock_subscription_paused (action): fires after a subscription is paused, with the subscription and the out-of-stock product ID.
• milo_stock_subscription_resumed (action): fires after a subscription is resumed, with the subscription and the restocked product ID.
• milo_stock_pause_notification (action): triggers the pause email; fire it yourself to resend a notification.

Billing modes

WooCommerce mode only. Stock is a WooCommerce concept, so this add-on does not apply to standalone (Stripe-driven) subscriptions.