---
title: Scheduled Items
slug: oms/scheduled-items
docTags: 
createdAt: 2026-02-06T14:16:06.236Z
---

Admins can schedule one-time items to be automatically added to future subscription installments. Items can repeat across multiple installments with a specified quantity. 

## How to Use

### Adding a Scheduled Item

1. Go to **Subscriptions > Edit** a subscription
2. Scroll to the **Scheduled Items** section
3. Click **"+ Add Scheduled Item"**
4. Fill in:
   - **Variant** — Search for the product variant to add
   - **Qty** — Number of units per installment
   - **Repeat Count** — How many installments to include this item
   - **Starting Installment** — Which upcoming installment date to start from
5. A summary will appear: *"This will add 1 units of 'Carnations' for 5 installments, starting Feb 10, 2026"*
6. Click **Update** to save



![](https://api.archbee.com/api/optimize/TmutqdeXiIw-V3gBZXVjd/EGtgY2VukDbmbH3r6jMhn_image.png)

### Editing a Scheduled Item

You can change the variant, quantity, or repeat count of an existing item. The system tracks how many times the item has already been delivered and adjusts accordingly.

### Canceling a Scheduled Item

Check the **Remove** checkbox next to the item and click **Update**. The item will no longer be added to future installments.



![](https://api.archbee.com/api/optimize/TmutqdeXiIw-V3gBZXVjd/gYzcXXjnKwF44nvcDEWCf_image.png)

## What Happens at Processing Time

When a subscription installment is processed and an order is created, the system automatically adds any scheduled items that are due. The item's remaining count is decremented each time, and once all repetitions are fulfilled the item stops being added.

### Example

| Installment         | Action                   | Remaining   |
| ------------------- | ------------------------ | ----------- |
| Feb 13 (start date) | 2x Widget added to order | 2 remaining |
| Feb 20              | 2x Widget added to order | 1 remaining |
| Feb 27              | 2x Widget added to order | Completed   |
| Mar 6+              | Nothing added            | -           |

## Limitations

- Not available for prepaid subscriptions
- Items are added as one-time charges, not recurring subscription items