Skip to main content

What are listing rules?

Set stock and price rules on one listing or variant to override your store defaults: where to edit them, what each field does, and how to import them in bulk by CSV.

Listing rules let you change how SKULabs syncs one listing or variant without changing the rest of the store. By default, every listing uses store_default, which means it follows the stock and price rules set for the whole store.

Common uses:

Edit the rules of one listing

  1. Go to Inventory > Listings.

  2. Search for the listing and click its name.

  3. In the Listing Rules panel, click Edit.

    Listing Rules panel on a listing page, showing the Stock and Price rules set to store_default and the Edit button

    The Listing Rules panel on a listing page. Both rules use the store defaults.

  4. Enter the new rules and click Save.

    Edit rules window with the Stock rule and Price rule fields and the list of variables you can use

    The Edit rules window. Amazon and Walmart listings also show the restock fields.

Fields in the Edit rules window

  • Stock rule: the quantity SKULabs sends to the channel. See the stock rule variables below.

  • Price rule: the price SKULabs sends to the channel. See the price rule variables below.

  • In both fields, skip stops SKULabs from syncing this listing, and store_default goes back to the store rule.

  • Switch fulfillment to (Amazon only): set to MFN to push stock for an FBM SKU that uses Amazon remote fulfillment.

  • Restock date, Use restock date from PO, Buffer days and Restock quantity (Amazon and Walmart only): advertise a restock date and a quantity for backorders. With Use restock date from PO, SKULabs takes the date from your open purchase orders and adds the buffer days. Restock quantity accepts a number or a rule that uses the stock rule variables, for example incoming_due_by(30) - reserved.

Stock rule variables

Quantities are counted in the warehouses linked to the store. For a kit or a multipack, each value is the number of complete kits the components allow.

  • free: on hand minus reserved. It also includes FBA and FBT stock, unless the rule itself uses fba or fbt.

  • on_hand: on hand quantity.

  • reserved: quantity reserved for open orders.

  • fba: Fulfilled by Amazon stock.

  • fbt: Fulfilled by TikTok stock.

  • recommended: free minus 1, minus 15% of reserved. A safer default than free.

  • num_unique_listings: how many listings in this store are linked to the same item.

  • solo: true when the listing is one unit of one item (not a kit or multipack).

Functions

  • no_more_than(qty, max): never send more than max. The result can be 1 below max. Example: no_more_than(free, 20).

  • no_less_than(qty, min): never send less than min. The result can be 1 below min.

  • divide_across_listings(qty, num_unique_listings, multiplier, fixed_reserve, free): splits a quantity across the listings of the same item. Example: divide_across_listings(free, num_unique_listings).

  • enhancedReserve(percent, fixed_reserve, number_of_stores): holds back a percent of reserved stock (default 15%) plus a fixed amount (default 1), then splits the rest across listings and stores.

  • snapping(qty, start): rounds large quantities down so the channel shows round numbers. Above start (default 50) it rounds to tens, then hundreds and so on. Example: snapping(free) sends 230 for 237.

  • incoming_due_by(days): quantity on open purchase orders due within that many days.

  • Math functions such as Math.min, Math.max, Math.floor and Math.round.

Examples: free * 0.5 sends half of your free stock. Math.max(free - 5, 0) keeps 5 units back.

Price rule variables

  • cost, wholesale, retail and sale: the prices on the item or kit.

  • margin: the value of a custom field named margin on the item.

  • calc_cost and calc_retail (kits only): cost and retail calculated from the kit components.

Example: cost * 1.4 sends cost plus 40%. SKULabs rounds the result to 2 decimals and does not send a price of 0 or less.

Tip: To find every listing linked to an item, open the item and scroll to its Listings panel. Open each listing from there to edit its rules.

Edit listing rules in bulk

  1. Go to Imports/Exports > Inventory and, under Listings, click Listing rules.

  2. Prepare a CSV file with these columns:

    • Required: Store and SKU.

    • At least one of: Stock rule, Price rule, Switch fulfillment to, Restock quantity, Restock date, Restock date from PO, Buffer days, Restock quantity rule. The restock columns apply to Amazon FBM SKUs.

  3. Click Upload CSV file and check the results shown under the button.

To clear a value, enter REMOVE in that column.

Did this answer your question?