Product combinations (variants)
ps_manage_combinations
Shows a product's variants, such as sizes and colours, and changes their prices, codes and which variant is shown first.
Free TellMyShop Audit: No. This tool is only in the paid version of TellMyShop. The free TellMyShop Audit has only tools that read your store.
Ask Claude
„The XL sizes of the Oslo hoodie should cost 10 more than the other sizes.”
Example preview
Product 310 Oslo hoodie. Combination 1204 (Size XL, Colour Grey): price impact +0.00 -> +10.00 gross (+8.13 net), final price 189.99 -> 199.99 PLN gross. Combination 1208 (Size XL, Colour Navy): the same.
Technical details
Combinations (variants: size, colour...). action=list shows a product's combinations with attributes, reference, EAN, price impact (net and gross), final gross price, stock and the default combination. action=update changes up to 100 combinations: price_impact_gross or price_impact_net (how much the combination differs from the base price; 0 = the same), wholesale_price, reference, ean13, upc, mpn, weight_impact, minimal_quantity, default=true (default combination on the product page). It doesn't create or delete combinations. Stock: ps_update_stock with combination_id. Promotion on one variant: ps_manage_specific_prices with combination_id.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| action | enum: list | update | yes | list | update. |
| 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. |
| lang | string | no | ISO language code, for example pl or en. Defaults to the shop's default language. |
| product | string | when: action=list | action=list: the product. Product the way a person refers to it: "id:123", "ref:ABC-1", "ean:5901234123457", a product URL from the shop, a bare ID (1–7 digits), an EAN (8/12/13 digits) or a reference. Max 300 characters. |
| changes | array of object | when: action=update | action=update: one item per combination. 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. combination_id (integer, required): Combination ID from action=list. price_impact_gross (number): Impact on the gross price (for example 10 = 10 more than the base price, -5 = cheaper). Range -1,000,000 to 1,000,000. price_impact_net (number): Impact on the net price (instead of gross). Range -1,000,000 to 1,000,000. wholesale_price (number): Net purchase price of the combination (0 = the product's purchase price). Range 0 to 10,000,000. reference (string): Combination reference (code). Max 64 characters. ean13 (string): EAN-13 (empty = remove). upc (string): UPC. mpn (string): Manufacturer part number (MPN). Max 40 characters. weight_impact (number): Impact on weight (kg). Range -10,000 to 10,000. minimal_quantity (integer): Minimum quantity per order. Range 1 to 100,000. default (boolean): true = the product's default combination. |
| 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
update: up to 100 combinations per call. Doesn't create or delete combinations (back office). Revertible with ps_revert_change.
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
- Update stock ps_update_stock
- Manage sale prices (specific prices) ps_manage_specific_prices
- Update prices ps_update_prices
- Revert change ps_revert_change
Use cases with this tool
Last updated: 2026-10-05