---
title: "Update variant-specific settings for a selling plan"
description: "Update per-variant preorder settings within a selling plan, such as the variant's custom shipping_text and preorder_max_count (the cap on preorder units). Identify the variant with shopify_variant_id; only the settings y"
url: https://docs.stoqapp.com/v1/preorders/update-variant-specific-settings-for-a-selling-plan/
api: "API v1 (legacy)"
method: PATCH
path: "/external/preorders/{id}/update_variant_settings"
---

# Update variant-specific settings for a selling plan

`PATCH https://app.stoqapp.com/api/v1/external/preorders/{id}/update_variant_settings`

Update per-variant preorder settings within a selling plan, such as the variant's custom `shipping_text` and `preorder_max_count` (the cap on preorder units). Identify the variant with `shopify_variant_id`; only the settings you include are changed. Returns the updated variant settings.

## Path parameters

- `id` (string, required): Selling plan ID

## Headers

- `X-Auth-Token` (string, required): API key for authentication

## Request body

- `shopify_variant_id` (integer, required): Shopify variant ID to update settings for
- `shipping_text` (string, nullable): Custom shipping text for this variant. Send null or an empty string to clear the override.
- `preorder_max_count` (integer, nullable): Maximum number of preorders allowed for this variant. Send null or an empty string to clear the override.

## Returns

- `success` (boolean): e.g. `true`
- `message` (string): e.g. `Variant settings updated`
- `variant` (object)
  - `shopify_variant_id` (integer): e.g. `43900910010503`
  - `shipping_text` (string): e.g. `Ships July 2026`
  - `preorder_max_count` (integer): e.g. `100`

Rate limit: this call costs 2 points ([rate limits](https://docs.stoqapp.com/docs/rate-limits/)).

## Example request

```sh
curl -X PATCH "https://app.stoqapp.com/api/v1/external/preorders/79b44c6c-ebc7-41d4-8a1b-573d7c693454/update_variant_settings" \
  -H "X-Auth-Token: $STOQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "shopify_variant_id": 43900910010503,
    "shipping_text": "Ships July 2026",
    "preorder_max_count": 100
  }'
```

## 200

Variant settings updated successfully

```json
{
  "success": true,
  "message": "Variant settings updated",
  "variant": {
    "shopify_variant_id": 43900910010503,
    "shipping_text": "Ships July 2026",
    "preorder_max_count": 100
  }
}
```

## 400

Bad request - missing required parameters or no settings to update

## 401

Unauthorized

## 404

Selling plan or variant not found

## 422

Failed to update variant settings