Tutorial
This tutorial sets up OneShelf for a print shop. Two tee designs, in 5 sizes each, use the same blank white tees. The steps are the same for candles, coffee, yarn, perfume, and kits. The setup takes about 15 minutes.
Install OneShelf from the Shopify App Store.
OneShelf starts in Preview mode. It changes nothing in Shopify until you press Go live.
Count the real item that your listings share, for example the blank white tees.
Do not copy the numbers from Shopify. Shopify counts each listing by itself, so its numbers can be wrong.
Open OneShelf. The Setup page opens first. Click New base stock.
Type a name, such as "Blank tee, white". Type a unit, such as "tees". Choose the location that the stock ships from.
Type the count from your shelf in On hand.

Click Choose listings and select each listing that sells this item. Each variant is one listing.
For each listing, set Uses per sale. A tee uses 1. A gift pair uses 2.
If you have finished items of one listing, type them in Already made. They sell first.
The Will show column gives the quantity that each listing gets.
OneShelf shows each listing with its quantity now and after.
For each listing that goes down, OneShelf asks if the extra units are already made. Choose Yes to keep them, or No to set the listing to the new number.
Save the base stock. In Preview mode, nothing changes in Shopify.

Open the Activity page after a few orders.
Each row shows what OneShelf would take from the base stock, and which listings it would update.

Only one app should set the stock of a listing.
If another app sets your stock, such as a warehouse or sync app, turn off its stock sync for the listings that you link.
Open Settings in OneShelf and click Go live.
Before you confirm, OneShelf shows each listing that will change.
Select Also turn on the checkout rule, if you want to stop a cart that needs more base stock than you have.
From now on, each sale lowers the base stock and every listing that uses it.

Uses per sale is how much base stock one sale of a listing takes. Use the unit that you count on your shelf.
| Store | Base stock (unit) | Uses per sale |
|---|---|---|
| Print shop | Blank tee, white (tees) | Each printed tee uses 1. A tee 2-pack uses 2. |
| Candle maker | Mini candle, one scent (candles) | A single mini uses 1. A sampler pack uses 1 of each of its 6 scents. |
| Coffee roaster | One roast (g) | An 8 oz bag uses 226. A 5 lb bag uses 2,268. |
| Perfume decants | One perfume (ml) | A 5 ml decant uses 5. A 10 ml decant uses 10. |
| Yarn dyer | One colorway, one dye lot (skeins) | A single skein uses 1. A sweater kit uses 5. |
More answers are in the FAQ. For help with the setup, write to support@oneshelf.app. Updated November 5, 2026.
OneShelf gives your listings one base stock. Every sale, online or at the register, takes from that one number. It is free for up to 10 base stocks.
Install on Shopify Open the demo store
The demo store password is shesta.