You can set subscription product inventory to help you keep track of your inventory sold for your upcoming batch of shipments, or to help you make a single subscription product you offer go into sold out mode.

How to set a subscription product inventory count

Go to the inventory section of a subscription product in your account. Here you’ll see two fields:

  • Current Scheduled Shipments. This is a count of all your currently scheduled or “reserved” shipments in your next batch. This includes all first-time shipments for brand new customers and any prepaid shipments that are due to be shipped in your next batch. You cannot edit this number.
  • Maximum Shipments. This is the max number of shipments that you want to sell in your next batch. This number is editable.
    • Your maximum shipments count must always be greater than your currently scheduled shipments count.
    • Setting this field to be blank means you have unlimited shipments/do not want to ever sell out for next month’s batch.


You can also view current inventory for all your subscription products on the subscription product page.


Sold Out Mode by Product

Once the number of scheduled shipments hits the maximum number of shipments, potential customers will be shown a sold out message if they try to purchase your subscription product on your website or on the Cratejoy marketplace.

If you offer multiple products, customers can still purchase any other subscription products that still have inventory left in your next batch.

More on Current Scheduled Shipments

We’ll automatically calculate how many shipments you have scheduled or reserved for your next batch.

For example, if you had 150 shipments scheduled/reserved for your next batch:

  • If a new customer buys a new subscription, you will go from 150 shipments scheduled/reserved to 151 shipments scheduled/reserved/
  • If you cancel a shipment for a customer, you will go from 150 shipments scheduled/reserved to 149 shipments scheduled/reserved.
  • If you move a shipment from next batch to the batch after next, you will go from 150 shipments scheduled to 149 shipments scheduled.

Some actions do not affect the number of shipments scheduled or reserved including:

  • Adding a new shipment. Adding a shipment adds a shipment to your current batch, not next batch.
  • A customer cancelling her prepaid subscription. Cancelling a subscription doesn’t automatically cancel all shipments associated with that subscription -- as the merchant, you would need to cancel her shipments to have the number of shipments scheduled change.


How often does currently scheduled shipments update?
It updates in real time as customers place orders or as you cancel shipments.

What happens if I have only 1 product left in stock but a customer tries to checkout with 2 of that product in her cart?
When the customer tries to add the second product to her cart, she’ll be shown the “Product [X] is out of inventory.” message.

What happens at the end of a billing cycle?
Max shipments stays constant until or unless you change it -- e.g. if you set your maximum shipments to be 200 shipments for your July batch, then your maximum shipments will be 200 for your August batch unless or until you change it.

How can I set a single product to be sold out immediately?
You can set the Maximum Shipments field to be exactly how many scheduled shipments you have currently.

How can I customize my sold out page/inventory out of stock page?
In Cratejoy Designer, just navigate to the Sold Out page and customize it to say whatever you’d like.

What features or settings are unsupported?

  • Product Types:
    • Gifting 1.0 purchases are not included in currently scheduled shipments.
    • Ad hoc products cannot have subscription inventory management (because there is no concept of a “next batch.")
    • Separate subscription products cannot share inventory. You can have one inventory count per subscription product.
  • Variants and Surveys: You cannot set inventory or sold out mode by product variant or by survey response.
  • Customizations and Notifications:
    • You can’t schedule inventory changes.
    • You can’t set a notification to alert when inventory remaining reaches 0 or approaches some other limit.
    • You cannot set separate inventory levels for Marketplace vs. your website.
    • You cannot update inventory via the API or in bulk.