Update prices
ps_update_prices
Changes product prices. Big jumps need your extra approval.
TellMyShop Free: No. This tool is only in TellMyShop Pro. TellMyShop Free has only ready reports that read your store.
Ask Claude
„Raise gross prices in Garden lighting by 5%, rounded to .99.”
Example preview
22 products. Product 45: 129.00 -> 135.99 PLN gross (110.56 net), +5.4%. No change above 30%.
Technical details
Changes the base price of products, given gross or net, and optionally the wholesale (purchase) price, for up to 100 products per call. The preview shows old and new prices and the change in percent. A price of 0 can't be set. A change above 30% is refused unless allow_big_change is set after your explicit approval.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| shop_id | integer | no | Shop ID in a multistore installation. Defaults to the shop in the connector address. IDs are listed by ps_get_shop_info. |
| changes | array of object | yes | One item per product. Max 100 items. Fields of each item: product (string, required): Product (id:123, ref:ABC-1, ean:..., product URL, ID, EAN or reference). Max 300 characters. price_gross (number): New gross price in the shop currency (with tax, before promotions). Max 10,000,000. price_net (number): New net price (instead of price_gross). Max 10,000,000. wholesale_price (number): Net purchase price (for margins; customers don't see it). Range 0 to 10,000,000. |
| allow_big_change | boolean | no | true = allow a price change above 30% (only after the user confirmed it is intended). Default false. |
| confirm | boolean | no | false (default) returns a preview and saves nothing. true executes, only after the user approved the preview, together with change_token. |
| change_token | string | when: confirm=true | Token from the preview. Required with confirm=true. Valid 30 minutes, single use, bound to the previewed arguments and data state. |
Limits
Max 100 products per call. Price 0 not allowed. Change above 30% needs allow_big_change. Prices and the preview are in the shop's default currency. Saving needs the Commerce switch (off after install). Permission checked per action in the back office (Catalog > Products).
What you see before anything is saved
Claude first calls the tool without confirming it. The module returns a preview (current and new values) and a single-use token valid for 30 minutes. Claude shows you the preview and saves the change only after your yes.
Related tools
- Manage sale prices (specific prices) ps_manage_specific_prices
- Category and brand promotions (catalogue price rules) ps_manage_catalog_price_rules
- Product combinations (variants) ps_manage_combinations
- Revert change ps_revert_change
Use cases with this tool
- Raise or lower prices for a whole category
- Round prices to .99 after a price update
- Update wholesale prices from a supplier price list
Last updated: 2026-10-11