Turn it on and control it

Storefront data is controlled from one line in Manage discounts. It is the last row of the discount list card, under the discounts and the page buttons, on every tab (All, Active, Scheduled, Expired, Native discounts).

The line shows what is in your store now: how many discounts, products and collections carry data, and when it was last updated. Manual sync and the gear (settings) are on its right.

Turn it on

1. Open Manage discounts and scroll to the Storefront data line at the bottom of the discount list.

2. Click the gear and switch Live sync on.

   DiscountOS writes every live discount to your store. The first run takes a few seconds for a small store.

3. Choose where the data is written with the three switches below Live sync.

The switches

Switch	What it does	Starts
Live sync	Writes every live discount to your store and keeps it up to date. Turning it off pauses the writes. The data already written stays.	Off
Product metafields	Writes to every product a discount names directly.	On
Collection metafields	Writes to every collection a discount targets.	On
Publish to collection products	Also writes to every product inside a discounted collection, up to 8,000 products.	Off

When to turn on Publish to collection products

Most discounts target collections. With this switch off, a product card only knows about discounts that name that product. Turn it on when your product cards and product pages must show collection discounts too.

Manual sync

Manual sync rebuilds the data now. Use it right after you change a discount’s tags, instead of waiting up to about 2 minutes, or when you want to be sure the store matches your discounts. When nothing is out of date, the sync changes nothing.

Pause

Turning Live sync off pauses the data. Everything already written stays in your store, and the shop metafield sync_paused becomes true.

Paused data goes out of date

While paused, nothing is updated. A discount that ends stays in the data until you turn Live sync back on. Show shoppers a note while sync_paused is true, and never promise an end time from paused data. Prices at checkout are always current.

Turning Live sync on again runs a sync right away and removes anything that ended while it was paused.

Remove the data

With Live sync off, the settings show Remove storefront data. It deletes every discount entry and metafield DiscountOS wrote to your store. Your discounts themselves are not touched. Turn Live sync on again later and the data is written fresh.

After a removal and a fresh write, each discount entry keeps its handle (discount-<id>) but gets a new ID. Use the handle, not the ID, if your code stores a reference.