{
  "type": "object",
  "properties": {
    "header_row": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "description": "The CSV's first row as a list of column names, exactly as\nwritten in the file, e.g. [\"Handle\", \"Title\", \"Variant Price\"]."
    },
    "mode": {
      "default": "new",
      "pattern": "^(new|update)$",
      "type": "string",
      "description": "\"new\" when creating products, where Shopify requires only Title;\n\"update\" when changing existing ones, where it also requires URL\nhandle. Default \"new\"."
    }
  },
  "required": [
    "header_row"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "The product title or a candidate handle, e.g. \"Men's Merino\nWool Socks\"."
    },
    "existing": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Handles already used in the store or the file, so a\ncollision can be reported and a suffixed alternative suggested.\nOptional."
    }
  },
  "required": [
    "title"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "options": {
      "additionalProperties": {
        "items": {
          "type": "string"
        },
        "type": "array"
      },
      "type": "object",
      "description": "Option names mapped to their values, e.g. {\"Size\": [\"S\",\n\"M\"], \"Colour\": [\"Black\"]}. Each list needs at least one value."
    },
    "max_variants": {
      "default": 2048,
      "minimum": 1,
      "type": "integer",
      "description": "Ceiling to check against. Default 2048, which is the\nlimit Shopify announced on 15 October 2025, up from 100. Override\nit if your plan differs."
    },
    "max_options": {
      "default": 3,
      "minimum": 1,
      "type": "integer",
      "description": "Ceiling on distinct option names. Default 3."
    },
    "list_rows": {
      "default": false,
      "type": "boolean",
      "description": "When true, also return every variant combination. Off by\ndefault because the list can be very large."
    }
  },
  "required": [
    "options"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "namespace": {
      "type": "string",
      "description": "The metafield namespace, e.g. \"custom\"."
    },
    "key": {
      "type": "string",
      "description": "The metafield key, e.g. \"care_instructions\"."
    },
    "value_type": {
      "default": "single_line_text_field",
      "type": "string",
      "description": "The intended metafield type, echoed back for your record,\ne.g. \"single_line_text_field\". Not validated against Shopify's\ntype list, which changes."
    }
  },
  "required": [
    "namespace",
    "key"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "prices": {
      "items": {
        "type": "number"
      },
      "type": "array",
      "description": "Current prices, at least one, each greater than 0."
    },
    "change_pct": {
      "default": 0,
      "type": "number",
      "description": "Percentage change applied first, e.g. 10 to raise by 10%\nor -5 to cut by 5%. Default 0."
    },
    "change_flat": {
      "default": 0,
      "type": "number",
      "description": "Flat amount applied after the percentage. Default 0."
    },
    "round_to": {
      "default": 0.01,
      "exclusiveMinimum": 0,
      "type": "number",
      "description": "Rounding increment applied last, e.g. 0.01 or 0.05.\nDefault 0.01."
    },
    "charm_ending": {
      "default": "",
      "type": "string",
      "description": "Force every price to end in these cents, e.g. \".99\" or\n\".95\". Applied after rounding. Empty by default."
    }
  },
  "required": [
    "prices"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "order_total": {
      "exclusiveMinimum": 0,
      "type": "number",
      "description": "Value of one order including anything the processor\ntakes a percentage of. Must be greater than 0."
    },
    "fee_pct": {
      "default": 2.9,
      "minimum": 0,
      "type": "number",
      "description": "Percentage fee per transaction. Default 2.9 — a common\npublished rate, not a promise about your account."
    },
    "fee_fixed": {
      "default": 0.3,
      "minimum": 0,
      "type": "number",
      "description": "Fixed fee per transaction. Default 0.30."
    },
    "refund_rate_pct": {
      "default": 0,
      "maximum": 100,
      "minimum": 0,
      "type": "number",
      "description": "Share of order value refunded, as a percentage.\nDefault 0."
    },
    "orders": {
      "default": 1,
      "minimum": 1,
      "type": "integer",
      "description": "How many orders to model. Default 1."
    }
  },
  "required": [
    "order_total"
  ],
  "additionalProperties": false
}