Documentation / Transfer rules with JSON or product CSV

HS Min/Max Quantities · Development version 0.12.0

Transfer rules with JSON or product CSV

Use JSON for complete rule configurations. Product CSV covers only simple direct quantity fields.

Before transferring

Back up the target store and export its current rules. Rehearse the import on a test copy. Keep exported configurations private: rule and account identifiers can be included.

JSON workflow

  1. Open the rule-transfer tools from the rules screen and export the source configuration.
  2. On the destination, upload the JSON file and review the prepared import before confirming.
  3. Resolve product, category, tag and role references in the review. A source ID alone is not proof of an equivalent destination item.
  4. Confirm only after the mapped scope and values are correct. The current importer appends prepared rules; it is not a replacement of every existing rule and preserves global messages.
  5. Review overlaps with existing rules and test the resulting product/cart/checkout journey.

Current exports use envelope version 2 and rule schema 3. Version 1/schema 2 remains readable. Files with specific accounts are bound to the original site/accounts and unchanged WordPress salts. On another site, recreate the user selection; the importer rejects unsupported transfers instead of silently dropping restrictions.

Product CSV

WooCommerce’s product importer/exporter exposes six fields: action, enabled, minimum, maximum, multiple and starting quantity. Map all six for an explicit set. Enabled uses 1 or 0; quantities are positive whole numbers up to 999999 or empty where optional.

ActionMeaning
setSet the supported direct quantity fields. An eligible existing rule is updated; otherwise a direct rule is created.
keep or emptyLeave Min/Max settings unchanged.
use-jsonThe exported rule cannot safely fit these columns. Use JSON, or keep when importing only ordinary product data.

CSV does not preserve category/group/cart rules, amounts, audience filters, exclusions, replacement references or custom messages. Blank columns do not delete a rule. Read row errors: a product can be saved while its Min/Max update fails, because these are not one atomic transaction.


Back to all guides · Troubleshooting